This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-dbutils.git
The following commit(s) were added to refs/heads/master by this push:
new 0ad9810 Javadoc: Empty Javadoc line before the 1st tag.
0ad9810 is described below
commit 0ad98103b673649ee116b7681fd7a80fa07e1b18
Author: Gary Gregory <[email protected]>
AuthorDate: Wed Dec 31 18:16:51 2025 -0500
Javadoc: Empty Javadoc line before the 1st tag.
---
.../org/apache/commons/dbutils/AbstractQueryRunner.java | 1 +
.../java/org/apache/commons/dbutils/AsyncQueryRunner.java | 5 +++++
.../org/apache/commons/dbutils/BasicRowProcessor.java | 3 +++
.../java/org/apache/commons/dbutils/BeanProcessor.java | 6 ++++++
src/main/java/org/apache/commons/dbutils/DbUtils.java | 1 +
.../java/org/apache/commons/dbutils/OutParameter.java | 8 ++++++++
.../java/org/apache/commons/dbutils/ProxyFactory.java | 7 +++++++
src/main/java/org/apache/commons/dbutils/QueryLoader.java | 2 ++
src/main/java/org/apache/commons/dbutils/QueryRunner.java | 15 +++++++++++++++
.../org/apache/commons/dbutils/ResultSetIterator.java | 6 ++++++
.../java/org/apache/commons/dbutils/RowProcessor.java | 2 ++
.../commons/dbutils/handlers/AbstractKeyedHandler.java | 3 +++
.../org/apache/commons/dbutils/handlers/ArrayHandler.java | 1 +
.../apache/commons/dbutils/handlers/ArrayListHandler.java | 1 +
.../org/apache/commons/dbutils/handlers/BeanHandler.java | 2 +-
.../apache/commons/dbutils/handlers/BeanMapHandler.java | 1 +
.../commons/dbutils/handlers/ColumnListHandler.java | 1 +
.../org/apache/commons/dbutils/handlers/KeyedHandler.java | 2 ++
.../org/apache/commons/dbutils/handlers/MapHandler.java | 2 +-
.../apache/commons/dbutils/handlers/MapListHandler.java | 1 +
.../apache/commons/dbutils/handlers/ScalarHandler.java | 1 +
.../commons/dbutils/wrappers/SqlNullCheckedResultSet.java | 2 ++
.../commons/dbutils/wrappers/StringTrimmedResultSet.java | 1 +
23 files changed, 72 insertions(+), 2 deletions(-)
diff --git a/src/main/java/org/apache/commons/dbutils/AbstractQueryRunner.java
b/src/main/java/org/apache/commons/dbutils/AbstractQueryRunner.java
index 6886910..b69f5cf 100644
--- a/src/main/java/org/apache/commons/dbutils/AbstractQueryRunner.java
+++ b/src/main/java/org/apache/commons/dbutils/AbstractQueryRunner.java
@@ -48,6 +48,7 @@ public abstract class AbstractQueryRunner {
/**
* The DataSource to retrieve connections from.
+ *
* @deprecated Access to this field should be through {@link
#getDataSource()}.
*/
@Deprecated
diff --git a/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
b/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
index a5db139..4083256 100644
--- a/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
+++ b/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
@@ -92,6 +92,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
}
/**
* Class that encapsulates the continuation for query calls.
+ *
* @param <T> The type of the result from the call to handle.
*/
protected class QueryCallableStatement<T> implements Callable<T> {
@@ -421,6 +422,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query without any replacement parameters. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -435,6 +437,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query with replacement parameters. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -452,6 +455,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL without any replacement parameters.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -468,6 +472,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL query and returns a result object.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
diff --git a/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
b/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
index 60393b3..2dc89d7 100644
--- a/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
@@ -176,6 +176,7 @@ public class BasicRowProcessor implements RowProcessor {
/**
* BasicRowProcessor constructor.
+ *
* @param convert The BeanProcessor to use when converting columns to
* bean properties.
* @since 1.1
@@ -211,6 +212,7 @@ public class BasicRowProcessor implements RowProcessor {
/**
* Convert a {@code ResultSet} row into a JavaBean. This
* implementation delegates to a BeanProcessor instance.
+ *
* @see org.apache.commons.dbutils.RowProcessor#toBean(java.sql.ResultSet,
Class)
* @see
org.apache.commons.dbutils.BeanProcessor#toBean(java.sql.ResultSet, Class)
* @param <T> The type of bean to create
@@ -227,6 +229,7 @@ public class BasicRowProcessor implements RowProcessor {
/**
* Convert a {@code ResultSet} into a {@code List} of JavaBeans.
* This implementation delegates to a BeanProcessor instance.
+ *
* @see
org.apache.commons.dbutils.RowProcessor#toBeanList(java.sql.ResultSet, Class)
* @see
org.apache.commons.dbutils.BeanProcessor#toBeanList(java.sql.ResultSet, Class)
* @param <T> The type of bean to create
diff --git a/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
b/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
index cb98092..46490ee 100644
--- a/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
@@ -113,6 +113,7 @@ public class BeanProcessor {
/**
* Calls the setter method on the target object for the given property.
* If no setter method exists for the property, this method does nothing.
+ *
* @param target The object to set the property on.
* @param prop The property to set.
* @param value The value to pass into the setter.
@@ -151,6 +152,7 @@ public class BeanProcessor {
/**
* Creates a new object and initializes its fields from the ResultSet.
+ *
* @param <T> The type of bean to create
* @param resultSet The result set.
* @param type The bean type (the return type of the object).
@@ -294,6 +296,7 @@ public class BeanProcessor {
* is called at the start of the bean creation process and may be
* overridden to provide custom behavior like returning a cached bean
* instance.
+ *
* @param <T> The type of object to create
* @param c The Class to create an object from.
* @return A newly created object of the Class.
@@ -311,6 +314,7 @@ public class BeanProcessor {
/**
* Initializes the fields of the provided bean from the ResultSet.
+ *
* @param <T> The type of bean
* @param resultSet The result set.
* @param bean The bean to be populated.
@@ -452,6 +456,7 @@ public class BeanProcessor {
* {@code null} when SQL NULL is returned. This is the same behavior
* as the {@code ResultSet} get* methods.
* </p>
+ *
* @param <T> The type of bean to create
* @param rs ResultSet that supplies the bean data
* @param type Class from which to create the bean instance
@@ -490,6 +495,7 @@ public class BeanProcessor {
* {@code null} when SQL NULL is returned. This is the same behavior
* as the {@code ResultSet} get* methods.
* </p>
+ *
* @param <T> The type of bean to create
* @param resultSet ResultSet that supplies the bean data
* @param type Class from which to create the bean instance
diff --git a/src/main/java/org/apache/commons/dbutils/DbUtils.java
b/src/main/java/org/apache/commons/dbutils/DbUtils.java
index e4407e2..8abc37e 100644
--- a/src/main/java/org/apache/commons/dbutils/DbUtils.java
+++ b/src/main/java/org/apache/commons/dbutils/DbUtils.java
@@ -356,6 +356,7 @@ public final class DbUtils {
/**
* Rollback any changes made on the given connection.
+ *
* @param conn Connection to rollback. A null value is legal.
* @throws SQLException if a database access error occurs
*/
diff --git a/src/main/java/org/apache/commons/dbutils/OutParameter.java
b/src/main/java/org/apache/commons/dbutils/OutParameter.java
index 62d8b52..4ed797c 100644
--- a/src/main/java/org/apache/commons/dbutils/OutParameter.java
+++ b/src/main/java/org/apache/commons/dbutils/OutParameter.java
@@ -41,6 +41,7 @@ public class OutParameter<T> {
/**
* Constructs an {@code OutParameter} for the given JDBC SQL type and
* Java type.
+ *
* @param sqlType the JDBC SQL type of the parameter as in
* {@link java.sql.Types}.
* @param javaType the Java class of the parameter value, cast compatible
@@ -56,6 +57,7 @@ public class OutParameter<T> {
* Constructs an {@code OutParameter} for the given JDBC SQL type and
* Java type and with the given value. The parameter will be treated as an
* INOUT parameter if the value is null.
+ *
* @param sqlType the JDBC SQL type of the parameter as in
* {@link java.sql.Types}.
* @param javaType the Java class of the parameter value, cast compatible
@@ -71,6 +73,7 @@ public class OutParameter<T> {
/**
* Gets the Java class for this OUT parameter.
+ *
* @return the Java class for this OUT parameter.
*/
public Class<T> getJavaType() {
@@ -79,6 +82,7 @@ public class OutParameter<T> {
/**
* Gets the JDBC SQL type for this OUT parameter.
+ *
* @return the JDBC SQL type for this OUT parameter.
*/
public int getSqlType() {
@@ -88,6 +92,7 @@ public class OutParameter<T> {
/**
* Gets the value of the OUT parameter. After the stored procedure has
* been executed, the value is the value returned via this parameter.
+ *
* @return the value of the OUT parameter.
*/
public T getValue() {
@@ -99,6 +104,7 @@ public class OutParameter<T> {
* index using the {@code sqlType} and {@code value} of this
* {@code OutParameter}. If the value is not null, the parameter is
* treated like an INOUT parameter and the value is set on the statement.
+ *
* @param stmt the statement the parameter should register on.
* @param index the (1-based) index of the parameter.
* @throws SQLException if the parameter could not be registered, or if the
@@ -114,6 +120,7 @@ public class OutParameter<T> {
/**
* Set the value using the return value of the parameter an the given index
* from the given {@code CallableStatement}.
+ *
* @param stmt the already executed statement
* @param index the (1-based) index of the parameter
* @throws SQLException when the value could not be retrieved from the
@@ -127,6 +134,7 @@ public class OutParameter<T> {
* Set the value of the OUT parameter. If the value is not null when the
* stored procedure is executed, then the parameter will be treated like an
* INOUT parameter.
+ *
* @param value the new value for the parameter.
*/
public void setValue(final T value) {
diff --git a/src/main/java/org/apache/commons/dbutils/ProxyFactory.java
b/src/main/java/org/apache/commons/dbutils/ProxyFactory.java
index 0732949..801d1f8 100644
--- a/src/main/java/org/apache/commons/dbutils/ProxyFactory.java
+++ b/src/main/java/org/apache/commons/dbutils/ProxyFactory.java
@@ -58,6 +58,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code CallableStatement} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied CallableStatement
*/
@@ -67,6 +68,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code Connection} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied Connection
*/
@@ -76,6 +78,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code Driver} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied Driver
*/
@@ -85,6 +88,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code PreparedStatement} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied PreparedStatement
*/
@@ -94,6 +98,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code ResultSet} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied ResultSet
*/
@@ -103,6 +108,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code ResultSetMetaData} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied ResultSetMetaData
*/
@@ -112,6 +118,7 @@ public class ProxyFactory {
/**
* Creates a new proxy {@code Statement} object.
+ *
* @param handler The handler that intercepts/overrides method calls.
* @return proxied Statement
*/
diff --git a/src/main/java/org/apache/commons/dbutils/QueryLoader.java
b/src/main/java/org/apache/commons/dbutils/QueryLoader.java
index 6e9cc96..31bbecb 100644
--- a/src/main/java/org/apache/commons/dbutils/QueryLoader.java
+++ b/src/main/java/org/apache/commons/dbutils/QueryLoader.java
@@ -43,6 +43,7 @@ public class QueryLoader {
/**
* Return an INSTANCE of this class.
+ *
* @return The Singleton INSTANCE.
*/
public static QueryLoader instance() {
@@ -132,6 +133,7 @@ public class QueryLoader {
/**
* Removes the queries for the given path from the cache.
+ *
* @param path The path that the queries were loaded from.
*/
public synchronized void unload(final String path) {
diff --git a/src/main/java/org/apache/commons/dbutils/QueryRunner.java
b/src/main/java/org/apache/commons/dbutils/QueryRunner.java
index 3658684..2033c05 100644
--- a/src/main/java/org/apache/commons/dbutils/QueryRunner.java
+++ b/src/main/java/org/apache/commons/dbutils/QueryRunner.java
@@ -354,6 +354,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL INSERT query without replacement parameters.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to use to run the query.
* @param sql The SQL to execute.
@@ -369,6 +370,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL INSERT query.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to use to run the query.
* @param sql The SQL to execute.
@@ -421,6 +423,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Executes the given INSERT SQL without any replacement parameters.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -440,6 +443,7 @@ public class QueryRunner extends AbstractQueryRunner {
* {@code Connection} is retrieved from the {@code DataSource}
* set in the constructor. This {@code Connection} must be in
* auto-commit mode or the insert will not be saved.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -457,6 +461,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Executes the given batch of INSERT SQL statements.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to use to run the query.
* @param sql The SQL to execute.
@@ -507,6 +512,7 @@ public class QueryRunner extends AbstractQueryRunner {
* {@code Connection} is retrieved from the {@code DataSource}
* set in the constructor. This {@code Connection} must be in
* auto-commit mode or the insert will not be saved.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -525,6 +531,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query with a single replacement parameter. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -542,6 +549,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query with replacement parameters. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -559,6 +567,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query without any replacement parameters. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -573,6 +582,7 @@ public class QueryRunner extends AbstractQueryRunner {
/**
* Execute an SQL SELECT query with replacement parameters. The
* caller is responsible for closing the connection.
+ *
* @param <T> The type of object that the handler returns
* @param conn The connection to execute the query in.
* @param sql The query to execute.
@@ -625,6 +635,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL with a single replacement parameter.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param param The replacement parameter.
@@ -646,6 +657,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL query and returns a result object.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param params Initialize the PreparedStatement's IN parameters with
@@ -669,6 +681,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL without any replacement parameters.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -687,6 +700,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Executes the given SELECT SQL query and returns a result object.
* The {@code Connection} is retrieved from the
* {@code DataSource} set in the constructor.
+ *
* @param <T> The type of object that the handler returns
* @param sql The SQL statement to execute.
* @param rsh The handler used to create the result object from
@@ -706,6 +720,7 @@ public class QueryRunner extends AbstractQueryRunner {
* Set the value on all the {@link OutParameter} instances in the
* {@code params} array using the OUT parameter values from the
* {@code stmt}.
+ *
* @param stmt the statement from which to retrieve OUT parameter values
* @param params the parameter array for the statement invocation
* @throws SQLException when the value could not be retrieved from the
diff --git a/src/main/java/org/apache/commons/dbutils/ResultSetIterator.java
b/src/main/java/org/apache/commons/dbutils/ResultSetIterator.java
index 7fdc296..4127fa7 100644
--- a/src/main/java/org/apache/commons/dbutils/ResultSetIterator.java
+++ b/src/main/java/org/apache/commons/dbutils/ResultSetIterator.java
@@ -56,6 +56,7 @@ public class ResultSetIterator implements Iterator<Object[]> {
/**
* Constructor for ResultSetIterator.
+ *
* @param resultSet Wrap this {@code ResultSet} in an {@code Iterator}.
*/
public ResultSetIterator(final ResultSet resultSet) {
@@ -64,6 +65,7 @@ public class ResultSetIterator implements Iterator<Object[]> {
/**
* Constructor for ResultSetIterator.
+ *
* @param resultSet Wrap this {@code ResultSet} in an {@code Iterator}.
* @param convert The processor to use when converting a row into an
* {@code Object[]}. Defaults to a
@@ -76,6 +78,7 @@ public class ResultSetIterator implements Iterator<Object[]> {
/**
* Returns true if there are more rows in the ResultSet.
+ *
* @return boolean {@code true} if there are more rows
* @throws RuntimeException if an SQLException occurs.
*/
@@ -91,6 +94,7 @@ public class ResultSetIterator implements Iterator<Object[]> {
/**
* Returns the next row as an {@code Object[]}.
+ *
* @return An {@code Object[]} with the same number of elements as
* columns in the {@code ResultSet}.
* @see java.util.Iterator#next()
@@ -108,6 +112,7 @@ public class ResultSetIterator implements
Iterator<Object[]> {
/**
* Deletes the current row from the {@code ResultSet}.
+ *
* @see java.util.Iterator#remove()
* @throws RuntimeException if an SQLException occurs.
*/
@@ -123,6 +128,7 @@ public class ResultSetIterator implements
Iterator<Object[]> {
/**
* Rethrows the SQLException as a RuntimeException. This implementation
* creates a new RuntimeException with the SQLException's error message.
+ *
* @param e SQLException to rethrow
* @since 1.1
*/
diff --git a/src/main/java/org/apache/commons/dbutils/RowProcessor.java
b/src/main/java/org/apache/commons/dbutils/RowProcessor.java
index f71f78d..c8b65bc 100644
--- a/src/main/java/org/apache/commons/dbutils/RowProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/RowProcessor.java
@@ -49,6 +49,7 @@ public interface RowProcessor {
* row. The {@code ResultSet} should be positioned on a valid row before
* passing it to this method. Implementations of this method must not
* alter the row position of the {@code ResultSet}.
+ *
* @param <T> The type of bean to create
* @param resultSet ResultSet that supplies the bean data
* @param type Class from which to create the bean instance
@@ -61,6 +62,7 @@ public interface RowProcessor {
* Create a {@code List} of JavaBeans from the column values in all
* {@code ResultSet} rows. {@code ResultSet.next()} should
* <strong>not</strong> be called before passing it to this method.
+ *
* @param <T> The type of bean to create
* @param resultSet ResultSet that supplies the bean data
* @param type Class from which to create the bean instance
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
index 91086f2..942d5ed 100644
---
a/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
+++
b/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
@@ -47,6 +47,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
/**
* This factory method is called by {@code handle()} to retrieve the
* key value from the current {@code ResultSet} row.
+ *
* @param resultSet ResultSet to create a key from
* @return K from the configured key column name/index
* @throws SQLException if a database access error occurs
@@ -67,6 +68,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
/**
* This factory method is called by {@code handle()} to store the
* current {@code ResultSet} row in some object.
+ *
* @param resultSet ResultSet to create a row from
* @return V object created from the current row
* @throws SQLException if a database access error occurs
@@ -76,6 +78,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
/**
* Convert each row's columns into a Map and store then
* in a {@code Map} under {@code ResultSet.getObject(key)} key.
+ *
* @param resultSet {@code ResultSet} to process.
* @return A {@code Map}, never {@code null}.
* @throws SQLException if a database access error occurs
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
index 5590364..6cbf6c3 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
@@ -70,6 +70,7 @@ public class ArrayHandler implements
ResultSetHandler<Object[]> {
/**
* Places the column values from the first row in an {@code Object[]}.
+ *
* @param resultSet {@code ResultSet} to process.
* @return An Object[]. If there are no rows in the {@code ResultSet}
* an empty array will be returned.
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
index 8606415..d34911f 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
@@ -56,6 +56,7 @@ public class ArrayListHandler extends
AbstractListHandler<Object[]> {
/**
* Convert row's columns into an {@code Object[]}.
+ *
* @param resultSet {@code ResultSet} to process.
* @return {@code Object[]}, never {@code null}.
* @throws SQLException if a database access error occurs
diff --git a/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
index 4174ac3..fe699c2 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
@@ -68,10 +68,10 @@ public class BeanHandler<T> implements ResultSetHandler<T> {
/**
* Convert the first row of the {@code ResultSet} into a bean with the
* {@code Class} given in the constructor.
+ *
* @param resultSet {@code ResultSet} to process.
* @return An initialized JavaBean or {@code null} if there were no
* rows in the {@code ResultSet}.
- *
* @throws SQLException if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
index 1a09ab2..c43622d 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
@@ -157,6 +157,7 @@ public class BeanMapHandler<K, V> extends
AbstractKeyedHandler<K, V> {
/**
* This factory method is called by {@code handle()} to retrieve the
* key value from the current {@code ResultSet} row.
+ *
* @param resultSet ResultSet to create a key from
* @return K from the configured key column name/index
* @throws SQLException if a database access error occurs
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
index a034618..596fb7c 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
@@ -82,6 +82,7 @@ public class ColumnListHandler<T> extends
AbstractListHandler<T> {
/**
* Returns one {@code ResultSet} column value as {@code Object}.
+ *
* @param resultSet {@code ResultSet} to process.
* @return {@code Object}, never {@code null}.
* @throws SQLException if a database access error occurs
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
index 31797a9..edc9842 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
@@ -126,6 +126,7 @@ public class KeyedHandler<K> extends
AbstractKeyedHandler<K, Map<String, Object>
* key value from the current {@code ResultSet} row. This
* implementation returns {@code ResultSet.getObject()} for the
* configured key column name or index.
+ *
* @param rs ResultSet to create a key from
* @return Object from the configured key column name/index
* @throws SQLException if a database access error occurs
@@ -147,6 +148,7 @@ public class KeyedHandler<K> extends
AbstractKeyedHandler<K, Map<String, Object>
* implementation returns a {@code Map} with case insensitive column
* names as keys. Calls to {@code map.get("COL")} and
* {@code map.get("col")} return the same value.
+ *
* @param resultSet ResultSet to create a row from
* @return Object typed Map containing column names to values
* @throws SQLException if a database access error occurs
diff --git a/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
index c3c0324..2ff622d 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
@@ -59,10 +59,10 @@ public class MapHandler implements
ResultSetHandler<Map<String, Object>> {
/**
* Converts the first row in the {@code ResultSet} into a
* {@code Map}.
+ *
* @param resultSet {@code ResultSet} to process.
* @return A {@code Map} with the values from the first row or
* {@code null} if there are no rows in the {@code ResultSet}.
- *
* @throws SQLException if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
index 2781f6b..8855e96 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
@@ -57,6 +57,7 @@ public class MapListHandler extends
AbstractListHandler<Map<String, Object>> {
/**
* Converts the {@code ResultSet} row into a {@code Map} object.
+ *
* @param resultSet {@code ResultSet} to process.
* @return A {@code Map}, never null.
* @throws SQLException if a database access error occurs
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
index 32605e3..440b8e5 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
@@ -84,6 +84,7 @@ public class ScalarHandler<T> implements ResultSetHandler<T> {
* Returns one {@code ResultSet} column as an object via the
* {@code ResultSet.getObject()} method that performs type
* conversions.
+ *
* @param resultSet {@code ResultSet} to process.
* @return The column or {@code null} if there are no rows in
* the {@code ResultSet}.
diff --git
a/src/main/java/org/apache/commons/dbutils/wrappers/SqlNullCheckedResultSet.java
b/src/main/java/org/apache/commons/dbutils/wrappers/SqlNullCheckedResultSet.java
index 1d6be31..ca943d9 100644
---
a/src/main/java/org/apache/commons/dbutils/wrappers/SqlNullCheckedResultSet.java
+++
b/src/main/java/org/apache/commons/dbutils/wrappers/SqlNullCheckedResultSet.java
@@ -78,6 +78,7 @@ public class SqlNullCheckedResultSet implements
InvocationHandler {
/**
* The {@code getNull} string prefix.
+ *
* @since 1.4
*/
private static final String GET_NULL_PREFIX = "getNull";
@@ -144,6 +145,7 @@ public class SqlNullCheckedResultSet implements
InvocationHandler {
* Constructs a new instance of
* {@code SqlNullCheckedResultSet}
* to wrap the specified {@code ResultSet}.
+ *
* @param resultSet ResultSet to wrap
*/
public SqlNullCheckedResultSet(final ResultSet resultSet) {
diff --git
a/src/main/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSet.java
b/src/main/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSet.java
index 08cbb23..47d8e4c 100644
---
a/src/main/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSet.java
+++
b/src/main/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSet.java
@@ -67,6 +67,7 @@ public class StringTrimmedResultSet implements
InvocationHandler {
/**
* Constructs a new instance of {@code StringTrimmedResultSet}
* to wrap the specified {@code ResultSet}.
+ *
* @param resultSet ResultSet to wrap
*/
public StringTrimmedResultSet(final ResultSet resultSet) {
