This is an automated email from the ASF dual-hosted git repository.
garydgregory 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 d5cc700 Javadoc
d5cc700 is described below
commit d5cc70015943ea9d5154cfb9acfc2d40e0af5008
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:36:28 2026 -0400
Javadoc
---
.../apache/commons/dbutils/AsyncQueryRunner.java | 42 ++++++++---------
.../commons/dbutils/BaseResultSetHandler.java | 2 +-
.../apache/commons/dbutils/BasicRowProcessor.java | 8 ++--
.../org/apache/commons/dbutils/BeanProcessor.java | 20 ++++-----
.../org/apache/commons/dbutils/ColumnHandler.java | 2 +-
.../java/org/apache/commons/dbutils/DbUtils.java | 12 ++---
.../org/apache/commons/dbutils/OutParameter.java | 2 +-
.../org/apache/commons/dbutils/QueryLoader.java | 4 +-
.../org/apache/commons/dbutils/QueryRunner.java | 52 +++++++++++-----------
.../apache/commons/dbutils/ResultSetHandler.java | 2 +-
.../org/apache/commons/dbutils/RowProcessor.java | 8 ++--
.../dbutils/handlers/AbstractKeyedHandler.java | 6 +--
.../commons/dbutils/handlers/ArrayHandler.java | 2 +-
.../commons/dbutils/handlers/ArrayListHandler.java | 2 +-
.../commons/dbutils/handlers/BeanHandler.java | 2 +-
.../commons/dbutils/handlers/BeanListHandler.java | 2 +-
.../commons/dbutils/handlers/BeanMapHandler.java | 2 +-
.../dbutils/handlers/ColumnListHandler.java | 2 +-
.../commons/dbutils/handlers/KeyedHandler.java | 4 +-
.../commons/dbutils/handlers/MapHandler.java | 2 +-
.../commons/dbutils/handlers/MapListHandler.java | 2 +-
.../commons/dbutils/handlers/ScalarHandler.java | 2 +-
.../org/apache/commons/dbutils/MockResultSet.java | 22 ++++-----
.../wrappers/StringTrimmedResultSetTest.java | 2 +-
24 files changed, 103 insertions(+), 103 deletions(-)
diff --git a/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
b/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
index 3032693..085ad5e 100644
--- a/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
+++ b/src/main/java/org/apache/commons/dbutils/AsyncQueryRunner.java
@@ -69,7 +69,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* The actual call to executeBatch.
*
* @return An array of update counts containing one element for each
command in the batch.
- * @throws SQLException if a database access error occurs or one of
the commands sent to the database fails.
+ * @throws SQLException Thrown if a database access error occurs or
one of the commands sent to the database fails.
* @see PreparedStatement#executeBatch()
*/
@Override
@@ -129,7 +129,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* The actual call to {@code handle()} method.
*
* @return An array of update counts containing one element for each
command in the batch.
- * @throws SQLException if a database access error occurs.
+ * @throws SQLException Thrown if a database access error occurs.
* @see ResultSetHandler#handle(ResultSet)
*/
@Override
@@ -194,7 +194,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
*
* @return either (1) the row count for SQL Data Manipulation Language
(DML) statements or
* (2) 0 for SQL statements that return nothing
- * @throws SQLException if a database access error occurs.
+ * @throws SQLException Thrown if a database access error occurs.
* @see PreparedStatement#executeUpdate()
*/
@Override
@@ -299,7 +299,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param params An array of query replacement parameters. Each row in
* this array is one set of batch replacement values.
* @return A {@code Future} which returns the number of rows updated per
statement.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public Future<int[]> batch(final Connection conn, final String sql, final
Object[][] params) throws SQLException {
return executorService.submit(() -> queryRunner.batch(conn, sql,
params));
@@ -315,7 +315,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param params An array of query replacement parameters. Each row in
* this array is one set of batch replacement values.
* @return A {@code Future} which returns the number of rows updated per
statement.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public Future<int[]> batch(final String sql, final Object[][] params)
throws SQLException {
return executorService.submit(() -> queryRunner.batch(sql, params));
@@ -330,7 +330,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param rsh {@link ResultSetHandler} for handling the results
* @return {@link Future} that executes a query runner insert
* @see QueryRunner#insert(Connection, String, ResultSetHandler)
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insert(final Connection conn, final String sql, final
ResultSetHandler<T> rsh) throws SQLException {
@@ -347,7 +347,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param params Parameter values for substitution in the SQL statement
* @return {@link Future} that executes a query runner insert
* @see QueryRunner#insert(Connection, String, ResultSetHandler, Object...)
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insert(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object... params) throws SQLException {
@@ -362,7 +362,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param rsh {@link ResultSetHandler} for handling the results
* @return {@link Future} that executes a query runner insert
* @see QueryRunner#insert(String, ResultSetHandler)
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insert(final String sql, final ResultSetHandler<T>
rsh) throws SQLException {
@@ -378,7 +378,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param params Parameter values for substitution in the SQL statement
* @return {@link Future} that executes a query runner insert
* @see QueryRunner#insert(String, ResultSetHandler, Object...)
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insert(final String sql, final ResultSetHandler<T>
rsh, final Object... params) throws SQLException {
@@ -396,7 +396,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* this array is one set of batch replacement values.
* @return {@link Future} that executes a query runner batch insert
* @see QueryRunner#insertBatch(Connection, String, ResultSetHandler,
Object[][])
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insertBatch(final Connection conn, final String sql,
final ResultSetHandler<T> rsh, final Object[][] params) throws SQLException {
@@ -413,7 +413,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* this array is one set of batch replacement values.
* @return {@link Future} that executes a query runner batch insert
* @see QueryRunner#insertBatch(String, ResultSetHandler, Object[][])
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> Future<T> insertBatch(final String sql, final
ResultSetHandler<T> rsh, final Object[][] params) throws SQLException {
@@ -429,7 +429,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param sql The query to execute.
* @param rsh The handler that converts the results into an object.
* @return A {@code Future} which returns the result of the query call.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> Future<T> query(final Connection conn, final String sql, final
ResultSetHandler<T> rsh) throws SQLException {
return executorService.submit(() -> queryRunner.query(conn, sql, rsh));
@@ -445,7 +445,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param rsh The handler that converts the results into an object.
* @param params The replacement parameters.
* @return A {@code Future} which returns the result of the query call.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> Future<T> query(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object... params)
throws SQLException {
@@ -463,7 +463,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* the {@code ResultSet}.
*
* @return A {@code Future} which returns the result of the query call.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> Future<T> query(final String sql, final ResultSetHandler<T>
rsh) throws SQLException {
return executorService.submit(() -> queryRunner.query(sql, rsh));
@@ -481,7 +481,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param params Initialize the PreparedStatement's IN parameters with
* this array.
* @return A {@code Future} which returns the result of the query call.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> Future<T> query(final String sql, final ResultSetHandler<T>
rsh, final Object... params) throws SQLException {
return executorService.submit(() -> queryRunner.query(sql, rsh,
params));
@@ -494,7 +494,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param conn The connection to use to run the query.
* @param sql The SQL to execute.
* @return A {@code Future} which returns the number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public Future<Integer> update(final Connection conn, final String sql)
throws SQLException {
return executorService.submit(() ->
Integer.valueOf(queryRunner.update(conn, sql)));
@@ -508,7 +508,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param sql The SQL to execute.
* @param param The replacement parameter.
* @return A {@code Future} which returns the number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public Future<Integer> update(final Connection conn, final String sql,
final Object param) throws SQLException {
return executorService.submit(() ->
Integer.valueOf(queryRunner.update(conn, sql, param)));
@@ -521,7 +521,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param sql The SQL to execute.
* @param params The query replacement parameters.
* @return A {@code Future} which returns the number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public Future<Integer> update(final Connection conn, final String sql,
final Object... params) throws SQLException {
return executorService.submit(() ->
Integer.valueOf(queryRunner.update(conn, sql, params)));
@@ -535,7 +535,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* not be saved.
*
* @param sql The SQL statement to execute.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return A {@code Future} which returns the number of rows updated.
*/
public Future<Integer> update(final String sql) throws SQLException {
@@ -551,7 +551,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
*
* @param sql The SQL statement to execute.
* @param param The replacement parameter.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return A {@code Future} which returns the number of rows updated.
*/
public Future<Integer> update(final String sql, final Object param) throws
SQLException {
@@ -567,7 +567,7 @@ public class AsyncQueryRunner extends AbstractQueryRunner {
* @param sql The SQL statement to execute.
* @param params Initializes the PreparedStatement's IN (i.e. '?')
* parameters.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return A {@code Future} which returns the number of rows updated.
*/
public Future<Integer> update(final String sql, final Object... params)
throws SQLException {
diff --git a/src/main/java/org/apache/commons/dbutils/BaseResultSetHandler.java
b/src/main/java/org/apache/commons/dbutils/BaseResultSetHandler.java
index 9615540..a5591e7 100644
--- a/src/main/java/org/apache/commons/dbutils/BaseResultSetHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/BaseResultSetHandler.java
@@ -519,7 +519,7 @@ public abstract class BaseResultSetHandler<T> implements
ResultSetHandler<T>, Re
* Turn the {@code ResultSet} into an Object.
*
* @return An Object initialized with {@code ResultSet} data
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see ResultSetHandler#handle(ResultSet)
*/
protected abstract T handle() throws SQLException;
diff --git a/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
b/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
index 147581b..7620a38 100644
--- a/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/BasicRowProcessor.java
@@ -193,7 +193,7 @@ public class BasicRowProcessor implements RowProcessor {
*
* @see org.apache.commons.dbutils.RowProcessor#toArray(java.sql.ResultSet)
* @param resultSet ResultSet that supplies the array data
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created array
*/
@Override
@@ -218,7 +218,7 @@ public class BasicRowProcessor implements RowProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created bean
*/
@Override
@@ -235,7 +235,7 @@ public class BasicRowProcessor implements RowProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return A {@code List} of beans with the given type in the order
* they were returned by the {@code ResultSet}.
*/
@@ -256,7 +256,7 @@ public class BasicRowProcessor implements RowProcessor {
*
* @param resultSet ResultSet that supplies the map data
* @return The newly created Map
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see org.apache.commons.dbutils.RowProcessor#toMap(java.sql.ResultSet)
*/
@Override
diff --git a/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
b/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
index 66f42f2..1edc92f 100644
--- a/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/BeanProcessor.java
@@ -117,7 +117,7 @@ public class BeanProcessor {
* @param target The object to set the property on.
* @param prop The property to set.
* @param value The value to pass into the setter.
- * @throws SQLException if an error occurs setting the property.
+ * @throws SQLException Thrown if an error occurs setting the property.
*/
private void callSetter(final Object target, final PropertyDescriptor
prop, Object value)
throws SQLException {
@@ -159,7 +159,7 @@ public class BeanProcessor {
* @param props The property descriptors.
* @param columnToProperty The column indices in the result set.
* @return An initialized object.
- * @throws SQLException if a database error occurs.
+ * @throws SQLException Thrown if a database error occurs.
*/
private <T> T createBean(final ResultSet resultSet, final Class<T> type,
final PropertyDescriptor[] props, final int[] columnToProperty)
throws SQLException {
@@ -212,7 +212,7 @@ public class BeanProcessor {
* information.
*
* @param props The bean property descriptors.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return An int[] with column index to property index mappings. The 0th
* element is meaningless because JDBC column indexing starts at 1.
*/
@@ -300,7 +300,7 @@ public class BeanProcessor {
* @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.
- * @throws SQLException if creation failed.
+ * @throws SQLException Thrown if creation failed.
*/
protected <T> T newInstance(final Class<T> c) throws SQLException {
try {
@@ -319,7 +319,7 @@ public class BeanProcessor {
* @param resultSet The result set.
* @param bean The bean to be populated.
* @return An initialized object.
- * @throws SQLException if a database error occurs.
+ * @throws SQLException Thrown if a database error occurs.
*/
public <T> T populateBean(final ResultSet resultSet, final T bean) throws
SQLException {
final PropertyDescriptor[] props =
propertyDescriptors(bean.getClass());
@@ -338,7 +338,7 @@ public class BeanProcessor {
* @param props The property descriptors.
* @param columnToProperty The column indices in the result set.
* @return An initialized object.
- * @throws SQLException if a database error occurs.
+ * @throws SQLException Thrown if a database error occurs.
*/
private <T> T populateBean(final ResultSet resultSet, final T bean,
final PropertyDescriptor[] props, final int[] columnToProperty)
@@ -388,7 +388,7 @@ public class BeanProcessor {
* @param propType The bean property type that this column needs to be
* converted into.
*
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The object from the {@code ResultSet} at the given column
* index after optional type processing or {@code null} if the column
* value was SQL NULL.
@@ -412,7 +412,7 @@ public class BeanProcessor {
*
* @param c The Class to retrieve PropertyDescriptors for.
* @return A PropertyDescriptor[] describing the Class.
- * @throws SQLException if introspection failed.
+ * @throws SQLException Thrown if introspection failed.
*/
private PropertyDescriptor[] propertyDescriptors(final Class<?> c)
throws SQLException {
@@ -460,7 +460,7 @@ public class BeanProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created bean
*/
public <T> T toBean(final ResultSet rs, final Class<? extends T> type)
throws SQLException {
@@ -499,7 +499,7 @@ public class BeanProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created List of beans
*/
public <T> List<T> toBeanList(final ResultSet resultSet, final Class<?
extends T> type) throws SQLException {
diff --git a/src/main/java/org/apache/commons/dbutils/ColumnHandler.java
b/src/main/java/org/apache/commons/dbutils/ColumnHandler.java
index c4bf229..259974d 100644
--- a/src/main/java/org/apache/commons/dbutils/ColumnHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/ColumnHandler.java
@@ -33,7 +33,7 @@ public interface ColumnHandler<T> {
* @param resultSet The source result set. This must be on the correct
row.
* @param columnIndex The position of the column to retrieve, a 1-based
index.
* @return The converted value or the original value if something doesn't
work out.
- * @throws SQLException if the columnIndex is not valid; if a database
access error occurs or this method is called on a closed result set
+ * @throws SQLException Thrown if the columnIndex is not valid; if a
database access error occurs or this method is called on a closed result set
*/
T apply(ResultSet resultSet, int columnIndex) throws SQLException;
diff --git a/src/main/java/org/apache/commons/dbutils/DbUtils.java
b/src/main/java/org/apache/commons/dbutils/DbUtils.java
index bd3757e..37af3eb 100644
--- a/src/main/java/org/apache/commons/dbutils/DbUtils.java
+++ b/src/main/java/org/apache/commons/dbutils/DbUtils.java
@@ -118,7 +118,7 @@ public final class DbUtils {
* Close a {@code Connection}, avoid closing if null.
*
* @param conn Connection to close.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public static void close(final Connection conn) throws SQLException {
if (conn != null) {
@@ -130,7 +130,7 @@ public final class DbUtils {
* Close a {@code ResultSet}, avoid closing if null.
*
* @param resultSet ResultSet to close.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public static void close(final ResultSet resultSet) throws SQLException {
if (resultSet != null) {
@@ -142,7 +142,7 @@ public final class DbUtils {
* Close a {@code Statement}, avoid closing if null.
*
* @param stmt Statement to close.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public static void close(final Statement stmt) throws SQLException {
if (stmt != null) {
@@ -220,7 +220,7 @@ public final class DbUtils {
* Commits a {@code Connection} then closes it, avoid closing if null.
*
* @param conn Connection to close.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public static void commitAndClose(final Connection conn) throws
SQLException {
if (conn != null) {
@@ -358,7 +358,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
+ * @throws SQLException Thrown if a database access error occurs
*/
public static void rollback(final Connection conn) throws SQLException {
if (conn != null) {
@@ -371,7 +371,7 @@ public final class DbUtils {
* avoid closing if null.
*
* @param conn Connection to rollback. A null value is legal.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.1
*/
public static void rollbackAndClose(final Connection conn) throws
SQLException {
diff --git a/src/main/java/org/apache/commons/dbutils/OutParameter.java
b/src/main/java/org/apache/commons/dbutils/OutParameter.java
index a3ebcfe..eb5c374 100644
--- a/src/main/java/org/apache/commons/dbutils/OutParameter.java
+++ b/src/main/java/org/apache/commons/dbutils/OutParameter.java
@@ -107,7 +107,7 @@ public class OutParameter<T> {
*
* @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
+ * @throws SQLException Thrown if the parameter could not be registered,
or if the
* value of the parameter could not be set.
*/
void register(final CallableStatement stmt, final int index) throws
SQLException {
diff --git a/src/main/java/org/apache/commons/dbutils/QueryLoader.java
b/src/main/java/org/apache/commons/dbutils/QueryLoader.java
index 31bbecb..3942026 100644
--- a/src/main/java/org/apache/commons/dbutils/QueryLoader.java
+++ b/src/main/java/org/apache/commons/dbutils/QueryLoader.java
@@ -72,7 +72,7 @@ public class QueryLoader {
* This is <strong>not</strong> a file system path. If you had a jarred
* Queries.properties file in the com.yourcorp.app.jdbc package you would
* pass "/com/yourcorp/app/jdbc/Queries.properties" to this method.
- * @throws IOException if a file access error occurs
+ * @throws IOException Thrown if a file access error occurs
* @throws IllegalArgumentException if the ClassLoader can't find a file at
* the given path.
* @throws java.util.InvalidPropertiesFormatException if the XML
properties file is
@@ -99,7 +99,7 @@ public class QueryLoader {
* must use a {@code .xml} file extension.
*
* @param path The path that the ClassLoader will use to find the file.
- * @throws IOException if a file access error occurs
+ * @throws IOException Thrown if a file access error occurs
* @throws IllegalArgumentException if the ClassLoader can't find a file at
* @return Map of query names to SQL values
* the given path.
diff --git a/src/main/java/org/apache/commons/dbutils/QueryRunner.java
b/src/main/java/org/apache/commons/dbutils/QueryRunner.java
index d7f431c..114af2e 100644
--- a/src/main/java/org/apache/commons/dbutils/QueryRunner.java
+++ b/src/main/java/org/apache/commons/dbutils/QueryRunner.java
@@ -126,7 +126,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param params An array of query replacement parameters. Each row in
* this array is one set of batch replacement values.
* @return The number of rows updated per statement.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.1
*/
public int[] batch(final Connection conn, final String sql, final
Object[][] params) throws SQLException {
@@ -176,7 +176,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param params An array of query replacement parameters. Each row in
* this array is one set of batch replacement values.
* @return The number of rows updated per statement.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.1
*/
public int[] batch(final String sql, final Object[][] params) throws
SQLException {
@@ -202,7 +202,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param sql The SQL to execute.
* @param params The query replacement parameters.
* @return The number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public int execute(final Connection conn, final String sql, final
Object... params) throws SQLException {
if (conn == null) {
@@ -253,7 +253,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param rsh The result set handler
* @param params The query replacement parameters.
* @return A list of objects generated by the handler
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> List<T> execute(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object... params) throws SQLException {
if (conn == null) {
@@ -316,7 +316,7 @@ public class QueryRunner extends AbstractQueryRunner {
*
* @param sql The SQL statement to execute.
* @param params Initializes the CallableStatement's parameters (i.e. '?').
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The number of rows updated.
*/
public int execute(final String sql, final Object... params) throws
SQLException {
@@ -344,7 +344,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param rsh The result set handler
* @param params The query replacement parameters.
* @return A list of objects generated by the handler
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> List<T> execute(final String sql, final ResultSetHandler<T>
rsh, final Object... params) throws SQLException {
try (Connection conn = prepareConnection()) {
@@ -361,7 +361,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param rsh The handler used to create the result object from
* the {@code ResultSet} of auto-generated keys.
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insert(final Connection conn, final String sql, final
ResultSetHandler<T> rsh) throws SQLException {
@@ -378,7 +378,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet} of auto-generated keys.
* @param params The query replacement parameters.
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insert(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object... params) throws SQLException {
@@ -429,7 +429,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param rsh The handler used to create the result object from
* the {@code ResultSet} of auto-generated keys.
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insert(final String sql, final ResultSetHandler<T> rsh)
throws SQLException {
@@ -450,7 +450,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet} of auto-generated keys.
* @param params Initializes the PreparedStatement's IN (i.e. '?')
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insert(final String sql, final ResultSetHandler<T> rsh, final
Object... params) throws SQLException {
@@ -469,7 +469,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet} of auto-generated keys.
* @param params The query replacement parameters.
* @return The result generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insertBatch(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object[][] params) throws SQLException {
@@ -519,7 +519,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet} of auto-generated keys.
* @param params Initializes the PreparedStatement's IN (i.e. '?')
* @return The result generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @since 1.6
*/
public <T> T insertBatch(final String sql, final ResultSetHandler<T> rsh,
final Object[][] params) throws SQLException {
@@ -538,7 +538,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param param The replacement parameter.
* @param rsh The handler that converts the results into an object.
* @return The object returned by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @deprecated Use {@link #query(Connection, String, ResultSetHandler,
Object...)}
*/
@Deprecated
@@ -556,7 +556,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param params The replacement parameters.
* @param rsh The handler that converts the results into an object.
* @return The object returned by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @deprecated Use {@link
#query(Connection,String,ResultSetHandler,Object...)} instead
*/
@Deprecated
@@ -573,7 +573,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param sql The query to execute.
* @param rsh The handler that converts the results into an object.
* @return The object returned by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> T query(final Connection conn, final String sql, final
ResultSetHandler<T> rsh) throws SQLException {
return this.<T>query(conn, sql, rsh, (Object[]) null);
@@ -589,7 +589,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param rsh The handler that converts the results into an object.
* @param params The replacement parameters.
* @return The object returned by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> T query(final Connection conn, final String sql, final
ResultSetHandler<T> rsh, final Object... params) throws SQLException {
if (conn == null) {
@@ -643,7 +643,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet}.
*
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @deprecated Use {@link #query(String, ResultSetHandler, Object...)}
*/
@Deprecated
@@ -667,7 +667,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet}.
*
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @deprecated Use {@link #query(String, ResultSetHandler, Object...)}
*/
@Deprecated
@@ -688,7 +688,7 @@ public class QueryRunner extends AbstractQueryRunner {
* the {@code ResultSet}.
*
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> T query(final String sql, final ResultSetHandler<T> rsh) throws
SQLException {
try (Connection conn = prepareConnection()) {
@@ -708,7 +708,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param params Initialize the PreparedStatement's IN parameters with
* this array.
* @return An object generated by the handler.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public <T> T query(final String sql, final ResultSetHandler<T> rsh, final
Object... params) throws SQLException {
try (Connection conn = prepareConnection()) {
@@ -743,7 +743,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param conn The connection to use to run the query.
* @param sql The SQL to execute.
* @return The number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public int update(final Connection conn, final String sql) throws
SQLException {
return this.update(conn, sql, (Object[]) null);
@@ -757,7 +757,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param sql The SQL to execute.
* @param param The replacement parameter.
* @return The number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public int update(final Connection conn, final String sql, final Object
param) throws SQLException {
return this.update(conn, sql, new Object[] { param });
@@ -770,7 +770,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param sql The SQL to execute.
* @param params The query replacement parameters.
* @return The number of rows updated.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
public int update(final Connection conn, final String sql, final Object...
params) throws SQLException {
if (conn == null) {
@@ -813,7 +813,7 @@ public class QueryRunner extends AbstractQueryRunner {
* not be saved.
*
* @param sql The SQL statement to execute.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The number of rows updated.
*/
public int update(final String sql) throws SQLException {
@@ -831,7 +831,7 @@ public class QueryRunner extends AbstractQueryRunner {
*
* @param sql The SQL statement to execute.
* @param param The replacement parameter.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The number of rows updated.
*/
public int update(final String sql, final Object param) throws
SQLException {
@@ -849,7 +849,7 @@ public class QueryRunner extends AbstractQueryRunner {
* @param sql The SQL statement to execute.
* @param params Initializes the PreparedStatement's IN (i.e. '?')
* parameters.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The number of rows updated.
*/
public int update(final String sql, final Object... params) throws
SQLException {
diff --git a/src/main/java/org/apache/commons/dbutils/ResultSetHandler.java
b/src/main/java/org/apache/commons/dbutils/ResultSetHandler.java
index 180fd44..e9f9641 100644
--- a/src/main/java/org/apache/commons/dbutils/ResultSetHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/ResultSetHandler.java
@@ -33,7 +33,7 @@ public interface ResultSetHandler<T> {
* @param resultSet The {@link ResultSet} to handle. It has not been
touched before being passed to this method.
* @return An Object initialized with {@code ResultSet} data. It is legal
for implementations to return {@code null} if the {@link ResultSet} contained 0
* rows.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
T handle(ResultSet resultSet) throws SQLException;
}
diff --git a/src/main/java/org/apache/commons/dbutils/RowProcessor.java
b/src/main/java/org/apache/commons/dbutils/RowProcessor.java
index d4426e5..19862f0 100644
--- a/src/main/java/org/apache/commons/dbutils/RowProcessor.java
+++ b/src/main/java/org/apache/commons/dbutils/RowProcessor.java
@@ -39,7 +39,7 @@ public interface RowProcessor {
* the {@code ResultSet}.
*
* @param resultSet ResultSet that supplies the array data
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created array
*/
Object[] toArray(ResultSet resultSet) throws SQLException;
@@ -53,7 +53,7 @@ public interface RowProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created bean
*/
<T> T toBean(ResultSet resultSet, Class<? extends T> type) throws
SQLException;
@@ -66,7 +66,7 @@ public interface RowProcessor {
* @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
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return A {@code List} of beans with the given type in the order
* they were returned by the {@code ResultSet}.
*/
@@ -80,7 +80,7 @@ public interface RowProcessor {
* alter the row position of the {@code ResultSet}.
*
* @param resultSet ResultSet that supplies the map data
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @return The newly created Map
*/
Map<String, Object> toMap(ResultSet resultSet) throws SQLException;
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 fd98b88..43b12bd 100644
---
a/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
+++
b/src/main/java/org/apache/commons/dbutils/handlers/AbstractKeyedHandler.java
@@ -50,7 +50,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
*
* @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
+ * @throws SQLException Thrown if a database access error occurs
*/
protected abstract K createKey(ResultSet resultSet) throws SQLException;
@@ -71,7 +71,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
*
* @param resultSet ResultSet to create a row from
* @return V object created from the current row
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected abstract V createRow(ResultSet resultSet) throws SQLException;
@@ -81,7 +81,7 @@ public abstract class AbstractKeyedHandler<K, V> implements
ResultSetHandler<Map
*
* @param resultSet {@code ResultSet} to process.
* @return A {@code Map}, never {@code null}.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
@Override
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 6cbf6c3..d7597c1 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ArrayHandler.java
@@ -75,7 +75,7 @@ public class ArrayHandler implements
ResultSetHandler<Object[]> {
* @return An Object[]. If there are no rows in the {@code ResultSet}
* an empty array will be returned.
*
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
@Override
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 d34911f..880bfc2 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ArrayListHandler.java
@@ -59,7 +59,7 @@ public class ArrayListHandler extends
AbstractListHandler<Object[]> {
*
* @param resultSet {@code ResultSet} to process.
* @return {@code Object[]}, never {@code null}.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.handlers.AbstractListHandler#handle(ResultSet)
*/
@Override
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 2e97e88..fa72f38 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/BeanHandler.java
@@ -72,7 +72,7 @@ public class BeanHandler<T> implements ResultSetHandler<T> {
* @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
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
@Override
diff --git
a/src/main/java/org/apache/commons/dbutils/handlers/BeanListHandler.java
b/src/main/java/org/apache/commons/dbutils/handlers/BeanListHandler.java
index b406669..173b5f1 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/BeanListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/BeanListHandler.java
@@ -73,7 +73,7 @@ public class BeanListHandler<T> implements
ResultSetHandler<List<T>> {
*
* @param resultSet The {@code ResultSet} to handle.
* @return A List of beans, never {@code null}.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see org.apache.commons.dbutils.RowProcessor#toBeanList(ResultSet,
Class)
*/
@Override
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 c43622d..5a6aeb4 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/BeanMapHandler.java
@@ -160,7 +160,7 @@ public class BeanMapHandler<K, V> extends
AbstractKeyedHandler<K, V> {
*
* @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
+ * @throws SQLException Thrown if a database access error occurs
* @throws ClassCastException if the class datatype does not match the
column type
* @see
org.apache.commons.dbutils.handlers.AbstractKeyedHandler#createKey(ResultSet)
*/
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 596fb7c..5335328 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ColumnListHandler.java
@@ -85,7 +85,7 @@ public class ColumnListHandler<T> extends
AbstractListHandler<T> {
*
* @param resultSet {@code ResultSet} to process.
* @return {@code Object}, never {@code null}.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @throws ClassCastException if the class datatype does not match the
column type
* @see
org.apache.commons.dbutils.handlers.AbstractListHandler#handle(ResultSet)
*/
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 4036506..ddf2321 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/KeyedHandler.java
@@ -130,7 +130,7 @@ public class KeyedHandler<K> extends
AbstractKeyedHandler<K, Map<String, Object>
*
* @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
+ * @throws SQLException Thrown if a database access error occurs
* @throws ClassCastException if the class datatype does not match the
column type
*/
// We assume that the user has picked the correct type to match the column
@@ -152,7 +152,7 @@ public class KeyedHandler<K> extends
AbstractKeyedHandler<K, Map<String, Object>
*
* @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
+ * @throws SQLException Thrown if a database access error occurs
*/
@Override
protected Map<String, Object> createRow(final ResultSet resultSet) throws
SQLException {
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 2ff622d..0545898 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/MapHandler.java
@@ -63,7 +63,7 @@ public class MapHandler implements
ResultSetHandler<Map<String, Object>> {
* @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
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
@Override
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 8855e96..ed4c359 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/MapListHandler.java
@@ -60,7 +60,7 @@ public class MapListHandler extends
AbstractListHandler<Map<String, Object>> {
*
* @param resultSet {@code ResultSet} to process.
* @return A {@code Map}, never null.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @see
org.apache.commons.dbutils.handlers.AbstractListHandler#handle(ResultSet)
*/
@Override
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 440b8e5..a2b662e 100644
--- a/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
+++ b/src/main/java/org/apache/commons/dbutils/handlers/ScalarHandler.java
@@ -89,7 +89,7 @@ public class ScalarHandler<T> implements ResultSetHandler<T> {
* @return The column or {@code null} if there are no rows in
* the {@code ResultSet}.
*
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
* @throws ClassCastException if the class datatype does not match the
column type
* @see
org.apache.commons.dbutils.ResultSetHandler#handle(java.sql.ResultSet)
*/
diff --git a/src/test/java/org/apache/commons/dbutils/MockResultSet.java
b/src/test/java/org/apache/commons/dbutils/MockResultSet.java
index 5ad976b..fd7f108 100644
--- a/src/test/java/org/apache/commons/dbutils/MockResultSet.java
+++ b/src/test/java/org/apache/commons/dbutils/MockResultSet.java
@@ -84,7 +84,7 @@ public class MockResultSet implements InvocationHandler {
*
* @param args
* @return A column index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
private int columnIndex(final Object[] args) throws SQLException {
if (args[0] instanceof Integer) {
@@ -100,7 +100,7 @@ public class MockResultSet implements InvocationHandler {
* Returns the column index for the given column name.
*
* @return A 1 based index
- * @throws SQLException if the column name is invalid
+ * @throws SQLException Thrown if the column name is invalid
*/
private int columnNameToIndex(final String columnName) throws SQLException
{
if (currentRow == null) {
@@ -119,7 +119,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the boolean value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getBoolean(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -135,7 +135,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the byte value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getByte(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -151,7 +151,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the double value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getDouble(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -167,7 +167,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the float value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getFloat(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -183,7 +183,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the int value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getInt(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -199,7 +199,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the long value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getLong(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -222,7 +222,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the object at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getObject(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -234,7 +234,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the short value at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected Object getShort(final int columnIndex) throws SQLException {
final Object obj = getValueAt(columnIndex);
@@ -250,7 +250,7 @@ public class MockResultSet implements InvocationHandler {
* Gets the String at the given column index.
*
* @param columnIndex A 1 based index.
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
protected String getString(final int columnIndex) throws SQLException {
final Object obj = getObject(columnIndex);
diff --git
a/src/test/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSetTest.java
b/src/test/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSetTest.java
index 468b261..74a5829 100644
---
a/src/test/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSetTest.java
+++
b/src/test/java/org/apache/commons/dbutils/wrappers/StringTrimmedResultSetTest.java
@@ -53,7 +53,7 @@ class StringTrimmedResultSetTest extends BaseTestCase {
/**
* Make sure 2 wrappers work together.
*
- * @throws SQLException if a database access error occurs
+ * @throws SQLException Thrown if a database access error occurs
*/
@Test
void testMultipleWrappers() throws Exception {
