This is an automated email from the ASF dual-hosted git repository.
garydgregory pushed a commit to branch 1.X
in repository https://gitbox.apache.org/repos/asf/commons-beanutils.git
The following commit(s) were added to refs/heads/1.X by this push:
new 27f8f026 Javadoc
27f8f026 is described below
commit 27f8f02696235ba3a008e1edbb6f30487f81d0f1
Author: Gary Gregory <[email protected]>
AuthorDate: Sun Aug 2 15:27:34 2026 -0400
Javadoc
---
.../java/org/apache/commons/beanutils/JDBCDynaClass.java | 6 +++---
.../org/apache/commons/beanutils/ResultSetDynaClass.java | 10 +++++-----
.../org/apache/commons/beanutils/ResultSetIterator.java | 2 +-
.../java/org/apache/commons/beanutils/RowSetDynaClass.java | 14 +++++++-------
.../commons/beanutils/converters/CharacterConverter.java | 2 +-
.../commons/beanutils/converters/DateTimeConverter.java | 4 ++--
.../DynaPropertySerializationReadVersion1Test.java | 2 +-
.../java/org/apache/commons/beanutils/DynaRowSetTest.java | 6 +++---
.../org/apache/commons/beanutils/bugs/Jira456Test.java | 2 +-
9 files changed, 24 insertions(+), 24 deletions(-)
diff --git a/src/main/java/org/apache/commons/beanutils/JDBCDynaClass.java
b/src/main/java/org/apache/commons/beanutils/JDBCDynaClass.java
index ca7977f1..e8ab10c1 100644
--- a/src/main/java/org/apache/commons/beanutils/JDBCDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/JDBCDynaClass.java
@@ -189,7 +189,7 @@ abstract class JDBCDynaClass implements DynaClass,
Serializable {
* @param resultSet The result set
* @param name The property name
* @return The value
- * @throws SQLException if an error occurs
+ * @throws SQLException Thrown if an error occurs
*/
protected Object getObject(final ResultSet resultSet, final String name)
throws SQLException {
@@ -226,7 +226,7 @@ abstract class JDBCDynaClass implements DynaClass,
Serializable {
* @param resultSet The {@code resultSet} whose metadata is to
* be introspected
*
- * @throws SQLException if an error is encountered processing the
+ * @throws SQLException Thrown if an error is encountered processing the
* result set metadata
*/
protected void introspect(final ResultSet resultSet) throws SQLException {
@@ -259,7 +259,7 @@ abstract class JDBCDynaClass implements DynaClass,
Serializable {
*
* @param className The name of the class to load
* @return The loaded class
- * @throws SQLException if an exception was thrown trying to load
+ * @throws SQLException Thrown if an exception was thrown trying to load
* the specified class
*/
protected Class<?> loadClass(final String className) throws SQLException {
diff --git a/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
b/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
index 66d7ee0e..c7ea2dd1 100644
--- a/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
@@ -94,7 +94,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
* @param resultSet The result set to be wrapped
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public ResultSetDynaClass(final ResultSet resultSet) throws SQLException {
@@ -120,7 +120,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
* @param lowerCase Should property names be lower cased?
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public ResultSetDynaClass(final ResultSet resultSet, final boolean
lowerCase)
@@ -148,7 +148,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
* @param useColumnLabel true if the column label should be used,
otherwise false
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
* @since 1.8.3
*/
@@ -167,7 +167,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
*
* @param name The property name
* @return The value
- * @throws SQLException if an error occurs
+ * @throws SQLException Thrown if an error occurs
* @since 1.8.0
*/
public Object getObjectFromResultSet(final String name) throws
SQLException {
@@ -206,7 +206,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
*
* @param className The name of the class to load
* @return The loaded class
- * @throws SQLException if the class cannot be loaded
+ * @throws SQLException Thrown if the class cannot be loaded
*/
@Override
protected Class<?> loadClass(final String className) throws SQLException {
diff --git a/src/main/java/org/apache/commons/beanutils/ResultSetIterator.java
b/src/main/java/org/apache/commons/beanutils/ResultSetIterator.java
index 82288d0f..9607407e 100644
--- a/src/main/java/org/apache/commons/beanutils/ResultSetIterator.java
+++ b/src/main/java/org/apache/commons/beanutils/ResultSetIterator.java
@@ -62,7 +62,7 @@ public class ResultSetIterator implements DynaBean,
Iterator<DynaBean> {
* <p>Advance the result set to the next row, if there is not a current
* row (and if we are not already at eof).</p>
*
- * @throws SQLException if the result set throws an exception
+ * @throws SQLException Thrown if the result set throws an exception
*/
protected void advance() throws SQLException {
if (!current && !eof) {
diff --git a/src/main/java/org/apache/commons/beanutils/RowSetDynaClass.java
b/src/main/java/org/apache/commons/beanutils/RowSetDynaClass.java
index b2a8a443..bb169d09 100644
--- a/src/main/java/org/apache/commons/beanutils/RowSetDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/RowSetDynaClass.java
@@ -87,7 +87,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param resultSet The result set to be wrapped
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public RowSetDynaClass(final ResultSet resultSet) throws SQLException {
@@ -110,7 +110,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param lowerCase Should property names be lower cased?
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public RowSetDynaClass(final ResultSet resultSet, final boolean lowerCase)
@@ -137,7 +137,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param useColumnLabel true if the column label should be used,
otherwise false
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
* @since 1.8.3
*/
@@ -165,7 +165,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param limit Maximum limit for the {@code List} of {@link DynaBean}
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public RowSetDynaClass(final ResultSet resultSet, final boolean lowerCase,
final int limit)
@@ -194,7 +194,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param useColumnLabel true if the column label should be used,
otherwise false
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
* @since 1.8.3
*/
@@ -220,7 +220,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param limit The maximum for the size of the result.
* @throws NullPointerException if {@code resultSet}
* is {@code null}
- * @throws SQLException if the metadata for this result set
+ * @throws SQLException Thrown if the metadata for this result set
* cannot be introspected
*/
public RowSetDynaClass(final ResultSet resultSet, final int limit) throws
SQLException {
@@ -238,7 +238,7 @@ public class RowSetDynaClass extends JDBCDynaClass {
* @param resultSet The {@code ResultSet} whose data is to be
* copied
*
- * @throws SQLException if an error is encountered copying the data
+ * @throws SQLException Thrown if an error is encountered copying the data
*/
protected void copy(final ResultSet resultSet) throws SQLException {
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/CharacterConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/CharacterConverter.java
index 3e0baa0e..85d894e8 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/CharacterConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/CharacterConverter.java
@@ -66,7 +66,7 @@ public final class CharacterConverter extends
AbstractConverter {
* @param type Data type to which this value should be converted.
* @param value The input value to be converted.
* @return The converted value.
- * @throws Exception if conversion cannot be performed successfully
+ * @throws Exception Thrown if conversion cannot be performed successfully
* @since 1.8.0
*/
@Override
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
index 6c23dfc1..5c92d096 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
@@ -183,7 +183,7 @@ public abstract class DateTimeConverter extends
AbstractConverter {
* @param targetType Data type to which this value should be converted.
* @param value The input value to be converted.
* @return The converted value.
- * @throws Exception if conversion cannot be performed successfully
+ * @throws Exception Thrown if conversion cannot be performed successfully
*/
@Override
protected <T> T convertToType(final Class<T> targetType, final Object
value) throws Exception {
@@ -353,7 +353,7 @@ public abstract class DateTimeConverter extends
AbstractConverter {
* @param targetType The type to convert the value to.
* @param value The String date value.
* @return The converted Date object.
- * @throws Exception if an error occurs parsing the date.
+ * @throws Exception Thrown if an error occurs parsing the date.
*/
private Calendar parse(final Class<?> sourceType, final Class<?>
targetType, final String value) throws Exception {
Exception firstEx = null;
diff --git
a/src/test/java/org/apache/commons/beanutils/DynaPropertySerializationReadVersion1Test.java
b/src/test/java/org/apache/commons/beanutils/DynaPropertySerializationReadVersion1Test.java
index 4dcc82c2..c7e8cde3 100644
---
a/src/test/java/org/apache/commons/beanutils/DynaPropertySerializationReadVersion1Test.java
+++
b/src/test/java/org/apache/commons/beanutils/DynaPropertySerializationReadVersion1Test.java
@@ -82,7 +82,7 @@ class DynaPropertySerializationReadVersion1Test {
*
* @param dir directory containing {@code *.ser} files.
* @param description human-readable label used in assertion messages.
- * @throws Exception if deserialization fails or an assertion is violated.
+ * @throws Exception Thrown if deserialization fails or an assertion is
violated.
*/
private static void assertDeserializeFromDirectory(final File dir, final
String description) throws Exception {
assertTrue(dir.isDirectory(), () -> description + ": directory must
exist: " + dir.getAbsolutePath());
diff --git a/src/test/java/org/apache/commons/beanutils/DynaRowSetTest.java
b/src/test/java/org/apache/commons/beanutils/DynaRowSetTest.java
index 54aab53b..a875021c 100644
--- a/src/test/java/org/apache/commons/beanutils/DynaRowSetTest.java
+++ b/src/test/java/org/apache/commons/beanutils/DynaRowSetTest.java
@@ -55,7 +55,7 @@ public class DynaRowSetTest extends TestCase {
* Get an columns's value
* @param columnName Name of the column
* @return The column value
- * @throws SQLException if an error occurs
+ * @throws SQLException Thrown if an error occurs
*/
@Override
public Object getObject(final String columnName) throws SQLException {
@@ -81,7 +81,7 @@ public class DynaRowSetTest extends TestCase {
*
* @param columnIndex The column index
* @return The column class name
- * @throws SQLException if an error occurs
+ * @throws SQLException Thrown if an error occurs
*/
@Override
public String getColumnClassName(final int columnIndex) throws
SQLException {
@@ -195,7 +195,7 @@ public class DynaRowSetTest extends TestCase {
*
* See issue# https://issues.apache.org/jira/browse/BEANUTILS-142
*
- * @throws Exception if an error occurs
+ * @throws Exception Thrown if an error occurs
*/
public void testInconsistentOracleDriver() throws Exception {
diff --git a/src/test/java/org/apache/commons/beanutils/bugs/Jira456Test.java
b/src/test/java/org/apache/commons/beanutils/bugs/Jira456Test.java
index 264a6119..64502fe0 100644
--- a/src/test/java/org/apache/commons/beanutils/bugs/Jira456Test.java
+++ b/src/test/java/org/apache/commons/beanutils/bugs/Jira456Test.java
@@ -43,7 +43,7 @@ public class Jira456Test extends TestCase {
* property. This simulates that the write method reference is freed by
the GC.
*
* @return The bean instance used for testing
- * @throws Exception if an error occurs
+ * @throws Exception Thrown if an error occurs
*/
private FluentIntrospectionTestBean clearWriteMethodRef() throws Exception
{
final FluentIntrospectionTestBean bean = new
FluentIntrospectionTestBean();
