This is an automated email from the ASF dual-hosted git repository.
ggregory 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 4f5d4546 Javadoc: Empty Javadoc line before the 1st tag.
4f5d4546 is described below
commit 4f5d45465abe32ff8768c024b4dbbf5dc9733673
Author: Gary Gregory <[email protected]>
AuthorDate: Wed Dec 31 17:39:13 2025 -0500
Javadoc: Empty Javadoc line before the 1st tag.
---
.../beanutils/BaseDynaBeanMapDecorator.java | 1 +
.../apache/commons/beanutils/BeanComparator.java | 2 ++
.../apache/commons/beanutils/BeanPredicate.java | 5 ++++
.../org/apache/commons/beanutils/BeanUtils.java | 4 ++++
.../apache/commons/beanutils/BeanUtilsBean.java | 1 +
.../apache/commons/beanutils/ConstructorUtils.java | 3 +++
.../commons/beanutils/ContextClassLoaderLocal.java | 2 ++
.../org/apache/commons/beanutils/ConvertUtils.java | 16 +++++++++++++
.../apache/commons/beanutils/ConvertUtilsBean.java | 28 ++++++++++++++++++++++
.../org/apache/commons/beanutils/DynaProperty.java | 2 ++
.../org/apache/commons/beanutils/LazyDynaBean.java | 9 +++++++
.../apache/commons/beanutils/LazyDynaClass.java | 3 +++
.../org/apache/commons/beanutils/LazyDynaMap.java | 3 +++
.../beanutils/MappedPropertyDescriptor.java | 1 +
.../org/apache/commons/beanutils/MethodUtils.java | 8 +++++++
.../apache/commons/beanutils/PropertyUtils.java | 2 ++
.../commons/beanutils/PropertyUtilsBean.java | 1 +
.../commons/beanutils/ResultSetDynaClass.java | 2 ++
.../apache/commons/beanutils/WeakFastHashMap.java | 3 +++
.../org/apache/commons/beanutils/WrapDynaBean.java | 1 +
.../apache/commons/beanutils/WrapDynaClass.java | 2 ++
.../converters/AbstractArrayConverter.java | 1 +
.../beanutils/converters/AbstractConverter.java | 2 ++
.../beanutils/converters/ArrayConverter.java | 1 +
.../converters/BooleanArrayConverter.java | 1 +
.../beanutils/converters/BooleanConverter.java | 1 +
.../beanutils/converters/DateTimeConverter.java | 2 ++
.../beanutils/converters/NumberConverter.java | 3 +++
.../beanutils/converters/SqlTimeConverter.java | 1 +
.../converters/SqlTimestampConverter.java | 1 +
.../beanutils/locale/LocaleBeanUtilsBean.java | 1 +
.../beanutils/locale/LocaleConvertUtils.java | 1 +
.../beanutils/locale/LocaleConvertUtilsBean.java | 3 +++
33 files changed, 117 insertions(+)
diff --git
a/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
b/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
index 6939a8d0..a738b130 100644
--- a/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
+++ b/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
@@ -342,6 +342,7 @@ public abstract class BaseDynaBeanMapDecorator<K>
implements Map<K, Object> {
/**
* Returns the number properties in the decorated
* {@link DynaBean}.
+ *
* @return The number of properties.
*/
@Override
diff --git a/src/main/java/org/apache/commons/beanutils/BeanComparator.java
b/src/main/java/org/apache/commons/beanutils/BeanComparator.java
index f33c750e..371e34fa 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanComparator.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanComparator.java
@@ -147,6 +147,7 @@ public class BeanComparator<T> implements Comparator<T>,
Serializable {
* Two {@code BeanComparator}'s are equals if and only if
* the wrapped comparators and the property names to be compared
* are equal.
+ *
* @param o Comparator to compare to
* @return whether the comparators are equal or not
*/
@@ -195,6 +196,7 @@ public class BeanComparator<T> implements Comparator<T>,
Serializable {
/**
* Hash code compatible with equals.
+ *
* @return the hash code for this comparator
*/
@Override
diff --git a/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
b/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
index 03b00a54..07df1816 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
@@ -41,6 +41,7 @@ public class BeanPredicate implements Predicate {
/**
* Constructs a {@code BeanPredicate} that applies the given
* {@code Predicate} to the named property value.
+ *
* @param propertyName the name of the property whose value is to be
predicated,
* not null
* @param predicate the {@code Predicate} to be applied,
@@ -91,6 +92,7 @@ public class BeanPredicate implements Predicate {
/**
* Gets the {@code Predicate} to be applied to the value of the named
property
* during {@link #evaluate}.
+ *
* @return {@code Predicate}, not null
*/
public Predicate getPredicate() {
@@ -100,6 +102,7 @@ public class BeanPredicate implements Predicate {
/**
* Gets the name of the property whose value is to be predicated.
* in the evaluation.
+ *
* @return the property name, not null
*/
public String getPropertyName() {
@@ -109,6 +112,7 @@ public class BeanPredicate implements Predicate {
/**
* Sets the {@code Predicate} to be applied to the value of the named
property
* during {@link #evaluate(Object)}.
+ *
* @param predicate {@code Predicate}, not null
*/
public void setPredicate(final Predicate predicate) {
@@ -117,6 +121,7 @@ public class BeanPredicate implements Predicate {
/**
* Sets the name of the property whose value is to be predicated.
+ *
* @param propertyName the name of the property whose value is to be
predicated,
* not null
*/
diff --git a/src/main/java/org/apache/commons/beanutils/BeanUtils.java
b/src/main/java/org/apache/commons/beanutils/BeanUtils.java
index f09cd5c5..43d9638e 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanUtils.java
@@ -115,6 +115,7 @@ public class BeanUtils {
/**
* Create a cache.
+ *
* @param <K> the key type of the cache
* @param <V> the value type of the cache
* @return a new cache
@@ -185,6 +186,7 @@ public class BeanUtils {
/**
* The {@code debug} static property is no longer used
+ *
* @return debug property
* @deprecated BeanUtils now uses commons-logging for all log messages.
* Use your favorite logging tool to configure logging for
@@ -408,6 +410,7 @@ public class BeanUtils {
/**
* Set whether fast on a Map
+ *
* @param map The map
* @param fast Whether it should be fast or not.
* @since 1.8.0
@@ -420,6 +423,7 @@ public class BeanUtils {
/**
* The {@code debug} static property is no longer used
+ *
* @param newDebug debug property
* @deprecated BeanUtils now uses commons-logging for all log messages.
* Use your favorite logging tool to configure logging for
diff --git a/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
index 8ea3d604..9a9f450d 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
@@ -489,6 +489,7 @@ public class BeanUtilsBean {
* is called. It is recommended that such methods are given alternative
* names (for example, {@code parametersMap}).
* </p>
+ *
* @param bean Bean whose properties are to be extracted
* @return Map of property descriptors
* @throws IllegalAccessException if the caller does not have
diff --git a/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
b/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
index 84527ea0..117a2816 100644
--- a/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
@@ -50,6 +50,7 @@ public class ConstructorUtils {
/**
* Returns a constructor with single argument.
+ *
* @param <T> the type of the constructor
* @param klass the class to be constructed
* @param parameterType The constructor parameter type
@@ -67,6 +68,7 @@ public class ConstructorUtils {
/**
* Returns a constructor given a class and signature.
+ *
* @param <T> the type to be constructed
* @param klass the class to be constructed
* @param parameterTypes the parameter array
@@ -88,6 +90,7 @@ public class ConstructorUtils {
/**
* Returns accessible version of the given constructor.
+ *
* @param <T> the type of the constructor
* @param ctor prototype constructor object.
* @return {@code null} if accessible constructor cannot be found.
diff --git
a/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
b/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
index 5e0ca48f..a5374953 100644
--- a/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
+++ b/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
@@ -115,6 +115,7 @@ public class ContextClassLoaderLocal<T> {
* Gets the instance which provides the functionality for {@link
BeanUtils}.
* This is a pseudo-singleton - an single instance is provided per
(thread) context classloader.
* This mechanism provides isolation for web apps deployed in the same
container.
+ *
* @return the object currently associated with the context-classloader of
the current thread.
*/
public synchronized T get() {
@@ -197,6 +198,7 @@ public class ContextClassLoaderLocal<T> {
/**
* Unsets the value associated with the given classloader
+ *
* @param classLoader The classloader to <em>unset</em> for
*/
public synchronized void unset(final ClassLoader classLoader) {
diff --git a/src/main/java/org/apache/commons/beanutils/ConvertUtils.java
b/src/main/java/org/apache/commons/beanutils/ConvertUtils.java
index 16704490..10be9919 100644
--- a/src/main/java/org/apache/commons/beanutils/ConvertUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/ConvertUtils.java
@@ -112,6 +112,7 @@ public class ConvertUtils {
/**
* Gets the default value for Boolean conversions.
+ *
* @return The default Boolean value
* @deprecated Register replacement converters for Boolean.TYPE and
* Boolean.class instead
@@ -123,6 +124,7 @@ public class ConvertUtils {
/**
* Gets the default value for Byte conversions.
+ *
* @return The default Byte value
* @deprecated Register replacement converters for Byte.TYPE and
* Byte.class instead
@@ -134,6 +136,7 @@ public class ConvertUtils {
/**
* Gets the default value for Character conversions.
+ *
* @return The default Character value
* @deprecated Register replacement converters for Character.TYPE and
* Character.class instead
@@ -145,6 +148,7 @@ public class ConvertUtils {
/**
* Gets the default value for Double conversions.
+ *
* @return The default Double value
* @deprecated Register replacement converters for Double.TYPE and
* Double.class instead
@@ -156,6 +160,7 @@ public class ConvertUtils {
/**
* Get the default value for Float conversions.
+ *
* @return The default Float value
* @deprecated Register replacement converters for Float.TYPE and
* Float.class instead
@@ -167,6 +172,7 @@ public class ConvertUtils {
/**
* Gets the default value for Integer conversions.
+ *
* @return The default Integer value
* @deprecated Register replacement converters for Integer.TYPE and
* Integer.class instead
@@ -178,6 +184,7 @@ public class ConvertUtils {
/**
* Gets the default value for Long conversions.
+ *
* @return The default Long value
* @deprecated Register replacement converters for Long.TYPE and
* Long.class instead
@@ -189,6 +196,7 @@ public class ConvertUtils {
/**
* Gets the default value for Short conversions.
+ *
* @return The default Short value
* @deprecated Register replacement converters for Short.TYPE and
* Short.class instead
@@ -287,6 +295,7 @@ public class ConvertUtils {
/**
* Sets the default value for Boolean conversions.
+ *
* @param newDefaultBoolean The default Boolean value
* @deprecated Register replacement converters for Boolean.TYPE and
* Boolean.class instead
@@ -298,6 +307,7 @@ public class ConvertUtils {
/**
* Sets the default value for Byte conversions.
+ *
* @param newDefaultByte The default Byte value
* @deprecated Register replacement converters for Byte.TYPE and
* Byte.class instead
@@ -309,6 +319,7 @@ public class ConvertUtils {
/**
* Sets the default value for Character conversions.
+ *
* @param newDefaultCharacter The default Character value
* @deprecated Register replacement converters for Character.TYPE and
* Character.class instead
@@ -320,6 +331,7 @@ public class ConvertUtils {
/**
* Sets the default value for Double conversions.
+ *
* @param newDefaultDouble The default Double value
* @deprecated Register replacement converters for Double.TYPE and
* Double.class instead
@@ -331,6 +343,7 @@ public class ConvertUtils {
/**
* Sets the default value for Float conversions.
+ *
* @param newDefaultFloat The default Float value
* @deprecated Register replacement converters for Float.TYPE and
* Float.class instead
@@ -342,6 +355,7 @@ public class ConvertUtils {
/**
* Sets the default value for Integer conversions.
+ *
* @param newDefaultInteger The default Integer value
* @deprecated Register replacement converters for Integer.TYPE and
* Integer.class instead
@@ -353,6 +367,7 @@ public class ConvertUtils {
/**
* Sets the default value for Long conversions.
+ *
* @param newDefaultLong The default Long value
* @deprecated Register replacement converters for Long.TYPE and
* Long.class instead
@@ -364,6 +379,7 @@ public class ConvertUtils {
/**
* Sets the default value for Short conversions.
+ *
* @param newDefaultShort The default Short value
* @deprecated Register replacement converters for Short.TYPE and
* Short.class instead
diff --git a/src/main/java/org/apache/commons/beanutils/ConvertUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/ConvertUtilsBean.java
index 98ea649a..5360b74b 100644
--- a/src/main/java/org/apache/commons/beanutils/ConvertUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/ConvertUtilsBean.java
@@ -127,6 +127,7 @@ public class ConvertUtilsBean {
/**
* The default value for Short conversions.
+ *
* @deprecated Register replacement converters for Short.TYPE and
* Short.class instead
*/
@@ -135,6 +136,7 @@ public class ConvertUtilsBean {
/**
* Get singleton instance
+ *
* @return The singleton instance
*/
protected static ConvertUtilsBean getInstance() {
@@ -155,6 +157,7 @@ public class ConvertUtilsBean {
/**
* The default value for Boolean conversions.
+ *
* @deprecated Register replacement converters for Boolean.TYPE and
* Boolean.class instead
*/
@@ -163,6 +166,7 @@ public class ConvertUtilsBean {
/**
* The default value for Byte conversions.
+ *
* @deprecated Register replacement converters for Byte.TYPE and
* Byte.class instead
*/
@@ -171,6 +175,7 @@ public class ConvertUtilsBean {
/**
* The default value for Character conversions.
+ *
* @deprecated Register replacement converters for Character.TYPE and
* Character.class instead
*/
@@ -179,6 +184,7 @@ public class ConvertUtilsBean {
/**
* The default value for Double conversions.
+ *
* @deprecated Register replacement converters for Double.TYPE and
* Double.class instead
*/
@@ -187,6 +193,7 @@ public class ConvertUtilsBean {
/**
* The default value for Float conversions.
+ *
* @deprecated Register replacement converters for Float.TYPE and
* Float.class instead
*/
@@ -195,6 +202,7 @@ public class ConvertUtilsBean {
/**
* The default value for Integer conversions.
+ *
* @deprecated Register replacement converters for Integer.TYPE and
* Integer.class instead
*/
@@ -203,6 +211,7 @@ public class ConvertUtilsBean {
/**
* The default value for Long conversions.
+ *
* @deprecated Register replacement converters for Long.TYPE and
* Long.class instead
*/
@@ -397,6 +406,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Boolean conversions.
+ *
* @return The default Boolean value
* @deprecated Register replacement converters for Boolean.TYPE and
* Boolean.class instead
@@ -408,6 +418,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Byte conversions.
+ *
* @return The default Byte value
* @deprecated Register replacement converters for Byte.TYPE and
* Byte.class instead
@@ -419,6 +430,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Character conversions.
+ *
* @return The default Character value
* @deprecated Register replacement converters for Character.TYPE and
* Character.class instead
@@ -430,6 +442,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Double conversions.
+ *
* @return The default Double value
* @deprecated Register replacement converters for Double.TYPE and
* Double.class instead
@@ -441,6 +454,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Float conversions.
+ *
* @return The default Float value
* @deprecated Register replacement converters for Float.TYPE and
* Float.class instead
@@ -452,6 +466,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Integer conversions.
+ *
* @return The default Integer value
* @deprecated Register replacement converters for Integer.TYPE and
* Integer.class instead
@@ -463,6 +478,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Long conversions.
+ *
* @return The default Long value
* @deprecated Register replacement converters for Long.TYPE and
* Long.class instead
@@ -474,6 +490,7 @@ public class ConvertUtilsBean {
/**
* Gets the default value for Short conversions.
+ *
* @return The default Short value
* @deprecated Register replacement converters for Short.TYPE and
* Short.class instead
@@ -669,6 +686,7 @@ public class ConvertUtilsBean {
* <li>{@code java.sql.Timestamp.class} - {@link
SqlTimestampConverter}</li>
* <li>{@code URL.class} - {@link URLConverter}</li>
* </ul>
+ *
* @param throwException {@code true} if the converters should
* throw an exception when a conversion error occurs, otherwise <code>
* {@code false} if a default value should be used.
@@ -698,6 +716,7 @@ public class ConvertUtilsBean {
* <li>{@code Long.TYPE} - {@link LongConverter}</li>
* <li>{@code Short.TYPE} - {@link ShortConverter}</li>
* </ul>
+ *
* @param throwException {@code true} if the converters should
* throw an exception when a conversion error occurs, otherwise <code>
* {@code false} if a default value should be used.
@@ -730,6 +749,7 @@ public class ConvertUtilsBean {
* <li>{@code Short.class} - {@link ShortConverter}</li>
* <li>{@code String.class} - {@link StringConverter}</li>
* </ul>
+ *
* @param throwException {@code true} if the converters should
* throw an exception when a conversion error occurs, otherwise <code>
* {@code false} if a default value should be used.
@@ -763,6 +783,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Boolean conversions.
+ *
* @param newDefaultBoolean The default Boolean value
* @deprecated Register replacement converters for Boolean.TYPE and
* Boolean.class instead
@@ -776,6 +797,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Byte conversions.
+ *
* @param newDefaultByte The default Byte value
* @deprecated Register replacement converters for Byte.TYPE and
* Byte.class instead
@@ -789,6 +811,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Character conversions.
+ *
* @param newDefaultCharacter The default Character value
* @deprecated Register replacement converters for Character.TYPE and
* Character.class instead
@@ -804,6 +827,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Double conversions.
+ *
* @param newDefaultDouble The default Double value
* @deprecated Register replacement converters for Double.TYPE and
* Double.class instead
@@ -817,6 +841,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Float conversions.
+ *
* @param newDefaultFloat The default Float value
* @deprecated Register replacement converters for Float.TYPE and
* Float.class instead
@@ -830,6 +855,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Integer conversions.
+ *
* @param newDefaultInteger The default Integer value
* @deprecated Register replacement converters for Integer.TYPE and
* Integer.class instead
@@ -843,6 +869,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Long conversions.
+ *
* @param newDefaultLong The default Long value
* @deprecated Register replacement converters for Long.TYPE and
* Long.class instead
@@ -856,6 +883,7 @@ public class ConvertUtilsBean {
/**
* Sets the default value for Short conversions.
+ *
* @param newDefaultShort The default Short value
* @deprecated Register replacement converters for Short.TYPE and
* Short.class instead
diff --git a/src/main/java/org/apache/commons/beanutils/DynaProperty.java
b/src/main/java/org/apache/commons/beanutils/DynaProperty.java
index 845942e1..701e245c 100644
--- a/src/main/java/org/apache/commons/beanutils/DynaProperty.java
+++ b/src/main/java/org/apache/commons/beanutils/DynaProperty.java
@@ -110,6 +110,7 @@ public class DynaProperty implements Serializable {
/**
* Checks this instance against the specified Object for equality.
Overrides the
* default refererence test for equality provided by {@link
Object#equals(Object)}
+ *
* @param obj The object to compare to
* @return {@code true} if object is a dyna property with the same name
* type and content type, otherwise {@code false}
@@ -149,6 +150,7 @@ public class DynaProperty implements Serializable {
}
/**
* Get the name of this property.
+ *
* @return the name of the property
*/
public String getName() {
diff --git a/src/main/java/org/apache/commons/beanutils/LazyDynaBean.java
b/src/main/java/org/apache/commons/beanutils/LazyDynaBean.java
index 039cc573..52441312 100644
--- a/src/main/java/org/apache/commons/beanutils/LazyDynaBean.java
+++ b/src/main/java/org/apache/commons/beanutils/LazyDynaBean.java
@@ -225,6 +225,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of a 'DynaBean' Property.
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -244,6 +245,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of an 'Indexed' Property
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -286,6 +288,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of a 'Mapped' Property
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -320,6 +323,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of a {@code java.lang.Number} Property.
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -332,6 +336,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of other Property types
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -361,6 +366,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of a 'Primitive' Property.
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -395,6 +401,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Create a new Instance of a Property
+ *
* @param name The name of the property
* @param type The class of the property
* @return The new value
@@ -690,6 +697,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* Indicates if there is a property with the specified name.
+ *
* @param name The name of the property to check
* @return {@code true} if there is a property of the
* specified name, otherwise {@code false}
@@ -722,6 +730,7 @@ protected static final BigInteger BigInteger_ZERO = new
BigInteger("0");
/**
* <p>Creates a new instance of the {@code Map}.</p>
+ *
* @return a new Map instance
*/
protected Map<String, Object> newMap() {
diff --git a/src/main/java/org/apache/commons/beanutils/LazyDynaClass.java
b/src/main/java/org/apache/commons/beanutils/LazyDynaClass.java
index 255a4e19..b0e0d09c 100644
--- a/src/main/java/org/apache/commons/beanutils/LazyDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/LazyDynaClass.java
@@ -268,6 +268,7 @@ public class LazyDynaClass extends BasicDynaClass
implements MutableDynaClass {
* <p>Is this DynaClass currently restricted.</p>
* <p>If restricted, no changes to the existing registration of
* property names, data types, readability, or writeability are
allowed.</p>
+ *
* @return {@code true} if this {@link MutableDynaClass} cannot be changed
* otherwise {@code false}
*/
@@ -337,6 +338,7 @@ public class LazyDynaClass extends BasicDynaClass
implements MutableDynaClass {
* <p>Set whether this DynaClass is currently restricted.</p>
* <p>If restricted, no changes to the existing registration of
* property names, data types, readability, or writeability are
allowed.</p>
+ *
* @param restricted {@code true} if this {@link MutableDynaClass} cannot
* be changed otherwise {@code false}
*/
@@ -349,6 +351,7 @@ public class LazyDynaClass extends BasicDynaClass
implements MutableDynaClass {
* Set whether this DynaClass should return a {@code null} from
* the {@code getDynaProperty(name)} method if the property
* doesn't exist.
+ *
* @param returnNull {@code true} if a {@code null} {@link DynaProperty}
* should be returned if the property doesn't exist, otherwise
* {@code false} if a new {@link DynaProperty} should be created.
diff --git a/src/main/java/org/apache/commons/beanutils/LazyDynaMap.java
b/src/main/java/org/apache/commons/beanutils/LazyDynaMap.java
index 3cd1a95f..7febabfb 100644
--- a/src/main/java/org/apache/commons/beanutils/LazyDynaMap.java
+++ b/src/main/java/org/apache/commons/beanutils/LazyDynaMap.java
@@ -225,6 +225,7 @@ public class LazyDynaMap extends LazyDynaBean implements
MutableDynaClass {
* <p><strong>FIXME</strong> - Should we really be implementing
* {@code getBeanInfo()} instead, which returns property descriptors
* and a bunch of other stuff?</p>
+ *
* @return the set of properties for this DynaClass
*/
@Override
@@ -289,6 +290,7 @@ public class LazyDynaMap extends LazyDynaBean implements
MutableDynaClass {
/**
* Return the underlying Map backing this {@code DynaBean}
+ *
* @return the underlying Map
* @since 1.8.0
*/
@@ -361,6 +363,7 @@ public class LazyDynaMap extends LazyDynaBean implements
MutableDynaClass {
/**
* Instantiate and return a new DynaBean instance, associated
* with this DynaClass.
+ *
* @return A new {@code DynaBean} instance
*/
@Override
diff --git
a/src/main/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
b/src/main/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
index f27aaeb1..26222ea4 100644
--- a/src/main/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
+++ b/src/main/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
@@ -37,6 +37,7 @@ import java.util.Objects;
* <p>{@code set<strong>Property</strong>(String key, Object value)},
* <p>where {@code <strong>Property</strong>} must be replaced
* by the name of the property.
+ *
* @see java.beans.PropertyDescriptor
*
*/
diff --git a/src/main/java/org/apache/commons/beanutils/MethodUtils.java
b/src/main/java/org/apache/commons/beanutils/MethodUtils.java
index d9de0d51..4a25d929 100644
--- a/src/main/java/org/apache/commons/beanutils/MethodUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/MethodUtils.java
@@ -85,6 +85,7 @@ public class MethodUtils {
}
/**
* Checks for equality.
+ *
* @param obj object to be tested for equality
* @return true, if the object describes the same Method.
*/
@@ -105,6 +106,7 @@ public class MethodUtils {
* hashcodes are different, the objects are different. If the
* hashcodes are the same, need to use the equals method to
* determine equality.
+ *
* @return the string length of method name.
*/
@Override
@@ -169,6 +171,7 @@ public class MethodUtils {
/**
* Clear the method cache.
+ *
* @return the number of cached methods cleared
* @since 1.8.0
*/
@@ -535,6 +538,7 @@ public class MethodUtils {
* Gets the number of steps required needed to turn the source class into
the
* destination class. This represents the number of steps in the object
hierarchy
* graph.
+ *
* @param srcClass The source class
* @param destClass The destination class
* @return The cost of transforming an object
@@ -575,6 +579,7 @@ public class MethodUtils {
/**
* Gets the class for the primitive type corresponding to the primitive
wrapper class given.
* For example, an instance of {@code Boolean.class} returns a {@code
boolean.class}.
+ *
* @param wrapperType the
* @return the primitive type class corresponding to the given wrapper
class,
* null if no match is found
@@ -615,6 +620,7 @@ public class MethodUtils {
/**
* Gets the wrapper object class for the given primitive type class.
* For example, passing {@code boolean.class} returns {@code Boolean.class}
+ *
* @param primitiveType the primitive type class for which a match is to
be found
* @return the wrapper type associated with the given primitive
* or null if no match is found
@@ -651,6 +657,7 @@ public class MethodUtils {
/**
* Returns the sum of the object transformation cost for each class in the
source
* argument list.
+ *
* @param srcArgs The source arguments
* @param destArgs The destination arguments
* @return The total transformation cost
@@ -1243,6 +1250,7 @@ public class MethodUtils {
/**
* Try to make the method accessible
+ *
* @param method The source arguments
*/
private static void setMethodAccessible(final Method method) {
diff --git a/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
b/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
index 09ce56d2..ff3eac89 100644
--- a/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
@@ -184,6 +184,7 @@ public class PropertyUtils {
/**
* The {@code debug} static property is no longer used
+ *
* @return debug property
* @deprecated The {@code debug} static property is no longer used
*/
@@ -656,6 +657,7 @@ public class PropertyUtils {
/**
* The {@code debug} static property is no longer used
+ *
* @param newDebug debug property
* @deprecated The {@code debug} static property is no longer used
*/
diff --git a/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
index 90db37e6..3c6b4bfb 100644
--- a/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
@@ -97,6 +97,7 @@ public class PropertyUtilsBean {
/**
* Return the PropertyUtils bean instance.
+ *
* @return The PropertyUtils bean instance
*/
protected static PropertyUtilsBean getInstance() {
diff --git a/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
b/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
index a240a5b3..66d7ee0e 100644
--- a/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/ResultSetDynaClass.java
@@ -188,6 +188,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
* each row of the wrapped {@code ResultSet}, in "forward" order.
* Unless the underlying result set supports scrolling, this method
* should be called only once.</p>
+ *
* @return An {@code Iterator} of {@link DynaBean} instances
*/
public Iterator<DynaBean> iterator() {
@@ -202,6 +203,7 @@ public class ResultSetDynaClass extends JDBCDynaClass {
* Dervations of this class could implement alternative class loading
policies such as
* using custom ClassLoader or using the Threads's context class loader
etc.
* </p>
+ *
* @param className The name of the class to load
* @return The loaded class
* @throws SQLException if the class cannot be loaded
diff --git a/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
b/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
index b1a32ae0..cc94beed 100644
--- a/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
+++ b/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
@@ -488,6 +488,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Return a collection view of the mappings contained in this map. Each
* element in the returned collection is a {@code Map.Entry}.
+ *
* @return the set of map Map entries
*/
@Override
@@ -627,6 +628,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Return a set view of the keys contained in this map.
+ *
* @return the set of the Map's keys
*/
@Override
@@ -729,6 +731,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Return a collection view of the values contained in this map.
+ *
* @return the set of the Map's values
*/
@Override
diff --git a/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
b/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
index 9fdbdc64..02611b7e 100644
--- a/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
+++ b/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
@@ -197,6 +197,7 @@ public class WrapDynaBean implements DynaBean, Serializable
{
/**
* Return the {@code DynaClass} instance that describes the set of
* properties available for this DynaBean.
+ *
* @return The associated DynaClass
*/
@Override
diff --git a/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
b/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
index 7b467a0b..b8439e18 100644
--- a/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
@@ -228,6 +228,7 @@ public class WrapDynaClass implements DynaClass {
* {@code PropertyUtilsBean} instance can be hooked into the introspection
* mechanism of the managed bean. The argument is optional; if no
* {@code PropertyUtilsBean} object is provided, the default instance is
used.
+ *
* @param beanClass Bean class for which a WrapDynaClass is requested
* @param pu the optional {@code PropertyUtilsBean} to be used for
introspection
* @return A new <em>Wrap</em> {@link DynaClass}
@@ -248,6 +249,7 @@ public class WrapDynaClass implements DynaClass {
* Returns the cache for the already created class instances. For each
* combination of bean class and {@code PropertyUtilsBean} instance an
* entry is created in the cache.
+ *
* @return the cache for already created {@code WrapDynaClass} instances
*/
private static Map<CacheKey, WrapDynaClass> getClassesCache() {
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/AbstractArrayConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/AbstractArrayConverter.java
index 078dc7c7..dfedb841 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/AbstractArrayConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/AbstractArrayConverter.java
@@ -53,6 +53,7 @@ public abstract class AbstractArrayConverter implements
Converter {
* to the constructor to indicate that no default is desired. Note that
* the value 'null' cannot be used for this purpose, as the caller may
* want a null to be returned as the default.
+ *
* @since 1.8.0
*/
public static final Object NO_DEFAULT = new Object();
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
index 313ffaa1..fe2031a5 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
@@ -255,6 +255,7 @@ public abstract class AbstractConverter implements
Converter {
/**
* Return the default value for conversions to the specified
* type.
+ *
* @param type Data type to which this value should be converted.
* @return The default value for the specified type.
*/
@@ -430,6 +431,7 @@ public abstract class AbstractConverter implements
Converter {
/**
* Provide a String representation of a {@code java.lang.Class}.
+ *
* @param type The {@code java.lang.Class}.
* @return The String representation.
*/
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/ArrayConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/ArrayConverter.java
index da359701..92c8ac02 100644
--- a/src/main/java/org/apache/commons/beanutils/converters/ArrayConverter.java
+++ b/src/main/java/org/apache/commons/beanutils/converters/ArrayConverter.java
@@ -330,6 +330,7 @@ public class ArrayConverter extends AbstractConverter {
/**
* Return the default value for conversions to the specified
* type.
+ *
* @param type Data type to which this value should be converted.
* @return The default value for the specified type.
*/
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/BooleanArrayConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/BooleanArrayConverter.java
index 112c110e..a86582d0 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/BooleanArrayConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/BooleanArrayConverter.java
@@ -42,6 +42,7 @@ public final class BooleanArrayConverter extends
AbstractArrayConverter {
/**
* Type which this class converts its input to. This value can be
* used as a parameter to the ConvertUtils.register method.
+ *
* @since 1.8.0
*/
public static final Class MODEL = new boolean[0].getClass();
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/BooleanConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/BooleanConverter.java
index e0d91291..be395951 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/BooleanConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/BooleanConverter.java
@@ -57,6 +57,7 @@ public final class BooleanConverter extends AbstractConverter
{
* to the constructor to indicate that no default is desired. Note that
* the value 'null' cannot be used for this purpose, as the caller may
* want a null to be returned as the default.
+ *
* @deprecated Use constructors without default value.
*/
@Deprecated
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 0c41fc40..d89c6872 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/DateTimeConverter.java
@@ -248,6 +248,7 @@ public abstract class DateTimeConverter extends
AbstractConverter {
/**
* Return a {@code DateFormat} for the Locale.
+ *
* @param locale The Locale to create the Format with (may be null)
* @param timeZone The Time Zone create the Format with (may be null)
* @return A Date Format.
@@ -313,6 +314,7 @@ public abstract class DateTimeConverter extends
AbstractConverter {
/**
* Log the <code>DateFormat<code> creation.
+ *
* @param action The action the format is being used for
* @param format The Date format
*/
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
index ac154bb0..b9001fc6 100644
--- a/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
+++ b/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
@@ -277,6 +277,7 @@ public abstract class NumberConverter extends
AbstractConverter {
/**
* Convert a String into a {@code Number} object.
+ *
* @param sourceType the source type of the conversion
* @param targetType The type to convert the value to
* @param value The String date value.
@@ -352,6 +353,7 @@ public abstract class NumberConverter extends
AbstractConverter {
* <li>{@code java.math.BigDecimal}</li>
* <li>{@code java.math.BigInteger}</li>
* </ul>
+ *
* @param sourceType The type being converted from
* @param targetType The Number type to convert to
* @param value The String value to convert.
@@ -422,6 +424,7 @@ public abstract class NumberConverter extends
AbstractConverter {
* <li>{@code java.math.BigDecimal}</li>
* <li>{@code java.math.BigInteger}</li>
* </ul>
+ *
* @param sourceType The type being converted from
* @param targetType The Number type to convert to
* @param value The Number to convert.
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/SqlTimeConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/SqlTimeConverter.java
index 12b2a5bd..7b178a7b 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/SqlTimeConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/SqlTimeConverter.java
@@ -69,6 +69,7 @@ public final class SqlTimeConverter extends DateTimeConverter
{
/**
* Return a {@code DateFormat} for the Locale.
+ *
* @param locale TODO
* @param timeZone TODO
* @return The DateFormat.
diff --git
a/src/main/java/org/apache/commons/beanutils/converters/SqlTimestampConverter.java
b/src/main/java/org/apache/commons/beanutils/converters/SqlTimestampConverter.java
index 2451eae7..1253be50 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/SqlTimestampConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/SqlTimestampConverter.java
@@ -69,6 +69,7 @@ public final class SqlTimestampConverter extends
DateTimeConverter {
/**
* Return a {@code DateFormat} for the Locale.
+ *
* @param locale TODO
* @param timeZone TODO
* @return The DateFormat.
diff --git
a/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
index 02103940..938948f1 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
@@ -450,6 +450,7 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean {
/**
* Gets the default Locale
+ *
* @return the default locale
*/
public Locale getDefaultLocale() {
diff --git
a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
index 2fffc104..fdf870fa 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
@@ -252,6 +252,7 @@ public class LocaleConvertUtils {
* no {@code Locale} is passed to a method.</p>
*
* <p>For more details see {@code LocaleConvertUtilsBean}</p>
+ *
* @return the default locale
* @see LocaleConvertUtilsBean#getDefaultLocale()
*/
diff --git
a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
index 82d07bba..ce1d3404 100644
---
a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
+++
b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
@@ -171,6 +171,7 @@ public class LocaleConvertUtilsBean {
/**
* Gets singleton instance.
* This is the same as the instance used by the default {@link
LocaleBeanUtilsBean} singleton.
+ *
* @return the singleton instance
*/
public static LocaleConvertUtilsBean getInstance() {
@@ -469,6 +470,7 @@ public void deregister() {
/**
* getter for defaultLocale.
+ *
* @return the default locale
*/
public Locale getDefaultLocale() {
@@ -550,6 +552,7 @@ public void deregister() {
/**
* setter for defaultLocale.
+ *
* @param locale the default locale
*/
public void setDefaultLocale(final Locale locale) {
