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 9f8b6c0f Javadoc
9f8b6c0f is described below
commit 9f8b6c0fc054f6144fd6afc37e3bc85ddeaa9978
Author: Gary Gregory <[email protected]>
AuthorDate: Sat Jul 11 11:21:41 2026 -0400
Javadoc
---
.../beanutils/BaseDynaBeanMapDecorator.java | 2 +-
.../beanutils/BeanAccessLanguageException.java | 2 +-
.../apache/commons/beanutils/BeanComparator.java | 4 +-
.../commons/beanutils/BeanIntrospectionData.java | 14 +++---
.../apache/commons/beanutils/BeanIntrospector.java | 2 +-
.../java/org/apache/commons/beanutils/BeanMap.java | 54 +++++++++++-----------
.../apache/commons/beanutils/BeanPredicate.java | 6 +--
.../apache/commons/beanutils/BeanUtilsBean.java | 8 ++--
.../apache/commons/beanutils/ConstructorUtils.java | 22 ++++-----
.../commons/beanutils/ContextClassLoaderLocal.java | 2 +-
.../commons/beanutils/DefaultBeanIntrospector.java | 6 +--
.../beanutils/DefaultIntrospectionContext.java | 2 +-
.../org/apache/commons/beanutils/DynaProperty.java | 2 +-
.../beanutils/FluentPropertyBeanIntrospector.java | 10 ++--
.../commons/beanutils/IntrospectionContext.java | 10 ++--
.../org/apache/commons/beanutils/LazyDynaList.java | 4 +-
.../org/apache/commons/beanutils/MethodUtils.java | 16 +++----
.../commons/beanutils/NestedNullException.java | 2 +-
.../apache/commons/beanutils/PropertyUtils.java | 4 +-
.../commons/beanutils/PropertyUtilsBean.java | 14 +++---
.../SuppressPropertiesBeanIntrospector.java | 2 +-
.../apache/commons/beanutils/WeakFastHashMap.java | 24 +++++-----
.../org/apache/commons/beanutils/WrapDynaBean.java | 2 +-
.../apache/commons/beanutils/WrapDynaClass.java | 8 ++--
.../beanutils/converters/AbstractConverter.java | 8 ++--
.../beanutils/converters/NumberConverter.java | 2 +-
.../beanutils/locale/BaseLocaleConverter.java | 6 +--
.../commons/beanutils/locale/LocaleBeanUtils.java | 2 +-
.../beanutils/locale/LocaleBeanUtilsBean.java | 4 +-
.../beanutils/locale/LocaleConvertUtils.java | 2 +-
.../beanutils/locale/LocaleConvertUtilsBean.java | 2 +-
.../beanutils/BeanIntrospectionDataTest.java | 2 +-
.../beanutils/DefaultIntrospectionContextTest.java | 2 +-
.../FluentPropertyBeanIntrospectorTest.java | 6 +--
.../commons/beanutils/PropertyUtilsTest.java | 2 +-
.../apache/commons/beanutils/TestResultSet.java | 2 +-
.../commons/beanutils/TestResultSetMetaData.java | 2 +-
.../apache/commons/beanutils/bugs/Jira339Test.java | 2 +-
.../apache/commons/beanutils/bugs/Jira458Test.java | 2 +-
.../apache/commons/beanutils/bugs/Jira465Test.java | 2 +-
.../memoryleaktests/pojotests/CustomInteger.java | 2 +-
41 files changed, 136 insertions(+), 136 deletions(-)
diff --git
a/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
b/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
index db6501d8..f7631252 100644
--- a/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
+++ b/src/main/java/org/apache/commons/beanutils/BaseDynaBeanMapDecorator.java
@@ -173,7 +173,7 @@ public abstract class BaseDynaBeanMapDecorator<K>
implements Map<K, Object> {
/**
* Converts the name of a property to the key type of this decorator.
*
- * @param propertyName the name of a property
+ * @param propertyName The name of a property
* @return The converted key to be used in the decorated map
*/
protected abstract K convertKey(String propertyName);
diff --git
a/src/main/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
b/src/main/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
index 5cdc06bb..d582261b 100644
---
a/src/main/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
+++
b/src/main/java/org/apache/commons/beanutils/BeanAccessLanguageException.java
@@ -38,7 +38,7 @@ public class BeanAccessLanguageException extends
IllegalArgumentException {
/**
* Constructs a {@code BeanAccessLanguageException} without a detail
message.
*
- * @param message the detail message explaining this exception
+ * @param message The detail message explaining this exception
*/
public BeanAccessLanguageException(final String message) {
super(message);
diff --git a/src/main/java/org/apache/commons/beanutils/BeanComparator.java
b/src/main/java/org/apache/commons/beanutils/BeanComparator.java
index c54dea79..55c73bce 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanComparator.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanComparator.java
@@ -209,8 +209,8 @@ public class BeanComparator<T> implements Comparator<T>,
Serializable {
* <em>Note</em>: This comparison cannot be performed in a type-safe way;
so
* {@code ClassCastException} exceptions may be thrown.
*
- * @param val1 the first value to be compared
- * @param val2 the second value to be compared
+ * @param val1 The first value to be compared
+ * @param val2 The second value to be compared
* @return The result of the comparison
*/
private int internalCompare(final Object val1, final Object val2) {
diff --git
a/src/main/java/org/apache/commons/beanutils/BeanIntrospectionData.java
b/src/main/java/org/apache/commons/beanutils/BeanIntrospectionData.java
index e71399a0..9dfc920a 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanIntrospectionData.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanIntrospectionData.java
@@ -49,7 +49,7 @@ class BeanIntrospectionData {
* they may get lost when the GC claims soft references used by the
* {@code PropertyDescriptor} objects.
*
- * @param descs the array with the descriptors of the available properties
+ * @param descs The array with the descriptors of the available properties
* @return The map with the names of write methods for properties
*/
private static Map<String, String> setUpWriteMethodNames(final
PropertyDescriptor[] descs) {
@@ -73,7 +73,7 @@ class BeanIntrospectionData {
* Creates a new instance of {@code BeanIntrospectionData} and initializes
its
* completely.
*
- * @param descs the array with the descriptors of the available properties
+ * @param descs The array with the descriptors of the available properties
*/
public BeanIntrospectionData(final PropertyDescriptor[] descs) {
this(descs, setUpWriteMethodNames(descs));
@@ -83,8 +83,8 @@ class BeanIntrospectionData {
* Creates a new instance of {@code BeanIntrospectionData} and allows
setting the map
* with write method names. This constructor is mainly used for testing
purposes.
*
- * @param descs the array with the descriptors of the available properties
- * @param writeMethNames the map with the names of write methods
+ * @param descs The array with the descriptors of the available properties
+ * @param writeMethNames The map with the names of write methods
*/
BeanIntrospectionData(final PropertyDescriptor[] descs, final Map<String,
String> writeMethNames) {
descriptors = descs;
@@ -95,7 +95,7 @@ class BeanIntrospectionData {
* Returns the {@code PropertyDescriptor} for the property with the
specified name. If
* this property is unknown, result is {@code null}.
*
- * @param name the name of the property in question
+ * @param name The name of the property in question
* @return The {@code PropertyDescriptor} for this property or {@code null}
*/
public PropertyDescriptor getDescriptor(final String name) {
@@ -125,8 +125,8 @@ class BeanIntrospectionData {
* additional information stored in this object is necessary to obtain the
method
* again.
*
- * @param beanCls the class of the affected bean
- * @param desc the {@code PropertyDescriptor} of the desired property
+ * @param beanCls The class of the affected bean
+ * @param desc The {@code PropertyDescriptor} of the desired property
* @return The write method for this property or {@code null} if there is
none
*/
public Method getWriteMethod(final Class<?> beanCls, final
PropertyDescriptor desc) {
diff --git a/src/main/java/org/apache/commons/beanutils/BeanIntrospector.java
b/src/main/java/org/apache/commons/beanutils/BeanIntrospector.java
index 825d5a18..cb923aca 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanIntrospector.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanIntrospector.java
@@ -44,7 +44,7 @@ public interface BeanIntrospector {
* properties according to the rules it implements, and add them to the
* passed in context object.
*
- * @param icontext the context object for interaction with the initiator of
+ * @param icontext The context object for interaction with the initiator of
* the introspection request
* @throws IntrospectionException if an error occurs during introspection
*/
diff --git a/src/main/java/org/apache/commons/beanutils/BeanMap.java
b/src/main/java/org/apache/commons/beanutils/BeanMap.java
index b03974e5..1cf2cb25 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanMap.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanMap.java
@@ -53,9 +53,9 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Constructs a new {@code Entry}.
*
- * @param owner the BeanMap this entry belongs to
- * @param key the key for this entry
- * @param value the value for this entry
+ * @param owner The BeanMap this entry belongs to
+ * @param key The key for this entry
+ * @param value The value for this entry
*/
protected Entry(final BeanMap owner, final Object key, final Object
value) {
super(key, value);
@@ -65,7 +65,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Sets the value.
*
- * @param value the new value for the entry
+ * @param value The new value for the entry
* @return The old value for the entry
*/
@Override
@@ -197,7 +197,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Constructs a new {@code BeanMap} that operates on the specified bean.
If the given bean is {@code null}, then this map will be empty.
*
- * @param bean the bean for this map to operate on
+ * @param bean The bean for this map to operate on
*/
public BeanMap(final Object bean) {
this.bean = bean;
@@ -287,7 +287,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
* <p>
* Write-only properties will not be matched as the test operates against
property read methods.
*
- * @param name the name of the property to check
+ * @param name The name of the property to check
* @return false if the given name is null or is not a {@code String};
false if the bean does not define a property with that name; or true if the bean
* does define a property with that name
*/
@@ -300,7 +300,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns true if the bean defines a property whose current value is the
given object.
*
- * @param value the value to check
+ * @param value The value to check
* @return false true if the bean has at least one property whose current
value is that object, false otherwise
*/
@Override
@@ -322,8 +322,8 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
* If no special constructor exists and the given type is not a primitive
type, this method returns the original value.
* </p>
*
- * @param newType the type to convert the value to
- * @param value the value to convert
+ * @param newType The type to convert the value to
+ * @param value The value to convert
* @return The converted value
* @throws NumberFormatException if newType is a primitive type, and
the string representation of the given value cannot be converted to that type
* @throws InstantiationException if the constructor found with
reflection raises it
@@ -354,8 +354,8 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
* Creates an array of parameters to pass to the given mutator method. If
the given object is not the right type to pass to the method directly, it will
be
* converted using {@link #convertType(Class,Object)}.
*
- * @param method the mutator method
- * @param value the value to pass to the mutator method
+ * @param method The mutator method
+ * @param value The value to pass to the mutator method
* @return An array containing one object that is either the given value
or a transformed value
* @throws IllegalAccessException if {@link #convertType(Class,Object)}
raises it
* @throws IllegalArgumentException if any other exception is raised by
{@link #convertType(Class,Object)}
@@ -436,9 +436,9 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
* Called during a successful {@link #put(Object,Object)} operation.
Default implementation does nothing. Override to be notified of property
changes in the
* bean caused by this map.
*
- * @param key the name of the property that changed
- * @param oldValue the old value for that property
- * @param newValue the new value for that property
+ * @param key The name of the property that changed
+ * @param oldValue The old value for that property
+ * @param newValue The new value for that property
*/
protected void firePropertyChange(final Object key, final Object oldValue,
final Object newValue) {
}
@@ -451,7 +451,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
* <p>
* Write-only properties will not be matched as the test operates against
property read methods.
*
- * @param name the name of the property whose value to return
+ * @param name The name of the property whose value to return
* @return The value of the property with that name
*/
@Override
@@ -483,7 +483,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns the accessor for the property with the given name.
*
- * @param name the name of the property
+ * @param name The name of the property
* @return null if the name is null; null if the name is not a {@link
String}; null if no such property exists; or the accessor method for that
property
*/
protected Method getReadMethod(final Object name) {
@@ -493,7 +493,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns the accessor for the property with the given name.
*
- * @param name the name of the property
+ * @param name The name of the property
* @return The accessor method for the property, or null
*/
public Method getReadMethod(final String name) {
@@ -503,7 +503,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns the type of the property with the given name.
*
- * @param name the name of the property
+ * @param name The name of the property
* @return The type of the property, or {@code null} if no such property
exists
*/
public Class<?> getType(final String name) {
@@ -513,7 +513,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns a transformer for the given primitive type.
*
- * @param aType the primitive type whose transformer to return
+ * @param aType The primitive type whose transformer to return
* @return A transformer that will convert strings into that type, or null
if the given type is not a primitive type
*/
protected Transformer getTypeTransformer(final Class<?> aType) {
@@ -525,7 +525,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns the mutator for the property with the given name.
*
- * @param name the name of the
+ * @param name The name of the
* @return null if the name is null; null if the name is not a {@link
String}; null if no such property exists; null if the property is read-only; or
the
* mutator method for that property
*/
@@ -536,7 +536,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Returns the mutator for the property with the given name.
*
- * @param name the name of the property
+ * @param name The name of the property
* @return The mutator method for the property, or null
*/
public Method getWriteMethod(final String name) {
@@ -608,7 +608,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Logs the given exception to {@code System.out}. Used to display
warnings while accessing/mutating the bean.
*
- * @param ex the exception to log
+ * @param ex The exception to log
*/
protected void logInfo(final Exception ex) {
// Deliberately do not use LOG4J or Commons Logging to avoid
dependencies
@@ -618,7 +618,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Logs the given exception to {@code System.err}. Used to display errors
while accessing/mutating the bean.
*
- * @param ex the exception to log
+ * @param ex The exception to log
*/
protected void logWarn(final Exception ex) {
// Deliberately do not use LOG4J or Commons Logging to avoid
dependencies
@@ -629,8 +629,8 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Sets the bean property with the given name to the given value.
*
- * @param name the name of the property to set
- * @param value the value to set that property to
+ * @param name The name of the property to set
+ * @param value The value to set that property to
* @return The previous value of that property
* @throws IllegalArgumentException if the given name is null; if the
given name is not a {@link String}; if the bean doesn't define a property with
that
* name; or if the bean property with
that name is read-only
@@ -661,7 +661,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Puts all of the writable properties from the given BeanMap into this
BeanMap. Read-only and Write-only properties will be ignored.
*
- * @param map the BeanMap whose properties to put
+ * @param map The BeanMap whose properties to put
*/
public void putAllWriteable(final BeanMap map) {
for (final Object key : map.readMethods.keySet()) {
@@ -686,7 +686,7 @@ public class BeanMap extends AbstractMap<Object, Object>
implements Cloneable {
/**
* Sets the bean to be operated on by this map. The given value may be
null, in which case this map will be empty.
*
- * @param newBean the new bean to operate on
+ * @param newBean The new bean to operate on
*/
public void setBean(final Object newBean) {
bean = newBean;
diff --git a/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
b/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
index ab485071..312b789f 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanPredicate.java
@@ -43,9 +43,9 @@ 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,
+ * @param propertyName The name of the property whose value is to be
predicated,
* not null
- * @param predicate the {@code Predicate} to be applied,
+ * @param predicate The {@code Predicate} to be applied,
* not null
*/
public BeanPredicate(final String propertyName, final Predicate predicate)
{
@@ -123,7 +123,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,
+ * @param propertyName The name of the property whose value is to be
predicated,
* not null
*/
public void setPropertyName(final String propertyName) {
diff --git a/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
index 1ea689d8..8c42146b 100644
--- a/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/BeanUtilsBean.java
@@ -60,8 +60,8 @@ public class BeanUtilsBean {
* Determines the type of a {@code DynaProperty}. Here a special treatment
* is needed for mapped properties.
*
- * @param dynaProperty the property descriptor
- * @param value the value object to be set for this property
+ * @param dynaProperty The property descriptor
+ * @param value The value object to be set for this property
* @return The type of this property
*/
private static Class<?> dynaPropertyType(final DynaProperty dynaProperty,
@@ -198,8 +198,8 @@ public class BeanUtilsBean {
* bean. This method delegates to {@link #convert(Object, Class)}, but
{@code null}
* values are not converted. This causes {@code null} values to be copied
verbatim.
*
- * @param value the value to be converted and copied
- * @param type the target type of the conversion
+ * @param value The value to be converted and copied
+ * @param type The target type of the conversion
* @return The converted value
*/
private Object convertForCopy(final Object value, final Class<?> type) {
diff --git a/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
b/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
index c2de3f20..004ee666 100644
--- a/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/ConstructorUtils.java
@@ -53,7 +53,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 klass The class to be constructed
* @param parameterType The constructor parameter type
* @return null if matching accessible constructor cannot be found.
* @see Class#getConstructor
@@ -71,8 +71,8 @@ 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
+ * @param klass The class to be constructed
+ * @param parameterTypes The parameter array
* @return null if matching accessible constructor cannot be found
* @see Class#getConstructor
* @see #getAccessibleConstructor(java.lang.reflect.Constructor)
@@ -216,8 +216,8 @@ public class ConstructorUtils {
* <p>The signatures should be assignment compatible.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
- * @param arg the actual argument. May be null (this will result in
calling the default constructor).
+ * @param klass The class to be constructed.
+ * @param arg The actual argument. May be null (this will result in
calling the default constructor).
* @return new instance of {@code klazz}
* @throws NoSuchMethodException If the constructor cannot be found
* @throws IllegalAccessException If an error occurs accessing the
constructor
@@ -244,7 +244,7 @@ public class ConstructorUtils {
* <p>The signatures should be assignment compatible.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
+ * @param klass The class to be constructed.
* @param args actual argument array. May be null (this will result in
calling the default constructor).
* @return new instance of {@code klazz}
* @throws NoSuchMethodException If the constructor cannot be found
@@ -278,7 +278,7 @@ public class ConstructorUtils {
* <p>The signatures should be assignment compatible.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
+ * @param klass The class to be constructed.
* @param args actual argument array. May be null (this will result in
calling the default constructor).
* @param parameterTypes parameter types array
* @return new instance of {@code klazz}
@@ -322,8 +322,8 @@ public class ConstructorUtils {
* <p>The signatures should match exactly.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
- * @param arg the actual argument. May be null (this will result in
calling the default constructor).
+ * @param klass The class to be constructed.
+ * @param arg The actual argument. May be null (this will result in
calling the default constructor).
* @return new instance of {@code klazz}
* @throws NoSuchMethodException If the constructor cannot be found
* @throws IllegalAccessException If an error occurs accessing the
constructor
@@ -350,7 +350,7 @@ public class ConstructorUtils {
* <p>The signatures should match exactly.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
+ * @param klass The class to be constructed.
* @param args actual argument array. May be null (this will result in
calling the default constructor).
* @return new instance of {@code klazz}
* @throws NoSuchMethodException If the constructor cannot be found
@@ -385,7 +385,7 @@ public class ConstructorUtils {
* <p>The signatures should match exactly.</p>
*
* @param <T> The type of the object to be constructed
- * @param klass the class to be constructed.
+ * @param klass The class to be constructed.
* @param args actual argument array. May be null (this will result in
calling the default constructor).
* @param parameterTypes parameter types array
* @return new instance of {@code klazz}
diff --git
a/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
b/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
index edf2fc31..9fcb7c42 100644
--- a/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
+++ b/src/main/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
@@ -167,7 +167,7 @@ public class ContextClassLoaderLocal<T> {
* Sets the value - a value is provided per (thread) context classloader.
* This mechanism provides isolation for web apps deployed in the same
container.
*
- * @param value the object to be associated with the entrant thread's
context classloader
+ * @param value The object to be associated with the entrant thread's
context classloader
*/
public synchronized void set(final T value) {
// synchronizing the whole method is a bit slower
diff --git
a/src/main/java/org/apache/commons/beanutils/DefaultBeanIntrospector.java
b/src/main/java/org/apache/commons/beanutils/DefaultBeanIntrospector.java
index 80adf82c..9ed22023 100644
--- a/src/main/java/org/apache/commons/beanutils/DefaultBeanIntrospector.java
+++ b/src/main/java/org/apache/commons/beanutils/DefaultBeanIntrospector.java
@@ -86,8 +86,8 @@ public class DefaultBeanIntrospector implements
BeanIntrospector {
* <li>JDK 1.4.2_05: returns null from these methods.</li>
* </ul>
*
- * @param beanClass the current class to be inspected
- * @param descriptors the array with property descriptors
+ * @param beanClass The current class to be inspected
+ * @param descriptors The array with property descriptors
*/
private void handleIndexedPropertyDescriptors(final Class<?> beanClass,
final PropertyDescriptor[] descriptors) {
@@ -155,7 +155,7 @@ public class DefaultBeanIntrospector implements
BeanIntrospector {
* all property descriptors for the current class and adds them to the
* passed in introspection context.
*
- * @param icontext the introspection context
+ * @param icontext The introspection context
*/
@Override
public void introspect(final IntrospectionContext icontext) {
diff --git
a/src/main/java/org/apache/commons/beanutils/DefaultIntrospectionContext.java
b/src/main/java/org/apache/commons/beanutils/DefaultIntrospectionContext.java
index 48bcbf67..1610ab40 100644
---
a/src/main/java/org/apache/commons/beanutils/DefaultIntrospectionContext.java
+++
b/src/main/java/org/apache/commons/beanutils/DefaultIntrospectionContext.java
@@ -50,7 +50,7 @@ class DefaultIntrospectionContext implements
IntrospectionContext {
* Creates a new instance of {@code DefaultIntrospectionContext} and sets
* the current class for introspection.
*
- * @param cls the current class
+ * @param cls The current class
*/
public DefaultIntrospectionContext(final Class<?> cls) {
currentClass = cls;
diff --git a/src/main/java/org/apache/commons/beanutils/DynaProperty.java
b/src/main/java/org/apache/commons/beanutils/DynaProperty.java
index b43c088b..31e5c83a 100644
--- a/src/main/java/org/apache/commons/beanutils/DynaProperty.java
+++ b/src/main/java/org/apache/commons/beanutils/DynaProperty.java
@@ -257,7 +257,7 @@ public class DynaProperty implements Serializable {
* Reads field values for this object safely. There are issues with
serializing primitive class types on certain JVM versions (including java 1.3).
This
* method provides a workaround.
*
- * @param in the content source.
+ * @param in The content source.
* @throws IOException when the stream data values are outside
expected range
* @throws ClassNotFoundException Class of a serialized object cannot be
found.
*/
diff --git
a/src/main/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospector.java
b/src/main/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospector.java
index 1130c5bf..1e8abe45 100644
---
a/src/main/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospector.java
+++
b/src/main/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospector.java
@@ -101,7 +101,7 @@ public class FluentPropertyBeanIntrospector implements
BeanIntrospector {
* initializes it with the prefix for write methods used by the classes to
* be inspected.
*
- * @param writePrefix the prefix for write methods (must not be {@code
null})
+ * @param writePrefix The prefix for write methods (must not be {@code
null})
* @throws IllegalArgumentException if the prefix is {@code null}
*/
public FluentPropertyBeanIntrospector(final String writePrefix) {
@@ -115,8 +115,8 @@ public class FluentPropertyBeanIntrospector implements
BeanIntrospector {
/**
* Creates a property descriptor for a fluent API property.
*
- * @param m the set method for the fluent API property
- * @param propertyName the name of the corresponding property
+ * @param m The set method for the fluent API property
+ * @param propertyName The name of the corresponding property
* @return The descriptor
* @throws IntrospectionException if an error occurs
*/
@@ -139,7 +139,7 @@ public class FluentPropertyBeanIntrospector implements
BeanIntrospector {
* property write methods which have not been discovered by default
* introspection.
*
- * @param icontext the introspection context
+ * @param icontext The introspection context
* @throws IntrospectionException if an error occurs
*/
@Override
@@ -175,7 +175,7 @@ public class FluentPropertyBeanIntrospector implements
BeanIntrospector {
/**
* Derives the name of a property from the given set method.
*
- * @param m the method
+ * @param m The method
* @return The corresponding property name
*/
private String propertyName(final Method m) {
diff --git
a/src/main/java/org/apache/commons/beanutils/IntrospectionContext.java
b/src/main/java/org/apache/commons/beanutils/IntrospectionContext.java
index cf4ad742..94f4d648 100644
--- a/src/main/java/org/apache/commons/beanutils/IntrospectionContext.java
+++ b/src/main/java/org/apache/commons/beanutils/IntrospectionContext.java
@@ -43,7 +43,7 @@ public interface IntrospectionContext {
* property. If this context already contains a descriptor for the affected
* property, it is overridden.
*
- * @param desc the property descriptor
+ * @param desc The property descriptor
*/
void addPropertyDescriptor(PropertyDescriptor desc);
@@ -51,7 +51,7 @@ public interface IntrospectionContext {
* Adds an array of property descriptors to this context. Using this method
* multiple descriptors can be added at once.
*
- * @param descriptors the array of descriptors to be added
+ * @param descriptors The array of descriptors to be added
*/
void addPropertyDescriptors(PropertyDescriptor[] descriptors);
@@ -59,7 +59,7 @@ public interface IntrospectionContext {
* Returns the descriptor for the property with the given name or
* {@code null} if this property is unknown.
*
- * @param name the name of the property in question
+ * @param name The name of the property in question
* @return The descriptor for this property or {@code null} if this
property
* is unknown
*/
@@ -77,7 +77,7 @@ public interface IntrospectionContext {
* already contained in this context. This method can be used for instance
* to prevent that an already existing property descriptor is overridden.
*
- * @param name the name of the property in question
+ * @param name The name of the property in question
* @return <strong>true</strong> if a descriptor for this property has
already been
* added, <strong>false</strong> otherwise
*/
@@ -93,7 +93,7 @@ public interface IntrospectionContext {
/**
* Removes the descriptor for the property with the given name.
*
- * @param name the name of the affected property
+ * @param name The name of the affected property
*/
void removePropertyDescriptor(String name);
}
diff --git a/src/main/java/org/apache/commons/beanutils/LazyDynaList.java
b/src/main/java/org/apache/commons/beanutils/LazyDynaList.java
index 12d7e7f7..8739567d 100644
--- a/src/main/java/org/apache/commons/beanutils/LazyDynaList.java
+++ b/src/main/java/org/apache/commons/beanutils/LazyDynaList.java
@@ -348,7 +348,7 @@ public class LazyDynaList extends ArrayList<Object> {
/**
* Creates a new {@code LazyDynaMap} object for the given property value.
*
- * @param value the property value
+ * @param value The property value
* @return The newly created {@code LazyDynaMap}
*/
private LazyDynaMap createDynaBeanForMapProperty(final Object value) {
@@ -390,7 +390,7 @@ public class LazyDynaList extends ArrayList<Object> {
* to the appropriate size, populating with
* DynaBeans.</p>
*
- * @param requiredSize the required size of the List.
+ * @param requiredSize The required size of the List.
*/
private void growList(final int requiredSize) {
diff --git a/src/main/java/org/apache/commons/beanutils/MethodUtils.java
b/src/main/java/org/apache/commons/beanutils/MethodUtils.java
index fd01ea81..8d744aa4 100644
--- a/src/main/java/org/apache/commons/beanutils/MethodUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/MethodUtils.java
@@ -60,9 +60,9 @@ public class MethodUtils {
/**
* The sole constructor.
*
- * @param cls the class to reflect, must not be null
- * @param methodName the method name to obtain
- * @param paramTypes the array of classes representing the parameter
types
+ * @param cls The class to reflect, must not be null
+ * @param methodName The method name to obtain
+ * @param paramTypes The array of classes representing the parameter
types
* @param exact whether the match has to be exact.
*/
public MethodDescriptor(final Class<?> cls, final String methodName,
Class<?>[] paramTypes, final boolean exact) {
@@ -582,7 +582,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
+ * @param wrapperType The
* @return The primitive type class corresponding to the given wrapper
class,
* null if no match is found
*/
@@ -623,7 +623,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
+ * @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
*/
@@ -1213,8 +1213,8 @@ public class MethodUtils {
* Now logic widening matches are allowed.
* For example, a {@code Long} will not match a {@code int}.
*
- * @param parameterType the type of parameter accepted by the method
- * @param parameterization the type of parameter being tested
+ * @param parameterType The type of parameter accepted by the method
+ * @param parameterization The type of parameter being tested
* @return true if the assignment is compatible.
*/
public static final boolean isAssignmentCompatible(final Class<?>
parameterType, final Class<?> parameterization) {
@@ -1295,7 +1295,7 @@ public class MethodUtils {
/**
* Find a non primitive representation for given primitive class.
*
- * @param clazz the class to find a representation for, not null
+ * @param clazz The class to find a representation for, not null
* @return The original class if it not a primitive. Otherwise the wrapper
class. Not null
*/
public static Class<?> toNonPrimitiveClass(final Class<?> clazz) {
diff --git
a/src/main/java/org/apache/commons/beanutils/NestedNullException.java
b/src/main/java/org/apache/commons/beanutils/NestedNullException.java
index a624c39a..88c22495 100644
--- a/src/main/java/org/apache/commons/beanutils/NestedNullException.java
+++ b/src/main/java/org/apache/commons/beanutils/NestedNullException.java
@@ -37,7 +37,7 @@ public class NestedNullException extends
BeanAccessLanguageException {
/**
* Constructs a {@code NestedNullException} without a detail message.
*
- * @param message the detail message explaining this exception
+ * @param message The detail message explaining this exception
*/
public NestedNullException(final String message) {
super(message);
diff --git a/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
b/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
index 7e069dfa..00c73e8a 100644
--- a/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/PropertyUtils.java
@@ -106,7 +106,7 @@ public class PropertyUtils {
* Adds a {@code BeanIntrospector}. This object is invoked when the
* property descriptors of a class need to be obtained.
*
- * @param introspector the {@code BeanIntrospector} to be added (must
+ * @param introspector The {@code BeanIntrospector} to be added (must
* not be {@code null}
* @throws IllegalArgumentException if the argument is {@code null}
* @since 1.9
@@ -635,7 +635,7 @@ public class PropertyUtils {
/**
* Removes the specified {@code BeanIntrospector}.
*
- * @param introspector the {@code BeanIntrospector} to be removed
+ * @param introspector The {@code BeanIntrospector} to be removed
* @return <strong>true</strong> if the {@code BeanIntrospector} existed
and
* could be removed, <strong>false</strong> otherwise
* @since 1.9
diff --git a/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
b/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
index b3c5ecd3..ee89bcad 100644
--- a/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/PropertyUtilsBean.java
@@ -109,7 +109,7 @@ public class PropertyUtilsBean {
* with indexed properties. It assumes that indexed properties are stored
as
* lists of objects.
*
- * @param obj the object to be converted
+ * @param obj The object to be converted
* @return The resulting list of objects
*/
private static List<Object> toObjectList(final Object obj) {
@@ -121,7 +121,7 @@ public class PropertyUtilsBean {
* when dealing with mapped properties. It assumes that mapped properties
* are stored in a Map<String, Object>.
*
- * @param obj the object to be converted
+ * @param obj The object to be converted
* @return The resulting properties map
*/
private static Map<String, Object> toPropertyMap(final Object obj) {
@@ -158,7 +158,7 @@ public class PropertyUtilsBean {
* Adds a {@code BeanIntrospector}. This object is invoked when the
* property descriptors of a class need to be obtained.
*
- * @param introspector the {@code BeanIntrospector} to be added (must
+ * @param introspector The {@code BeanIntrospector} to be added (must
* not be {@code null}
* @throws IllegalArgumentException if the argument is {@code null}
* @since 1.9
@@ -340,7 +340,7 @@ public class PropertyUtilsBean {
* Performs introspection on the specified class. This method invokes all
{@code BeanIntrospector} objects that were
* added to this instance.
*
- * @param beanClass the class to be inspected
+ * @param beanClass The class to be inspected
* @return A data object with the results of introspection
*/
private BeanIntrospectionData fetchIntrospectionData(final Class<?>
beanClass) {
@@ -529,7 +529,7 @@ public class PropertyUtilsBean {
* class. This object is looked up in the internal cache. If necessary,
introspection
* is performed now on the affected bean class, and the results object is
created.
*
- * @param beanClass the bean class in question
+ * @param beanClass The bean class in question
* @return The {@code BeanIntrospectionData} object for this class
* @throws IllegalArgumentException if the bean class is {@code null}
*/
@@ -1462,7 +1462,7 @@ public class PropertyUtilsBean {
/**
* Removes the specified {@code BeanIntrospector}.
*
- * @param introspector the {@code BeanIntrospector} to be removed
+ * @param introspector The {@code BeanIntrospector} to be removed
* @return <strong>true</strong> if the {@code BeanIntrospector} existed
and could be removed, <strong>false</strong> otherwise
* @since 1.9
*/
@@ -1841,7 +1841,7 @@ public class PropertyUtilsBean {
*
* @param bean Map bean
* @param propertyName The property name
- * @param value the property value
+ * @param value The property value
* @throws IllegalArgumentException when the propertyName is regarded as
being invalid.
* @throws IllegalAccessException just in case subclasses override this
method to try to access real setter methods and find permission is denied.
* @throws InvocationTargetException just in case subclasses override this
method to try to access real setter methods, and find it throws an exception
when
diff --git
a/src/main/java/org/apache/commons/beanutils/SuppressPropertiesBeanIntrospector.java
b/src/main/java/org/apache/commons/beanutils/SuppressPropertiesBeanIntrospector.java
index bae5c393..aa0cbc3e 100644
---
a/src/main/java/org/apache/commons/beanutils/SuppressPropertiesBeanIntrospector.java
+++
b/src/main/java/org/apache/commons/beanutils/SuppressPropertiesBeanIntrospector.java
@@ -62,7 +62,7 @@ public class SuppressPropertiesBeanIntrospector implements
BeanIntrospector {
* Creates a new instance of {@code SuppressPropertiesBeanIntrospector}
and sets the
* names of the properties to be suppressed.
*
- * @param propertiesToSuppress the names of the properties to be
suppressed (must not
+ * @param propertiesToSuppress The names of the properties to be
suppressed (must not
* be {@code null})
* @throws IllegalArgumentException if the collection with property names
is
* {@code null}
diff --git a/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
b/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
index 6f27beef..8132f237 100644
--- a/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
+++ b/src/main/java/org/apache/commons/beanutils/WeakFastHashMap.java
@@ -359,7 +359,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Construct an empty map with the specified capacity.
*
- * @param capacity the initial capacity of the empty map
+ * @param capacity The initial capacity of the empty map
*/
public WeakFastHashMap(final int capacity) {
this.map = createMap(capacity);
@@ -372,8 +372,8 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Construct an empty map with the specified capacity and load factor.
*
- * @param capacity the initial capacity of the empty map
- * @param factor the load factor of the new map
+ * @param capacity The initial capacity of the empty map
+ * @param factor The load factor of the new map
*/
public WeakFastHashMap(final int capacity, final float factor) {
this.map = createMap(capacity, factor);
@@ -382,7 +382,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
/**
* Construct a new map with the same mappings as the specified map.
*
- * @param map the map whose mappings are to be copied
+ * @param map The map whose mappings are to be copied
*/
public WeakFastHashMap(final Map<? extends K, ? extends V> map) {
this.map = createMap(map);
@@ -437,7 +437,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* Return {@code true} if this map contains a mapping for the
* specified key.
*
- * @param key the key to be searched for
+ * @param key The key to be searched for
* @return true if the map contains the key
*/
@Override
@@ -454,7 +454,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* Return {@code true} if this map contains one or more keys mapping
* to the specified value.
*
- * @param value the value to be searched for
+ * @param value The value to be searched for
* @return true if the map contains the value
*/
@Override
@@ -504,7 +504,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* list equals function in the documentation for the
* {@code Map.equals} method.
*
- * @param o the object to be compared to this list
+ * @param o The object to be compared to this list
* @return true if the two maps are equal
*/
@Override
@@ -562,7 +562,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* there is a mapping with a value of {@code null}. Use the
* {@code containsKey()} method to disambiguate these cases.
*
- * @param key the key whose value is to be returned
+ * @param key The key whose value is to be returned
* @return The value mapped to that key, or null
*/
@Override
@@ -641,8 +641,8 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* If the map previously contained a mapping for this key, the old
* value is replaced and returned.
*
- * @param key the key with which the value is to be associated
- * @param value the value to be associated with this key
+ * @param key The key with which the value is to be associated
+ * @param value The value to be associated with this key
* @return The value previously mapped to the key, or null
*/
@Override
@@ -664,7 +664,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* Copy all of the mappings from the specified map to this one, replacing
* any mappings with the same keys.
*
- * @param in the map whose mappings are to be copied
+ * @param in The map whose mappings are to be copied
*/
@Override
public void putAll(final Map<? extends K, ? extends V> in) {
@@ -687,7 +687,7 @@ class WeakFastHashMap<K, V> extends HashMap<K, V> {
* Remove any mapping for this key, and return any previously
* mapped value.
*
- * @param key the key whose mapping is to be removed
+ * @param key The key whose mapping is to be removed
* @return The value removed, or null
*/
@Override
diff --git a/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
b/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
index bd5be798..53bd980e 100644
--- a/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
+++ b/src/main/java/org/apache/commons/beanutils/WrapDynaBean.java
@@ -73,7 +73,7 @@ public class WrapDynaBean implements DynaBean, Serializable {
* created using a standard mechanism.
*
* @param instance JavaBean instance to be wrapped
- * @param cls the optional {@code WrapDynaClass} to be used for this bean
+ * @param cls The optional {@code WrapDynaClass} to be used for this bean
* @since 1.9
*/
public WrapDynaBean(final Object instance, final WrapDynaClass cls) {
diff --git a/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
b/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
index 95e18c46..32b6ab41 100644
--- a/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
+++ b/src/main/java/org/apache/commons/beanutils/WrapDynaClass.java
@@ -60,8 +60,8 @@ public class WrapDynaClass implements DynaClass {
/**
* Creates a new instance of {@code CacheKey}.
*
- * @param beanCls the bean class
- * @param pu the instance of {@code PropertyUtilsBean}
+ * @param beanCls The bean class
+ * @param pu The instance of {@code PropertyUtilsBean}
*/
public CacheKey(final Class<?> beanCls, final PropertyUtilsBean pu) {
beanClass = beanCls;
@@ -231,7 +231,7 @@ public class WrapDynaClass implements DynaClass {
* {@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
+ * @param pu The optional {@code PropertyUtilsBean} to be used for
introspection
* @return A new <em>Wrap</em> {@link DynaClass}
* @since 1.9
*/
@@ -321,7 +321,7 @@ public class WrapDynaClass implements DynaClass {
* needed via calls to the {@code createDynaClass(Class)} method.
*
* @param beanClass JavaBean class to be introspected around
- * @param propUtils the {@code PropertyUtilsBean} associated with this
class
+ * @param propUtils The {@code PropertyUtilsBean} associated with this
class
*/
private WrapDynaClass(final Class<?> beanClass, final PropertyUtilsBean
propUtils) {
// Compiler needs generic.
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 ef2977d7..0eeea0f8 100644
---
a/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
+++
b/src/main/java/org/apache/commons/beanutils/converters/AbstractConverter.java
@@ -102,8 +102,8 @@ public abstract class AbstractConverter implements
Converter {
* Generates a standard conversion exception with a message indicating that
* the passed in value cannot be converted to the desired target type.
*
- * @param type the target type
- * @param value the value to be converted
+ * @param type The target type
+ * @param value The value to be converted
* @return A {@code ConversionException} with a standard message
* @since 1.9
*/
@@ -213,8 +213,8 @@ public abstract class AbstractConverter implements
Converter {
* of the method signature).
*
* @param <T> The type of the result object
- * @param targetClass the target class of the conversion
- * @param value the value to be converted
+ * @param targetClass The target class of the conversion
+ * @param value The value to be converted
* @return The converted value
*/
private <T> T convertToDefaultType(final Class<T> targetClass, final
Object value) {
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 4c81b88d..8e7b9c08 100644
--- a/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
+++ b/src/main/java/org/apache/commons/beanutils/converters/NumberConverter.java
@@ -278,7 +278,7 @@ public abstract class NumberConverter extends
AbstractConverter {
/**
* Convert a String into a {@code Number} object.
*
- * @param sourceType the source type of the conversion
+ * @param sourceType The source type of the conversion
* @param targetType The type to convert the value to
* @param value The String date value.
* @param format The NumberFormat to parse the String value.
diff --git
a/src/main/java/org/apache/commons/beanutils/locale/BaseLocaleConverter.java
b/src/main/java/org/apache/commons/beanutils/locale/BaseLocaleConverter.java
index a80d2122..18109bc9 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/BaseLocaleConverter.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/BaseLocaleConverter.java
@@ -42,8 +42,8 @@ public abstract class BaseLocaleConverter implements
LocaleConverter {
* the correct target type. Otherwise, an exception is thrown.
*
* @param <T> The desired result type
- * @param type the target class of the conversion
- * @param result the conversion result object
+ * @param type The target class of the conversion
+ * @param result The conversion result object
* @return The result cast to the target class
* @throws ConversionException if the result object is not compatible with
* the target type
@@ -255,7 +255,7 @@ public abstract class BaseLocaleConverter implements
LocaleConverter {
* an exception is thrown.
*
* @param <T> The desired target type
- * @param type the target class of the conversion
+ * @param type The target class of the conversion
* @return The default value in the given target type
* @throws ConversionException if the default object is not compatible with
* the target type
diff --git
a/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtils.java
b/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtils.java
index 3cef91ae..62c7aadc 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtils.java
@@ -681,7 +681,7 @@ public class LocaleBeanUtils extends BeanUtils {
*
* <p>For more details see {@code LocaleBeanUtilsBean}</p>
*
- * @param locale the default locale
+ * @param locale The default locale
* @see LocaleBeanUtilsBean#setDefaultLocale(Locale)
*/
public static void setDefaultLocale(final Locale locale) {
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 b9502ed9..3a1764e5 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/LocaleBeanUtilsBean.java
@@ -193,7 +193,7 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean {
* 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.
*
- * @param newInstance a new singleton instance
+ * @param newInstance A new singleton instance
*/
public static void setInstance(final LocaleBeanUtilsBean newInstance) {
LOCALE_BEANS_BY_CLASSLOADER.set(newInstance);
@@ -911,7 +911,7 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean {
/**
* Sets the default Locale.
*
- * @param locale the default locale
+ * @param locale The default locale
*/
public void setDefaultLocale(final Locale locale) {
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 36590d86..6f0b7e80 100644
--- a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
+++ b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtils.java
@@ -329,7 +329,7 @@ public class LocaleConvertUtils {
*
* <p>For more details see {@code LocaleConvertUtilsBean}</p>
*
- * @param locale the default locale
+ * @param locale The default locale
* @see LocaleConvertUtilsBean#setDefaultLocale(Locale)
*/
public static void setDefaultLocale(final Locale locale) {
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 46bcc6af..1862940a 100644
---
a/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
+++
b/src/main/java/org/apache/commons/beanutils/locale/LocaleConvertUtilsBean.java
@@ -553,7 +553,7 @@ public void deregister() {
/**
* setter for defaultLocale.
*
- * @param locale the default locale
+ * @param locale The default locale
*/
public void setDefaultLocale(final Locale locale) {
diff --git
a/src/test/java/org/apache/commons/beanutils/BeanIntrospectionDataTest.java
b/src/test/java/org/apache/commons/beanutils/BeanIntrospectionDataTest.java
index f2899571..94be1390 100644
--- a/src/test/java/org/apache/commons/beanutils/BeanIntrospectionDataTest.java
+++ b/src/test/java/org/apache/commons/beanutils/BeanIntrospectionDataTest.java
@@ -50,7 +50,7 @@ public class BeanIntrospectionDataTest extends TestCase {
/**
* Returns the property descriptor for the test property.
*
- * @param bid the data object
+ * @param bid The data object
* @return The test property descriptor
*/
private static PropertyDescriptor fetchTestDescriptor(final
BeanIntrospectionData bid) {
diff --git
a/src/test/java/org/apache/commons/beanutils/DefaultIntrospectionContextTest.java
b/src/test/java/org/apache/commons/beanutils/DefaultIntrospectionContextTest.java
index f3d83255..fcf4d44e 100644
---
a/src/test/java/org/apache/commons/beanutils/DefaultIntrospectionContextTest.java
+++
b/src/test/java/org/apache/commons/beanutils/DefaultIntrospectionContextTest.java
@@ -35,7 +35,7 @@ public class DefaultIntrospectionContextTest extends TestCase
{
/**
* Creates a property descriptor object for a property with the given name.
*
- * @param propName the property name
+ * @param propName The property name
* @return The descriptor for this property
*/
private static PropertyDescriptor createDescriptor(final String propName) {
diff --git
a/src/test/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospectorTest.java
b/src/test/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospectorTest.java
index e9bbf232..ecb1afa3 100644
---
a/src/test/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospectorTest.java
+++
b/src/test/java/org/apache/commons/beanutils/FluentPropertyBeanIntrospectorTest.java
@@ -44,7 +44,7 @@ public class FluentPropertyBeanIntrospectorTest extends
TestCase {
/**
* Puts all property descriptors into a map so that they can be accessed
by property name.
*
- * @param descs the array with descriptors
+ * @param descs The array with descriptors
* @return A map with property names as keys
*/
private static Map<String, PropertyDescriptor> createDescriptorMap(final
PropertyDescriptor[] descs) {
@@ -58,8 +58,8 @@ public class FluentPropertyBeanIntrospectorTest extends
TestCase {
/**
* Convenience method for obtaining a specific property descriptor and
checking whether it exists.
*
- * @param props the map with property descriptors
- * @param name the name of the desired descriptor
+ * @param props The map with property descriptors
+ * @param name The name of the desired descriptor
* @return The descriptor from the map
*/
private static PropertyDescriptor fetchDescriptor(final Map<String,
PropertyDescriptor> props, final String name) {
diff --git a/src/test/java/org/apache/commons/beanutils/PropertyUtilsTest.java
b/src/test/java/org/apache/commons/beanutils/PropertyUtilsTest.java
index 95fce517..8ddcacf0 100644
--- a/src/test/java/org/apache/commons/beanutils/PropertyUtilsTest.java
+++ b/src/test/java/org/apache/commons/beanutils/PropertyUtilsTest.java
@@ -113,7 +113,7 @@ public class PropertyUtilsTest extends TestCase {
/**
* Finds the descriptor of the name property.
*
- * @param desc the array with descriptors
+ * @param desc The array with descriptors
* @return The found descriptor or null
*/
private static PropertyDescriptor findNameDescriptor(
diff --git a/src/test/java/org/apache/commons/beanutils/TestResultSet.java
b/src/test/java/org/apache/commons/beanutils/TestResultSet.java
index 19d60e0d..98c4fe8d 100644
--- a/src/test/java/org/apache/commons/beanutils/TestResultSet.java
+++ b/src/test/java/org/apache/commons/beanutils/TestResultSet.java
@@ -455,7 +455,7 @@ public class TestResultSet implements InvocationHandler {
* Handles method invocation on the ResultSet proxy.
*
* @param proxy The proxy ResultSet object
- * @param method the method being invoked
+ * @param method The method being invoked
* @param args The method arguments
* @return The result of invoking the method.
* @throws Throwable if an error occurs.
diff --git
a/src/test/java/org/apache/commons/beanutils/TestResultSetMetaData.java
b/src/test/java/org/apache/commons/beanutils/TestResultSetMetaData.java
index 02d94eaa..37912315 100644
--- a/src/test/java/org/apache/commons/beanutils/TestResultSetMetaData.java
+++ b/src/test/java/org/apache/commons/beanutils/TestResultSetMetaData.java
@@ -170,7 +170,7 @@ public class TestResultSetMetaData implements
InvocationHandler {
* Handles method invocation on the {@link ResultSetMetaData} proxy.
*
* @param proxy The proxy ResultSet object
- * @param method the method being invoked
+ * @param method The method being invoked
* @param args The method arguments
* @return The result of invoking the method.
* @throws Throwable if an error occurs.
diff --git a/src/test/java/org/apache/commons/beanutils/bugs/Jira339Test.java
b/src/test/java/org/apache/commons/beanutils/bugs/Jira339Test.java
index 242ce62a..29a4bdb5 100644
--- a/src/test/java/org/apache/commons/beanutils/bugs/Jira339Test.java
+++ b/src/test/java/org/apache/commons/beanutils/bugs/Jira339Test.java
@@ -50,7 +50,7 @@ public class Jira339Test extends TestCase {
/**
* Set the comparator.
*
- * @param comparator the comparator
+ * @param comparator The comparator
*/
public void setComparator(final Comparator<?> comparator) {
this.comparator = comparator;
diff --git a/src/test/java/org/apache/commons/beanutils/bugs/Jira458Test.java
b/src/test/java/org/apache/commons/beanutils/bugs/Jira458Test.java
index 2313bb54..87d732a1 100644
--- a/src/test/java/org/apache/commons/beanutils/bugs/Jira458Test.java
+++ b/src/test/java/org/apache/commons/beanutils/bugs/Jira458Test.java
@@ -34,7 +34,7 @@ public class Jira458Test extends TestCase {
/**
* Helper method for testing a conversion with null as default.
*
- * @param input the input string
+ * @param input The input string
*/
private void checkConversionWithNullDefault(final String input) {
final Converter converter = new IntegerLocaleConverter(null,
Locale.US);
diff --git a/src/test/java/org/apache/commons/beanutils/bugs/Jira465Test.java
b/src/test/java/org/apache/commons/beanutils/bugs/Jira465Test.java
index c25379eb..f1d98f61 100644
--- a/src/test/java/org/apache/commons/beanutils/bugs/Jira465Test.java
+++ b/src/test/java/org/apache/commons/beanutils/bugs/Jira465Test.java
@@ -91,7 +91,7 @@ public class Jira465Test extends TestCase {
/**
* Changes the value of the test property.
*
- * @param bean the bean to be updated
+ * @param bean The bean to be updated
*/
private static void changeValue(final Object bean) {
try {
diff --git
a/src/test/java/org/apache/commons/beanutils/memoryleaktests/pojotests/CustomInteger.java
b/src/test/java/org/apache/commons/beanutils/memoryleaktests/pojotests/CustomInteger.java
index 0b89c26b..bb0e6673 100644
---
a/src/test/java/org/apache/commons/beanutils/memoryleaktests/pojotests/CustomInteger.java
+++
b/src/test/java/org/apache/commons/beanutils/memoryleaktests/pojotests/CustomInteger.java
@@ -34,7 +34,7 @@ public class CustomInteger extends Number {
/**
* Construct a new instance.
- * @param i the integer value
+ * @param i The integer value
*/
public CustomInteger(final int i) {
this.i = i;
