This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-beanutils.git
The following commit(s) were added to refs/heads/master by this push: new c4a06b2d No need for blank Javadoc lines between Javadoc @ tags c4a06b2d is described below commit c4a06b2d81bb0a274578fc62649dc0101a555635 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Nov 28 11:58:43 2024 -0500 No need for blank Javadoc lines between Javadoc @ tags --- .../apache/commons/beanutils2/BasicDynaBean.java | 9 ------ .../apache/commons/beanutils2/BasicDynaClass.java | 2 -- .../BeanPropertyValueChangeConsumer.java | 1 - .../BeanPropertyValueEqualsPredicate.java | 1 - .../beanutils2/BeanToPropertyValueTransformer.java | 1 - .../org/apache/commons/beanutils2/BeanUtils.java | 14 --------- .../apache/commons/beanutils2/BeanUtilsBean.java | 15 --------- .../commons/beanutils2/ConstructorUtils.java | 11 ------- .../apache/commons/beanutils2/ConvertUtils.java | 4 --- .../commons/beanutils2/ConvertUtilsBean.java | 4 --- .../org/apache/commons/beanutils2/Converter.java | 1 - .../commons/beanutils2/ConvertingWrapDynaBean.java | 1 - .../org/apache/commons/beanutils2/DynaBean.java | 8 ----- .../org/apache/commons/beanutils2/DynaClass.java | 2 -- .../apache/commons/beanutils2/LazyDynaBean.java | 7 ----- .../apache/commons/beanutils2/LazyDynaClass.java | 6 ---- .../org/apache/commons/beanutils2/LazyDynaMap.java | 6 ---- .../beanutils2/MappedPropertyDescriptor.java | 3 -- .../org/apache/commons/beanutils2/MethodUtils.java | 13 -------- .../commons/beanutils2/MutableDynaClass.java | 4 --- .../apache/commons/beanutils2/PropertyUtils.java | 21 ------------- .../commons/beanutils2/PropertyUtilsBean.java | 31 ------------------- .../apache/commons/beanutils2/WrapDynaBean.java | 9 ------ .../apache/commons/beanutils2/WrapDynaClass.java | 1 - .../beanutils2/converters/AbstractConverter.java | 1 - .../beanutils2/converters/ArrayConverter.java | 3 -- .../beanutils2/converters/BooleanConverter.java | 4 --- .../beanutils2/converters/DateTimeConverter.java | 3 -- .../beanutils2/converters/NumberConverter.java | 3 -- .../beanutils2/locale/BaseLocaleConverter.java | 5 --- .../commons/beanutils2/locale/LocaleBeanUtils.java | 36 ---------------------- .../beanutils2/locale/LocaleBeanUtilsBean.java | 18 ----------- .../beanutils2/locale/LocaleConvertUtilsBean.java | 9 ------ .../converters/BigIntegerLocaleConverter.java | 1 - .../locale/converters/ByteLocaleConverter.java | 1 - .../locale/converters/DoubleLocaleConverter.java | 1 - .../locale/converters/FloatLocaleConverter.java | 1 - .../locale/converters/IntegerLocaleConverter.java | 1 - .../locale/converters/LongLocaleConverter.java | 1 - .../locale/converters/ShortLocaleConverter.java | 1 - .../beanutils2/sql/AbstractJdbcDynaClass.java | 2 -- .../commons/beanutils2/sql/ResultSetDynaClass.java | 3 -- .../commons/beanutils2/sql/ResultSetIterator.java | 8 ----- .../commons/beanutils2/sql/RowSetDynaClass.java | 7 ----- 44 files changed, 284 deletions(-) diff --git a/src/main/java/org/apache/commons/beanutils2/BasicDynaBean.java b/src/main/java/org/apache/commons/beanutils2/BasicDynaBean.java index a2814c87..dd7bba45 100644 --- a/src/main/java/org/apache/commons/beanutils2/BasicDynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/BasicDynaBean.java @@ -83,7 +83,6 @@ public class BasicDynaBean implements DynaBean { * @param name Name of the property to check * @param key Name of the key to check * @return {@code true} if the mapped property contains a value for the specified key, otherwise {@code false} - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -101,7 +100,6 @@ public class BasicDynaBean implements DynaBean { * * @param name Name of the property whose value is to be retrieved * @return The property's value - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -150,7 +148,6 @@ public class BasicDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param index Index of the value to be retrieved * @return The indexed property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed * @throws IndexOutOfBoundsException if the specified index is outside the range of the underlying property @@ -175,7 +172,6 @@ public class BasicDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param key Key of the value to be retrieved * @return The mapped property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped */ @@ -205,7 +201,6 @@ public class BasicDynaBean implements DynaBean { * * @param name Name of the property for which to retrieve the descriptor * @return The property descriptor - * * @throws IllegalArgumentException if this is not a valid property name for our DynaClass */ protected DynaProperty getDynaProperty(final String name) { @@ -264,7 +259,6 @@ public class BasicDynaBean implements DynaBean { * * @param name Name of the property for which a value is to be removed * @param key Key of the value to be removed - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -287,7 +281,6 @@ public class BasicDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param index Index of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed @@ -319,7 +312,6 @@ public class BasicDynaBean implements DynaBean { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws NullPointerException if an attempt is made to set a primitive property to null @@ -344,7 +336,6 @@ public class BasicDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param key Key of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped diff --git a/src/main/java/org/apache/commons/beanutils2/BasicDynaClass.java b/src/main/java/org/apache/commons/beanutils2/BasicDynaClass.java index 28279ce5..ac737d04 100644 --- a/src/main/java/org/apache/commons/beanutils2/BasicDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/BasicDynaClass.java @@ -140,7 +140,6 @@ public class BasicDynaClass implements DynaClass { * * @param name Name of the dynamic property for which a descriptor is requested * @return The descriptor for the specified property - * * @throws IllegalArgumentException if no property name is specified */ @Override @@ -186,7 +185,6 @@ public class BasicDynaClass implements DynaClass { * {@code DynaBean} interface. * * @param dynaBeanClass The new Class object - * * @throws IllegalArgumentException if the specified Class does not implement the {@code DynaBean} interface */ protected void setDynaBeanClass(final Class<?> dynaBeanClass) { diff --git a/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueChangeConsumer.java b/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueChangeConsumer.java index 5035a205..b62f5d95 100644 --- a/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueChangeConsumer.java +++ b/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueChangeConsumer.java @@ -64,7 +64,6 @@ import org.apache.commons.logging.LogFactory; * * @param <T> The type of the input to the operation * @param <V> The property value type. - * * @see org.apache.commons.beanutils2.PropertyUtils * @see java.util.function.Consumer */ diff --git a/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueEqualsPredicate.java b/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueEqualsPredicate.java index 6de9e1a1..ffb4cec1 100644 --- a/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueEqualsPredicate.java +++ b/src/main/java/org/apache/commons/beanutils2/BeanPropertyValueEqualsPredicate.java @@ -94,7 +94,6 @@ import org.apache.commons.logging.LogFactory; * * @param <T> The type of the input to the predicate. * @param <V> The property value type. - * * @see org.apache.commons.beanutils2.PropertyUtils * @see java.util.function.Predicate */ diff --git a/src/main/java/org/apache/commons/beanutils2/BeanToPropertyValueTransformer.java b/src/main/java/org/apache/commons/beanutils2/BeanToPropertyValueTransformer.java index f9b69c72..a7234de4 100644 --- a/src/main/java/org/apache/commons/beanutils2/BeanToPropertyValueTransformer.java +++ b/src/main/java/org/apache/commons/beanutils2/BeanToPropertyValueTransformer.java @@ -58,7 +58,6 @@ import org.apache.commons.logging.LogFactory; * * @param <T> the type of the input to the function * @param <R> the type of the result of the function - * * @see org.apache.commons.beanutils2.PropertyUtils * @see java.util.function.Function */ diff --git a/src/main/java/org/apache/commons/beanutils2/BeanUtils.java b/src/main/java/org/apache/commons/beanutils2/BeanUtils.java index dddcbca0..d19c22c7 100644 --- a/src/main/java/org/apache/commons/beanutils2/BeanUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/BeanUtils.java @@ -52,7 +52,6 @@ public class BeanUtils { * * @param bean Bean to be cloned * @return the cloned bean - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InstantiationException if a new instance of the bean's class cannot be instantiated * @throws InvocationTargetException if the property accessor method throws an exception @@ -76,7 +75,6 @@ public class BeanUtils { * * @param dest Destination bean whose properties are modified * @param orig Origin bean whose properties are retrieved - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if the {@code dest} or {@code orig</code> argument is null or if the <code>dest} property type is different from the * source type and the relevant converter has not been registered. @@ -100,7 +98,6 @@ public class BeanUtils { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @see BeanUtilsBean#copyProperty @@ -133,7 +130,6 @@ public class BeanUtils { * * @param bean Bean whose properties are to be extracted * @return Map of property descriptors - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -156,7 +152,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The array property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -180,7 +175,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -205,7 +199,6 @@ public class BeanUtils { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -230,7 +223,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(index)} of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -256,7 +248,6 @@ public class BeanUtils { * @param name Simple property name of the property value to be extracted * @param key Lookup key of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -281,7 +272,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if a nested reference to a property returns null * @throws InvocationTargetException if the property accessor method throws an exception @@ -307,7 +297,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -331,7 +320,6 @@ public class BeanUtils { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -355,7 +343,6 @@ public class BeanUtils { * * @param bean JavaBean whose properties are being populated * @param properties Map keyed by property name, with the corresponding (String or String[]) value(s) to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @see BeanUtilsBean#populate @@ -377,7 +364,6 @@ public class BeanUtils { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @see BeanUtilsBean#setProperty diff --git a/src/main/java/org/apache/commons/beanutils2/BeanUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/BeanUtilsBean.java index 349f9f5d..9b96032a 100644 --- a/src/main/java/org/apache/commons/beanutils2/BeanUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/BeanUtilsBean.java @@ -148,7 +148,6 @@ public class BeanUtilsBean { * </p> * * @param todoRemove use this {@code ConvertUtilsBean} to perform conversions from one object to another - * * @since 1.8.0 */ public BeanUtilsBean(final ConvertUtilsBean todoRemove) { @@ -180,7 +179,6 @@ public class BeanUtilsBean { * * @param bean Bean to be cloned * @return the cloned bean - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InstantiationException if a new instance of the bean's class cannot be instantiated * @throws InvocationTargetException if the property accessor method throws an exception @@ -255,7 +253,6 @@ public class BeanUtilsBean { * * @param dest Destination bean whose properties are modified * @param orig Origin bean whose properties are retrieved - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if the {@code dest} or {@code orig</code> argument is null or if the <code>dest} property type is different from the * source type and the relevant converter has not been registered. @@ -329,7 +326,6 @@ public class BeanUtilsBean { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ @@ -476,7 +472,6 @@ public class BeanUtilsBean { * * @param bean Bean whose properties are to be extracted * @return Map of property descriptors - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -517,7 +512,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The array property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -565,7 +559,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -583,7 +576,6 @@ public class BeanUtilsBean { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -601,7 +593,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(index)} of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -619,7 +610,6 @@ public class BeanUtilsBean { * @param name Simple property name of the property value to be extracted * @param key Lookup key of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -636,7 +626,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if a nested reference to a property returns null * @throws InvocationTargetException if the property accessor method throws an exception @@ -653,7 +642,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -677,7 +665,6 @@ public class BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -712,7 +699,6 @@ public class BeanUtilsBean { * * @param bean JavaBean whose properties are being populated * @param properties Map keyed by property name, with the corresponding (String or String[]) value(s) to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ @@ -764,7 +750,6 @@ public class BeanUtilsBean { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ diff --git a/src/main/java/org/apache/commons/beanutils2/ConstructorUtils.java b/src/main/java/org/apache/commons/beanutils2/ConstructorUtils.java index 5fe07c9e..e51857e7 100644 --- a/src/main/java/org/apache/commons/beanutils2/ConstructorUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/ConstructorUtils.java @@ -206,12 +206,10 @@ public class ConstructorUtils { * @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 * @throws InvocationTargetException If an error occurs invoking the constructor * @throws InstantiationException If an error occurs instantiating the class - * * @see #invokeConstructor(Class, Object[], Class[]) */ public static <T> T invokeConstructor(final Class<T> klass, final Object arg) @@ -235,12 +233,10 @@ public class ConstructorUtils { * @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 * @throws IllegalAccessException If an error occurs accessing the constructor * @throws InvocationTargetException If an error occurs invoking the constructor * @throws InstantiationException If an error occurs instantiating the class - * * @see #invokeConstructor(Class, Object[], Class[]) */ public static <T> T invokeConstructor(final Class<T> klass, Object[] args) @@ -271,7 +267,6 @@ public class ConstructorUtils { * @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} - * * @throws NoSuchMethodException if matching constructor cannot be found * @throws IllegalAccessException thrown on the constructor's invocation * @throws InvocationTargetException thrown on the constructor's invocation @@ -309,12 +304,10 @@ public class ConstructorUtils { * @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 * @throws InvocationTargetException If an error occurs invoking the constructor * @throws InstantiationException If an error occurs instantiating the class - * * @see #invokeExactConstructor(Class, Object[], Class[]) */ public static <T> T invokeExactConstructor(final Class<T> klass, final Object arg) @@ -338,12 +331,10 @@ public class ConstructorUtils { * @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 * @throws IllegalAccessException If an error occurs accessing the constructor * @throws InvocationTargetException If an error occurs invoking the constructor * @throws InstantiationException If an error occurs instantiating the class - * * @see #invokeExactConstructor(Class, Object[], Class[]) */ public static <T> T invokeExactConstructor(final Class<T> klass, Object[] args) @@ -374,7 +365,6 @@ public class ConstructorUtils { * @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} - * * @throws NoSuchMethodException if matching constructor cannot be found * @throws IllegalAccessException thrown on the constructor's invocation * @throws InvocationTargetException thrown on the constructor's invocation @@ -403,7 +393,6 @@ public class ConstructorUtils { * Delegates to {@link Array#newInstance(Class, int)}. * * @param <T> Component type. - * * @param componentType See {@link Array#newInstance(Class, int)}. * @param length See {@link Array#newInstance(Class, int)}. * @return See {@link Array#newInstance(Class, int)}. diff --git a/src/main/java/org/apache/commons/beanutils2/ConvertUtils.java b/src/main/java/org/apache/commons/beanutils2/ConvertUtils.java index b5df4683..d832c3d7 100644 --- a/src/main/java/org/apache/commons/beanutils2/ConvertUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/ConvertUtils.java @@ -41,7 +41,6 @@ public class ConvertUtils { * * @param value Value to be converted (may be null) * @return The converted String value or null if value is null - * * @see ConvertUtilsBean#convert(Object) */ public static String convert(final Object value) { @@ -56,7 +55,6 @@ public class ConvertUtils { * @param value Value to be converted (may be null) * @param targetType Class of the value to be converted to (must not be null) * @return The converted value - * * @throws ConversionException if thrown by an underlying Converter */ public static Object convert(final Object value, final Class<?> targetType) { @@ -75,7 +73,6 @@ public class ConvertUtils { * @param value Value to be converted (may be null) * @param clazz Java class to be converted to (must not be null) * @return The converted value - * * @see ConvertUtilsBean#convert(String, Class) */ public static Object convert(final String value, final Class<?> clazz) { @@ -94,7 +91,6 @@ public class ConvertUtils { * @param values Array of values to be converted * @param clazz Java array or element class to be converted to (must not be null) * @return The converted value - * * @see ConvertUtilsBean#convert(String[], Class) */ public static Object convert(final String[] values, final Class<?> clazz) { diff --git a/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java index 770d9510..d1c2d26f 100644 --- a/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/ConvertUtilsBean.java @@ -229,7 +229,6 @@ public class ConvertUtilsBean { * * @param value Value to be converted (may be null) * @return The converted String value or null if value is null - * * @see ConvertUtilsBean#convert(String[], Class) */ public String convert(final Object value) { @@ -244,7 +243,6 @@ public class ConvertUtilsBean { * @param value Value to be converted (may be null) * @param targetType Class of the value to be converted to (must not be null) * @return The converted value - * * @throws ConversionException if thrown by an underlying Converter */ public <T> Object convert(final Object value, final Class<T> targetType) { @@ -295,7 +293,6 @@ public class ConvertUtilsBean { * @param value Value to be converted (may be null) * @param clazz Java class to be converted to (must not be null) * @return The converted value or null if value is null - * * @see ConvertUtilsBean#convert(String[], Class) */ public <T> Object convert(final String value, final Class<T> clazz) { @@ -308,7 +305,6 @@ public class ConvertUtilsBean { * @param value Array of values to be converted * @param clazz Java array or element class to be converted to (must not be null) * @return The converted value - * * @see ConvertUtilsBean#convert(String[], Class) */ public <T> Object convert(final String[] value, final Class<T> clazz) { diff --git a/src/main/java/org/apache/commons/beanutils2/Converter.java b/src/main/java/org/apache/commons/beanutils2/Converter.java index 55b6eaf6..9e40d258 100644 --- a/src/main/java/org/apache/commons/beanutils2/Converter.java +++ b/src/main/java/org/apache/commons/beanutils2/Converter.java @@ -46,7 +46,6 @@ public interface Converter<T> { * @param type Data type to which this value should be converted * @param value The input value to be converted * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully */ <R> R convert(Class<R> type, Object value); diff --git a/src/main/java/org/apache/commons/beanutils2/ConvertingWrapDynaBean.java b/src/main/java/org/apache/commons/beanutils2/ConvertingWrapDynaBean.java index 99897349..891b03ed 100644 --- a/src/main/java/org/apache/commons/beanutils2/ConvertingWrapDynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/ConvertingWrapDynaBean.java @@ -49,7 +49,6 @@ public class ConvertingWrapDynaBean extends WrapDynaBean { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws IllegalArgumentException if there are any problems copying the property. */ @Override diff --git a/src/main/java/org/apache/commons/beanutils2/DynaBean.java b/src/main/java/org/apache/commons/beanutils2/DynaBean.java index c71fd40e..ca8d92d8 100644 --- a/src/main/java/org/apache/commons/beanutils2/DynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/DynaBean.java @@ -32,7 +32,6 @@ public interface DynaBean { * @param name Name of the property to check * @param key Name of the key to check * @return {@code true} if the mapped property contains a value for the specified key, otherwise {@code false} - * * @throws IllegalArgumentException if there is no property of the specified name */ boolean contains(String name, String key); @@ -42,7 +41,6 @@ public interface DynaBean { * * @param name Name of the property whose value is to be retrieved * @return The property's value - * * @throws IllegalArgumentException if there is no property of the specified name */ Object get(String name); @@ -53,7 +51,6 @@ public interface DynaBean { * @param name Name of the property whose value is to be retrieved * @param index Index of the value to be retrieved * @return The indexed property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed * @throws IndexOutOfBoundsException if the specified index is outside the range of the underlying property @@ -67,7 +64,6 @@ public interface DynaBean { * @param name Name of the property whose value is to be retrieved * @param key Key of the value to be retrieved * @return The mapped property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped */ @@ -85,7 +81,6 @@ public interface DynaBean { * * @param name Name of the property for which a value is to be removed * @param key Key of the value to be removed - * * @throws IllegalArgumentException if there is no property of the specified name */ void remove(String name, String key); @@ -96,7 +91,6 @@ public interface DynaBean { * @param name Name of the property whose value is to be set * @param index Index of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed @@ -109,7 +103,6 @@ public interface DynaBean { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws NullPointerException if an attempt is made to set a primitive property to null @@ -122,7 +115,6 @@ public interface DynaBean { * @param name Name of the property whose value is to be set * @param key Key of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped diff --git a/src/main/java/org/apache/commons/beanutils2/DynaClass.java b/src/main/java/org/apache/commons/beanutils2/DynaClass.java index 320c8234..ab726354 100644 --- a/src/main/java/org/apache/commons/beanutils2/DynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/DynaClass.java @@ -44,7 +44,6 @@ public interface DynaClass { * * @param name Name of the dynamic property for which a descriptor is requested * @return The descriptor for the specified property - * * @throws IllegalArgumentException if no property name is specified */ DynaProperty getDynaProperty(String name); @@ -61,7 +60,6 @@ public interface DynaClass { * Instantiates and return a new DynaBean instance, associated with this DynaClass. * * @return A new {@code DynaBean} instance - * * @throws IllegalAccessException if the Class or the appropriate constructor is not accessible * @throws InstantiationException if this Class represents an abstract class, an array class, a primitive type, or void; or if instantiation fails for some * other reason diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java index ea9d12ed..90a8acf5 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaBean.java @@ -203,7 +203,6 @@ public class LazyDynaBean implements DynaBean { * @param name Name of the property to check * @param key Name of the key to check * @return {@code true} if the mapped property contains a value for the specified key, otherwise {@code false} - * * @throws IllegalArgumentException if no property name is specified */ @Override @@ -492,7 +491,6 @@ public class LazyDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param index Index of the value to be retrieved * @return The indexed property's value - * * @throws IllegalArgumentException if the specified property exists, but is not indexed * @throws IndexOutOfBoundsException if the specified index is outside the range of the underlying property */ @@ -536,7 +534,6 @@ public class LazyDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param key Key of the value to be retrieved * @return The mapped property's value - * * @throws IllegalArgumentException if the specified property exists, but is not mapped */ @Override @@ -698,7 +695,6 @@ public class LazyDynaBean implements DynaBean { * * @param name Name of the property for which a value is to be removed * @param key Key of the value to be removed - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -724,7 +720,6 @@ public class LazyDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param index Index of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed @@ -767,7 +762,6 @@ public class LazyDynaBean implements DynaBean { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws IllegalArgumentException if this is not an existing property name for our DynaClass and the MutableDynaClass is restricted * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws NullPointerException if an attempt is made to set a primitive property to null @@ -809,7 +803,6 @@ public class LazyDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param key Key of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java index f0bf2046..0477aff6 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaClass.java @@ -114,7 +114,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * Add a new dynamic property. * * @param property Property the new dynamic property to add. - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -140,7 +139,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * Add a new dynamic property with no restrictions on data type, readability, or writeability. * * @param name Name of the new dynamic property - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -154,7 +152,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * * @param name Name of the new dynamic property * @param type Data type of the new dynamic property (null for no restrictions) - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -186,7 +183,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * @param type Data type of the new dynamic property (null for no restrictions) * @param readable Set to {@code true} if this property value should be readable * @param writable Set to {@code true} if this property value should be writable - * * @throws UnsupportedOperationException anytime this method is called */ @Override @@ -216,7 +212,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * * @param name Name of the dynamic property for which a descriptor is requested * @return The dyna property for the specified name - * * @throws IllegalArgumentException if no property name is specified */ @Override @@ -279,7 +274,6 @@ public class LazyDynaClass extends BasicDynaClass implements MutableDynaClass { * does <strong>NOT</strong> cause any corresponding property values to be removed from DynaBean instances associated with this DynaClass. * * @param name Name of the dynamic property to remove - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no properties can be removed */ diff --git a/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java b/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java index dae36a41..27e49cf4 100644 --- a/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java +++ b/src/main/java/org/apache/commons/beanutils2/LazyDynaMap.java @@ -143,7 +143,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * Add a new dynamic property. * * @param property Property the new dynamic property to add. - * * @throws IllegalArgumentException if name is null */ protected void add(final DynaProperty property) { @@ -154,7 +153,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * Add a new dynamic property with no restrictions on data type, readability, or writeability. * * @param name Name of the new dynamic property - * * @throws IllegalArgumentException if name is null */ @Override @@ -167,7 +165,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * * @param name Name of the new dynamic property * @param type Data type of the new dynamic property (null for no restrictions) - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -200,7 +197,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * @param type Data type of the new dynamic property (null for no restrictions) * @param readable Set to {@code true} if this property value should be readable * @param writable Set to {@code true} if this property value should be writable - * * @throws UnsupportedOperationException anytime this method is called */ @Override @@ -255,7 +251,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * * @param name Name of the dynamic property for which a descriptor is requested * @return The descriptor for the specified property - * * @throws IllegalArgumentException if no property name is specified */ @Override @@ -372,7 +367,6 @@ public class LazyDynaMap extends LazyDynaBean implements MutableDynaClass { * does <strong>NOT</strong> cause any corresponding property values to be removed from DynaBean instances associated with this DynaClass. * * @param name Name of the dynamic property to remove - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no properties can be removed */ diff --git a/src/main/java/org/apache/commons/beanutils2/MappedPropertyDescriptor.java b/src/main/java/org/apache/commons/beanutils2/MappedPropertyDescriptor.java index 328b04bb..8ab02236 100644 --- a/src/main/java/org/apache/commons/beanutils2/MappedPropertyDescriptor.java +++ b/src/main/java/org/apache/commons/beanutils2/MappedPropertyDescriptor.java @@ -268,7 +268,6 @@ public class MappedPropertyDescriptor extends PropertyDescriptor { * * @param propertyName The programmatic name of the property. * @param beanClass The Class object for the target bean. For example sun.beans.OurButton.class. - * * @throws IntrospectionException if an exception occurs during introspection. */ public MappedPropertyDescriptor(final String propertyName, final Class<?> beanClass) throws IntrospectionException { @@ -319,7 +318,6 @@ public class MappedPropertyDescriptor extends PropertyDescriptor { * @param beanClass The Class object for the target bean. For example sun.beans.OurButton.class. * @param mappedGetterName The name of the method used for reading one of the property values. May be null if the property is write-only. * @param mappedSetterName The name of the method used for writing one of the property values. May be null if the property is read-only. - * * @throws IntrospectionException if an exception occurs during introspection. */ public MappedPropertyDescriptor(final String propertyName, final Class<?> beanClass, final String mappedGetterName, final String mappedSetterName) @@ -354,7 +352,6 @@ public class MappedPropertyDescriptor extends PropertyDescriptor { * @param propertyName The programmatic name of the property. * @param mappedGetter The method used for reading one of the property values. May be null if the property is write-only. * @param mappedSetter The method used for writing one the property values. May be null if the property is read-only. - * * @throws IntrospectionException if an exception occurs during introspection. */ public MappedPropertyDescriptor(final String propertyName, final Method mappedGetter, final Method mappedSetter) throws IntrospectionException { diff --git a/src/main/java/org/apache/commons/beanutils2/MethodUtils.java b/src/main/java/org/apache/commons/beanutils2/MethodUtils.java index f44decad..2f903b5e 100644 --- a/src/main/java/org/apache/commons/beanutils2/MethodUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/MethodUtils.java @@ -638,7 +638,6 @@ public class MethodUtils { * @param methodName get method with this name * @param arg use this argument. May be null (this will result in calling the parameterless method with name {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -663,7 +662,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array (passing null will result in calling the parameterless method with name * {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -696,7 +694,6 @@ public class MethodUtils { * {@code methodName}). * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -731,7 +728,6 @@ public class MethodUtils { * @param methodName get method with this name * @param arg use this argument. May be null (this will result in calling the parameterless method with name {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -757,7 +753,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array (passing null will result in calling the parameterless method with name * {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -791,7 +786,6 @@ public class MethodUtils { * {@code methodName}). * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -837,7 +831,6 @@ public class MethodUtils { * @param methodName get method with this name * @param arg use this argument. May be null (this will result in calling the parameterless method with name {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -872,7 +865,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array (passing null will result in calling the parameterless method with name * {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -913,7 +905,6 @@ public class MethodUtils { * {@code methodName}). * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -957,7 +948,6 @@ public class MethodUtils { * @param methodName get method with this name * @param arg use this argument. May be null (this will result in calling the parameterless method with name {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -993,7 +983,6 @@ public class MethodUtils { * @param args use these arguments - treat null as empty array (passing null will result in calling the parameterless method with name * {@code methodName}). * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -1035,7 +1024,6 @@ public class MethodUtils { * {@code methodName}). * @param parameterTypes match these parameters - treat null as empty array * @return The value returned by the invoked method - * * @throws NoSuchMethodException if there is no such accessible method * @throws InvocationTargetException wraps an exception thrown by the method invoked * @throws IllegalAccessException if the requested method is not accessible via reflection @@ -1074,7 +1062,6 @@ public class MethodUtils { * * @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) { diff --git a/src/main/java/org/apache/commons/beanutils2/MutableDynaClass.java b/src/main/java/org/apache/commons/beanutils2/MutableDynaClass.java index 181e332c..f92a720b 100644 --- a/src/main/java/org/apache/commons/beanutils2/MutableDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/MutableDynaClass.java @@ -34,7 +34,6 @@ public interface MutableDynaClass extends DynaClass { * Add a new dynamic property with no restrictions on data type, readability, or writeability. * * @param name Name of the new dynamic property - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -45,7 +44,6 @@ public interface MutableDynaClass extends DynaClass { * * @param name Name of the new dynamic property * @param type Data type of the new dynamic property (null for no restrictions) - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -58,7 +56,6 @@ public interface MutableDynaClass extends DynaClass { * @param type Data type of the new dynamic property (null for no restrictions) * @param readable Set to {@code true} if this property value should be readable * @param writable Set to {@code true} if this property value should be writable - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no new properties can be added */ @@ -77,7 +74,6 @@ public interface MutableDynaClass extends DynaClass { * does <strong>NOT</strong> cause any corresponding property values to be removed from DynaBean instances associated with this DynaClass. * * @param name Name of the dynamic property to remove - * * @throws IllegalArgumentException if name is null * @throws IllegalStateException if this DynaClass is currently restricted, so no properties can be removed */ diff --git a/src/main/java/org/apache/commons/beanutils2/PropertyUtils.java b/src/main/java/org/apache/commons/beanutils2/PropertyUtils.java index e8496972..f852c789 100644 --- a/src/main/java/org/apache/commons/beanutils2/PropertyUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/PropertyUtils.java @@ -74,7 +74,6 @@ public class PropertyUtils { * * @param dest Destination bean whose properties are modified * @param orig Origin bean whose properties are retrieved - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if the {@code dest} or {@code orig} argument is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -96,7 +95,6 @@ public class PropertyUtils { * * @param bean Bean whose properties are to be extracted * @return The set of properties for the bean - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -119,7 +117,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return the indexed property value - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -145,7 +142,6 @@ public class PropertyUtils { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return the indexed property value - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -170,7 +166,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(key)} of the property value to be extracted * @return the mapped property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -194,7 +189,6 @@ public class PropertyUtils { * @param name Mapped property name of the property value to be extracted * @param key Key of the property value to be extracted * @return the mapped property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -234,7 +228,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return the nested property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws NestedNullException if a nested reference to a property returns null @@ -259,7 +252,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return the property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -282,7 +274,6 @@ public class PropertyUtils { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return the property descriptor - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -343,7 +334,6 @@ public class PropertyUtils { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return the property editor class - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -368,7 +358,6 @@ public class PropertyUtils { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return The property type - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -410,7 +399,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if the property name is nested or indexed @@ -452,7 +440,6 @@ public class PropertyUtils { * @param bean Bean to be examined (may be a {@link DynaBean} * @param name Property name to be evaluated * @return {@code true} if the property is readable, otherwise {@code false} - * * @throws IllegalArgumentException if {@code bean} or {@code name</code> is <code>null} * @see PropertyUtilsBean#isReadable * @since 1.6 @@ -473,7 +460,6 @@ public class PropertyUtils { * @param bean Bean to be examined (may be a {@link DynaBean} * @param name Property name to be evaluated * @return {@code true} if the property is writable, otherwise {@code false} - * * @throws IllegalArgumentException if {@code bean} or {@code name</code> is <code>null} * @see PropertyUtilsBean#isWriteable * @since 1.6 @@ -515,7 +501,6 @@ public class PropertyUtils { * @param name Simple property name of the property value to be set * @param index Index of the property value to be set * @param value Value to which the indexed property element is to be set - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -540,7 +525,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be modified * @param name {@code propertyname[index]} of the property value to be modified * @param value Value to which the specified property element should be set - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -565,7 +549,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be set * @param name {@code propertyname(key)} of the property value to be set * @param value The property value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -589,7 +572,6 @@ public class PropertyUtils { * @param name Mapped property name of the property value to be set * @param key Key of the property value to be set * @param value The property value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -612,7 +594,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be modified * @param name Possibly nested name of the property to be modified * @param value Value to which the property is to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -637,7 +618,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be modified * @param name Possibly indexed and/or nested name of the property to be modified * @param value Value to which this property is to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -661,7 +641,6 @@ public class PropertyUtils { * @param bean Bean whose property is to be modified * @param name Name of the property to be modified * @param value Value to which the property should be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if the property name is nested or indexed diff --git a/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java index 6405e365..b8620f2e 100644 --- a/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/PropertyUtilsBean.java @@ -169,7 +169,6 @@ public class PropertyUtilsBean { * * @param dest Destination bean whose properties are modified * @param orig Origin bean whose properties are retrieved - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if the {@code dest} or {@code orig} argument is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -252,7 +251,6 @@ public class PropertyUtilsBean { * * @param bean Bean whose properties are to be extracted * @return The set of properties for the bean - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -307,7 +305,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return the indexed property value - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying array or List * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -343,7 +340,6 @@ public class PropertyUtilsBean { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return the indexed property value - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -442,7 +438,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(key)} of the property value to be extracted * @return the mapped property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -475,7 +470,6 @@ public class PropertyUtilsBean { * @param name Mapped property name of the property value to be extracted * @param key Key of the property value to be extracted * @return the mapped property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -570,7 +564,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return the nested property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws NestedNullException if a nested reference to a property returns null @@ -618,7 +611,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return the property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -646,7 +638,6 @@ public class PropertyUtilsBean { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return the property descriptor - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -716,7 +707,6 @@ public class PropertyUtilsBean { * * @param beanClass Bean class for which property descriptors are requested * @return the property descriptors - * * @throws IllegalArgumentException if {@code beanClass} is null */ public PropertyDescriptor[] getPropertyDescriptors(final Class<?> beanClass) { @@ -734,7 +724,6 @@ public class PropertyUtilsBean { * * @param bean Bean for which property descriptors are requested * @return the property descriptors - * * @throws IllegalArgumentException if {@code bean} is null */ public PropertyDescriptor[] getPropertyDescriptors(final Object bean) { @@ -761,7 +750,6 @@ public class PropertyUtilsBean { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return the property editor class - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -786,11 +774,8 @@ public class PropertyUtilsBean { * @param bean Map bean * @param propertyName The property name * @return 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 getter methods and find permission is denied. - * * @throws InvocationTargetException just in case subclasses override this method to try to access real getter methods, and find it throws an exception when * invoked. * @@ -827,7 +812,6 @@ public class PropertyUtilsBean { * @param bean Bean for which a property descriptor is requested * @param name Possibly indexed and/or nested name of the property for which a property descriptor is requested * @return The property type - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -940,7 +924,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property value - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if the property name is nested or indexed @@ -1076,9 +1059,7 @@ public class PropertyUtilsBean { * @param bean Bean to be examined (may be a {@link DynaBean} * @param name Property name to be evaluated * @return {@code true} if the property is readable, otherwise {@code false} - * * @throws IllegalArgumentException if {@code bean} or {@code name</code> is <code>null} - * * @since 1.6 */ public boolean isReadable(Object bean, String name) { @@ -1141,9 +1122,7 @@ public class PropertyUtilsBean { * @param bean Bean to be examined (may be a {@link DynaBean} * @param name Property name to be evaluated * @return {@code true} if the property is writable, otherwise {@code false} - * * @throws IllegalArgumentException if {@code bean} or {@code name</code> is <code>null} - * * @since 1.6 */ public boolean isWriteable(Object bean, String name) { @@ -1231,7 +1210,6 @@ public class PropertyUtilsBean { * @param name Simple property name of the property value to be set * @param index Index of the property value to be set * @param value Value to which the indexed property element is to be set - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -1320,7 +1298,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be modified * @param name {@code propertyname[index]} of the property value to be modified * @param value Value to which the specified property element should be set - * * @throws IndexOutOfBoundsException if the specified index is outside the valid range for the underlying property * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null @@ -1356,7 +1333,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be set * @param name {@code propertyname(key)} of the property value to be set * @param value The property value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -1391,7 +1367,6 @@ public class PropertyUtilsBean { * @param name Mapped property name of the property value to be set * @param key Key of the property value to be set * @param value The property value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -1458,7 +1433,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be modified * @param name Possibly nested name of the property to be modified * @param value Value to which the property is to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if a nested reference to a property returns null @@ -1506,7 +1480,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be modified * @param name Possibly indexed and/or nested name of the property to be modified * @param value Value to which this property is to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws InvocationTargetException if the property accessor method throws an exception @@ -1543,11 +1516,8 @@ public class PropertyUtilsBean { * @param bean Map bean * @param propertyName The property name * @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 * invoked. * @@ -1596,7 +1566,6 @@ public class PropertyUtilsBean { * @param bean Bean whose property is to be modified * @param name Name of the property to be modified * @param value Value to which the property should be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if {@code bean} or {@code name} is null * @throws IllegalArgumentException if the property name is nested or indexed diff --git a/src/main/java/org/apache/commons/beanutils2/WrapDynaBean.java b/src/main/java/org/apache/commons/beanutils2/WrapDynaBean.java index b55058d2..b82cd1a8 100644 --- a/src/main/java/org/apache/commons/beanutils2/WrapDynaBean.java +++ b/src/main/java/org/apache/commons/beanutils2/WrapDynaBean.java @@ -84,7 +84,6 @@ public class WrapDynaBean implements DynaBean { * @param name Name of the property to check * @param key Name of the key to check * @return {@code true} if the mapped property contains a value for the specified key, otherwise {@code false} - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -97,7 +96,6 @@ public class WrapDynaBean implements DynaBean { * * @param name Name of the property whose value is to be retrieved * @return The property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws NullPointerException for null input. */ @@ -123,7 +121,6 @@ public class WrapDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param index Index of the value to be retrieved * @return The indexed property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed * @throws IndexOutOfBoundsException if the specified index is outside the range of the underlying property @@ -151,7 +148,6 @@ public class WrapDynaBean implements DynaBean { * @param name Name of the property whose value is to be retrieved * @param key Key of the value to be retrieved * @return The mapped property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped */ @@ -188,7 +184,6 @@ public class WrapDynaBean implements DynaBean { * * @param name Name of the property for which to retrieve the descriptor * @return The descriptor for the specified property - * * @throws IllegalArgumentException if this is not a valid property name for our DynaClass */ protected DynaProperty getDynaProperty(final String name) { @@ -228,7 +223,6 @@ public class WrapDynaBean implements DynaBean { * * @param name Name of the property for which a value is to be removed * @param key Key of the value to be removed - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -242,7 +236,6 @@ public class WrapDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param index Index of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed @@ -267,7 +260,6 @@ public class WrapDynaBean implements DynaBean { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws NullPointerException if an attempt is made to set a primitive property to null @@ -290,7 +282,6 @@ public class WrapDynaBean implements DynaBean { * @param name Name of the property whose value is to be set * @param key Key of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped diff --git a/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java b/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java index 41c93c49..c34d7cd1 100644 --- a/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/WrapDynaClass.java @@ -211,7 +211,6 @@ public class WrapDynaClass implements DynaClass { * * @param name Name of the dynamic property for which a descriptor is requested * @return The descriptor for the specified property - * * @throws IllegalArgumentException if no property name is specified */ @Override diff --git a/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java index 5c69c366..b8b41629 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/AbstractConverter.java @@ -220,7 +220,6 @@ public abstract class AbstractConverter<D> implements Converter<D> { * it (which is required to fulfill the contract of the method signature). * * @param value the value to be converted - * * @param <T> the type of the result object * @return the converted value */ diff --git a/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java index dfbf5108..c89a00cb 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/ArrayConverter.java @@ -169,7 +169,6 @@ public class ArrayConverter<C> extends AbstractConverter<C> { * {@link ArrayConverter#convertToString(Object)} methods for <em>non-array</em> types. * * @param value value to be converted - * * @return Collection elements. */ protected Collection<?> convertToCollection(final Object value) { @@ -318,9 +317,7 @@ public class ArrayConverter<C> extends AbstractConverter<C> { * </ul> * * @param value String value to be parsed - * * @return List of parsed elements. - * * @throws ConversionException if the syntax of {@code value} is not syntactically valid * @throws NullPointerException if {@code value} is {@code null} */ diff --git a/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java index fcf29ee3..d8beee75 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/BooleanConverter.java @@ -93,7 +93,6 @@ public final class BooleanConverter extends AbstractConverter<Boolean> { * The provided string arrays are copied, so that changes to the elements of the array after this call is made do not affect this object. * * @param trueStrings is the set of strings which should convert to the value Boolean.TRUE. The value null must not be present. Case is ignored. - * * @param falseStrings is the set of strings which should convert to the value Boolean.TRUE. The value null must not be present. Case is ignored. * @since 1.8.0 */ @@ -108,9 +107,7 @@ public final class BooleanConverter extends AbstractConverter<Boolean> { * The provided string arrays are copied, so that changes to the elements of the array after this call is made do not affect this object. * * @param trueStrings is the set of strings which should convert to the value Boolean.TRUE. The value null must not be present. Case is ignored. - * * @param falseStrings is the set of strings which should convert to the value Boolean.TRUE. The value null must not be present. Case is ignored. - * * @param defaultValue The default value to be returned if the value being converted is not recognized. This value may be null, in which case null will be * returned on conversion failure. When non-null, it is expected that this value will be either Boolean.TRUE or Boolean.FALSE. The * special value BooleanConverter.NO_DEFAULT can also be passed here, in which case an exception will be thrown on conversion failure. @@ -127,7 +124,6 @@ public final class BooleanConverter extends AbstractConverter<Boolean> { * * @param <T> Target type of the conversion. * @param type is the type to which this value should be converted. In the case of this BooleanConverter class, this value is ignored. - * * @param value is the input value to be converted. The toString method shall be invoked on this object, and the result compared (ignoring case) against the * known "true" and "false" string values. * diff --git a/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java index c422c5db..161d5f93 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/DateTimeConverter.java @@ -277,7 +277,6 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { * * @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. */ protected DateFormat getFormat(final Locale locale, final TimeZone timeZone) { @@ -384,7 +383,6 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { * @param sourceType The type of the value being converted * @param targetType The type to convert the value to. * @param value The String date value. - * * @return The converted Date object. * @throws Exception if an error occurs parsing the date. */ @@ -415,7 +413,6 @@ public abstract class DateTimeConverter<D> extends AbstractConverter<D> { * @param targetType The type to convert the value to * @param value The String date value. * @param format The DateFormat to parse the String value. - * * @return The converted Calendar object. * @throws ConversionException if the String cannot be converted. */ diff --git a/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java b/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java index ebe81c70..d5b25b61 100644 --- a/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/converters/NumberConverter.java @@ -264,7 +264,6 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte * @param targetType The type to convert the value to * @param value The String date value. * @param format The NumberFormat to parse the String value. - * * @return The converted Number object. * @throws ConversionException if the String cannot be converted. */ @@ -336,7 +335,6 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte * @param sourceType The type being converted from * @param targetType The Number type to convert to * @param value The String value to convert. - * * @return The converted Number value. */ private Number toNumber(final Class<?> sourceType, final Class<?> targetType, final String value) { @@ -405,7 +403,6 @@ public abstract class NumberConverter<N extends Number> extends AbstractConverte * @param sourceType The type being converted from * @param targetType The Number type to convert to * @param value The Number to convert. - * * @return The converted value. */ private <T> T toNumber(final Class<?> sourceType, final Class<T> targetType, final Number value) { diff --git a/src/main/java/org/apache/commons/beanutils2/locale/BaseLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/BaseLocaleConverter.java index 0186d80f..6fa5f097 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/BaseLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/BaseLocaleConverter.java @@ -197,7 +197,6 @@ public abstract class BaseLocaleConverter<T> implements LocaleConverter<T> { * @param type Data type to which this value should be converted * @param value The input object to be converted * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully */ @Override @@ -212,7 +211,6 @@ public abstract class BaseLocaleConverter<T> implements LocaleConverter<T> { * @param value is the input object to be converted * @param pattern is the pattern is used for the conversion; if null is passed then the default pattern associated with the converter object will be used. * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully */ @Override @@ -249,7 +247,6 @@ public abstract class BaseLocaleConverter<T> implements LocaleConverter<T> { * * @param value The input object to be converted * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully */ public Object convert(final Object value) { @@ -262,7 +259,6 @@ public abstract class BaseLocaleConverter<T> implements LocaleConverter<T> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully */ public T convert(final Object value, final String pattern) { @@ -287,7 +283,6 @@ public abstract class BaseLocaleConverter<T> implements LocaleConverter<T> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ParseException if conversion cannot be performed successfully */ abstract protected T parse(Object value, String pattern) throws ParseException; diff --git a/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtils.java b/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtils.java index d262f125..87395891 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtils.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtils.java @@ -85,10 +85,8 @@ public class LocaleBeanUtils extends BeanUtils { * @param name The property name * @param propName The Simple name of target property * @return The property's type - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception - * * @see LocaleBeanUtilsBean#definePropertyType(Object, String, String) */ protected static Class<?> definePropertyType(final Object target, final String name, final String propName) @@ -139,11 +137,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getIndexedProperty(Object, String) */ public static String getIndexedProperty(final Object bean, final String name) @@ -165,11 +161,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getIndexedProperty(Object, String, int) */ public static String getIndexedProperty(final Object bean, final String name, final int index) @@ -191,11 +185,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param index Index of the property value to be extracted * @param pattern The conversion pattern * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getIndexedProperty(Object, String, int, String) */ public static String getIndexedProperty(final Object bean, final String name, final int index, final String pattern) @@ -216,11 +208,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name {@code propertyname[index]} of the property value to be extracted * @param pattern The conversion pattern * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getIndexedProperty(Object, String, String) */ public static String getIndexedProperty(final Object bean, final String name, final String pattern) @@ -241,11 +231,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(index)} of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getMappedProperty(Object, String) */ public static String getMappedProperty(final Object bean, final String name) @@ -267,11 +255,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Simple property name of the property value to be extracted * @param key Lookup key of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getMappedProperty(Object, String, String) */ public static String getMappedProperty(final Object bean, final String name, final String key) @@ -293,11 +279,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param key Lookup key of the property value to be extracted * @param pattern The conversion pattern * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getMappedProperty(Object, String, String, String) */ public static String getMappedProperty(final Object bean, final String name, final String key, final String pattern) @@ -318,11 +302,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name {@code propertyname(index)} of the property value to be extracted * @param pattern The conversion pattern * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getMappedPropertyLocale(Object, String, String) */ public static String getMappedPropertyLocale(final Object bean, final String name, final String pattern) @@ -342,11 +324,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getNestedProperty(Object, String) */ public static String getNestedProperty(final Object bean, final String name) @@ -368,11 +348,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Possibly nested name of the property to be extracted * @param pattern The conversion pattern * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getNestedProperty(Object, String, String) */ public static String getNestedProperty(final Object bean, final String name, final String pattern) @@ -392,11 +370,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getProperty(Object, String) */ public static String getProperty(final Object bean, final String name) throws IllegalAccessException, InvocationTargetException, NoSuchMethodException { @@ -416,11 +392,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Possibly indexed and/or nested name of the property to be extracted * @param pattern The conversion pattern * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getProperty(Object, String, String) */ public static String getProperty(final Object bean, final String name, final String pattern) @@ -441,11 +415,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getSimpleProperty(Object, String) */ public static String getSimpleProperty(final Object bean, final String name) @@ -466,11 +438,9 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Name of the property to be extracted * @param pattern The conversion pattern * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found - * * @see LocaleBeanUtilsBean#getSimpleProperty(Object, String, String) */ public static String getSimpleProperty(final Object bean, final String name, final String pattern) @@ -492,10 +462,8 @@ public class LocaleBeanUtils extends BeanUtils { * @param key The Mapped key value (if any) * @param index The indexed subscript value (if any) * @param newValue The value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception - * * @see LocaleBeanUtilsBean#invokeSetter(Object, String, String, int, Object) */ protected static void invokeSetter(final Object target, final String propName, final String key, final int index, final Object newValue) @@ -548,10 +516,8 @@ public class LocaleBeanUtils extends BeanUtils { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception - * * @see LocaleBeanUtilsBean#setProperty(Object, String, Object) */ public static void setProperty(final Object bean, final String name, final Object value) throws IllegalAccessException, InvocationTargetException { @@ -572,10 +538,8 @@ public class LocaleBeanUtils extends BeanUtils { * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set * @param pattern The conversion pattern - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception - * * @see LocaleBeanUtilsBean#setProperty(Object, String, Object, String) */ public static void setProperty(final Object bean, final String name, final Object value, final String pattern) diff --git a/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtilsBean.java index 2d5a01a7..b1a3236c 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/LocaleBeanUtilsBean.java @@ -197,7 +197,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name The property name * @param propName The Simple name of target property * @return The property's type - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ @@ -259,7 +258,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname[index]} of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -277,7 +275,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Simple property name of the property value to be extracted * @param index Index of the property value to be extracted * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -297,7 +294,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param index Index of the property value to be extracted * @param pattern The conversion pattern * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -316,7 +312,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name {@code propertyname[index]} of the property value to be extracted * @param pattern The conversion pattern * @return The indexed property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -344,7 +339,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name {@code propertyname(index)} of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -362,7 +356,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Simple property name of the property value to be extracted * @param key Lookup key of the property value to be extracted * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -382,7 +375,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param key Lookup key of the property value to be extracted * @param pattern The conversion pattern * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -401,7 +393,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name {@code propertyname(index)} of the property value to be extracted * @param pattern The conversion pattern * @return The mapped property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -419,7 +410,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly nested name of the property to be extracted * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if a nested reference to a property returns null * @throws InvocationTargetException if the property accessor method throws an exception @@ -437,7 +427,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Possibly nested name of the property to be extracted * @param pattern The conversion pattern * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws IllegalArgumentException if a nested reference to a property returns null * @throws InvocationTargetException if the property accessor method throws an exception @@ -456,7 +445,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Possibly indexed and/or nested name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -474,7 +462,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Possibly indexed and/or nested name of the property to be extracted * @param pattern The conversion pattern * @return The nested property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -491,7 +478,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean whose property is to be extracted * @param name Name of the property to be extracted * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -508,7 +494,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Name of the property to be extracted * @param pattern The conversion pattern * @return The property's value, converted to a String - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception * @throws NoSuchMethodException if an accessor method for this property cannot be found @@ -527,7 +512,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param key The Mapped key value (if any) * @param index The indexed subscript value (if any) * @param newValue The value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ @@ -572,7 +556,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param bean Bean on which setting is to be performed * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ @@ -589,7 +572,6 @@ public class LocaleBeanUtilsBean extends BeanUtilsBean { * @param name Property name (can be nested/indexed/mapped/combo) * @param value Value to be set * @param pattern The conversion pattern - * * @throws IllegalAccessException if the caller does not have access to the property accessor method * @throws InvocationTargetException if the property accessor method throws an exception */ diff --git a/src/main/java/org/apache/commons/beanutils2/locale/LocaleConvertUtilsBean.java b/src/main/java/org/apache/commons/beanutils2/locale/LocaleConvertUtilsBean.java index ee6253ab..03600201 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/LocaleConvertUtilsBean.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/LocaleConvertUtilsBean.java @@ -122,7 +122,6 @@ public class LocaleConvertUtilsBean { * * @param value The Value to be converted * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public String convert(final Object value) { @@ -136,7 +135,6 @@ public class LocaleConvertUtilsBean { * @param locale The locale * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public String convert(final Object value, final Locale locale, final String pattern) { @@ -150,7 +148,6 @@ public class LocaleConvertUtilsBean { * @param value The Value to be converted * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public String convert(final Object value, final String pattern) { @@ -163,7 +160,6 @@ public class LocaleConvertUtilsBean { * @param value The String scalar value to be converted * @param clazz The Data type to which this value should be converted. * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public Object convert(final String value, final Class<?> clazz) { @@ -179,7 +175,6 @@ public class LocaleConvertUtilsBean { * @param locale The locale * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public Object convert(final String value, final Class<?> clazz, final Locale locale, final String pattern) { @@ -209,7 +204,6 @@ public class LocaleConvertUtilsBean { * @param clazz The Data type to which this value should be converted. * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public Object convert(final String value, final Class<?> clazz, final String pattern) { @@ -222,7 +216,6 @@ public class LocaleConvertUtilsBean { * @param values Value to be converted (may be null) * @param clazz Java array or element class to be converted to * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public Object convert(final String[] values, final Class<?> clazz) { @@ -238,7 +231,6 @@ public class LocaleConvertUtilsBean { * @param locale The locale * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public <T> T[] convert(final String[] values, final Class<T> clazz, final Locale locale, final String pattern) { @@ -265,7 +257,6 @@ public class LocaleConvertUtilsBean { * @param clazz Java array or element class to be converted to * @param pattern The conversion pattern * @return the converted value - * * @throws ConversionException if thrown by an underlying Converter */ public <T> T[] convert(final String[] values, final Class<T> clazz, final String pattern) { diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/BigIntegerLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/BigIntegerLocaleConverter.java index 28f53962..666f5c60 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/BigIntegerLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/BigIntegerLocaleConverter.java @@ -62,7 +62,6 @@ public class BigIntegerLocaleConverter extends DecimalLocaleConverter<BigInteger * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number * @since 1.8.0 diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/ByteLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/ByteLocaleConverter.java index b2683ca1..187a1a7f 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/ByteLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/ByteLocaleConverter.java @@ -59,7 +59,6 @@ public class ByteLocaleConverter extends DecimalLocaleConverter<Byte> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number */ diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/DoubleLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/DoubleLocaleConverter.java index 0d211e95..0a65e5ca 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/DoubleLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/DoubleLocaleConverter.java @@ -59,7 +59,6 @@ public class DoubleLocaleConverter extends DecimalLocaleConverter<Double> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number */ diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/FloatLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/FloatLocaleConverter.java index a1c4ed1a..b4073299 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/FloatLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/FloatLocaleConverter.java @@ -61,7 +61,6 @@ public class FloatLocaleConverter extends DecimalLocaleConverter<Float> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number */ diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/IntegerLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/IntegerLocaleConverter.java index 511bb643..b312e924 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/IntegerLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/IntegerLocaleConverter.java @@ -59,7 +59,6 @@ public class IntegerLocaleConverter extends DecimalLocaleConverter<Integer> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number */ diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/LongLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/LongLocaleConverter.java index 6408fb4d..99d8f58b 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/LongLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/LongLocaleConverter.java @@ -59,7 +59,6 @@ public class LongLocaleConverter extends DecimalLocaleConverter<Long> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number * @since 1.8.0 diff --git a/src/main/java/org/apache/commons/beanutils2/locale/converters/ShortLocaleConverter.java b/src/main/java/org/apache/commons/beanutils2/locale/converters/ShortLocaleConverter.java index 57f93109..7ad560d1 100644 --- a/src/main/java/org/apache/commons/beanutils2/locale/converters/ShortLocaleConverter.java +++ b/src/main/java/org/apache/commons/beanutils2/locale/converters/ShortLocaleConverter.java @@ -64,7 +64,6 @@ public class ShortLocaleConverter extends DecimalLocaleConverter<Short> { * @param value The input object to be converted * @param pattern The pattern is used for the conversion * @return The converted value - * * @throws ConversionException if conversion cannot be performed successfully * @throws ParseException if an error occurs parsing a String to a Number * @since 1.8.0 diff --git a/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java b/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java index 1160d366..326ca97d 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/AbstractJdbcDynaClass.java @@ -155,7 +155,6 @@ abstract class AbstractJdbcDynaClass implements DynaClass { * </p> * * @param name Name of the dynamic property for which a descriptor is requested - * * @throws IllegalArgumentException if no property name is specified */ @Override @@ -216,7 +215,6 @@ abstract class AbstractJdbcDynaClass implements DynaClass { * </p> * * @param resultSet The {@code resultSet} whose metadata is to be introspected - * * @throws SQLException if an error is encountered processing the result set metadata */ protected void introspect(final ResultSet resultSet) throws SQLException { diff --git a/src/main/java/org/apache/commons/beanutils2/sql/ResultSetDynaClass.java b/src/main/java/org/apache/commons/beanutils2/sql/ResultSetDynaClass.java index a23f274f..36e08eb2 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/ResultSetDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/ResultSetDynaClass.java @@ -95,7 +95,6 @@ public class ResultSetDynaClass extends AbstractJdbcDynaClass { * </p> * * @param resultSet The result set to be wrapped - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -117,7 +116,6 @@ public class ResultSetDynaClass extends AbstractJdbcDynaClass { * * @param resultSet The result set to be wrapped * @param lowerCase Should property names be lower cased? - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -140,7 +138,6 @@ public class ResultSetDynaClass extends AbstractJdbcDynaClass { * @param resultSet The result set to be wrapped * @param lowerCase Should property names be lower cased? * @param useColumnLabel true if the column label should be used, otherwise false - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected * @since 1.8.3 diff --git a/src/main/java/org/apache/commons/beanutils2/sql/ResultSetIterator.java b/src/main/java/org/apache/commons/beanutils2/sql/ResultSetIterator.java index 54f02bbe..b37e41b0 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/ResultSetIterator.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/ResultSetIterator.java @@ -91,7 +91,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * @param name Name of the property to check * @param key Name of the key to check * @return {@code true} if the mapped property contains a value for the specified key, otherwise {@code false} - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -104,7 +103,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * * @param name Name of the property whose value is to be retrieved * @return The property's value - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -125,7 +123,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * @param name Name of the property whose value is to be retrieved * @param index Index of the value to be retrieved * @return The indexed property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed * @throws IndexOutOfBoundsException if the specified index is outside the range of the underlying property @@ -142,7 +139,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * @param name Name of the property whose value is to be retrieved * @param key Key of the value to be retrieved * @return The mapped property's value - * * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped */ @@ -214,7 +210,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * * @param name Name of the property for which a value is to be removed * @param key Key of the value to be removed - * * @throws IllegalArgumentException if there is no property of the specified name */ @Override @@ -228,7 +223,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * @param name Name of the property whose value is to be set * @param index Index of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not indexed @@ -244,7 +238,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * * @param name Name of the property whose value is to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws NullPointerException if an attempt is made to set a primitive property to null @@ -268,7 +261,6 @@ public class ResultSetIterator implements DynaBean, Iterator<DynaBean> { * @param name Name of the property whose value is to be set * @param key Key of the property to be set * @param value Value to which this property is to be set - * * @throws ConversionException if the specified value cannot be converted to the type required for this property * @throws IllegalArgumentException if there is no property of the specified name * @throws IllegalArgumentException if the specified property exists, but is not mapped diff --git a/src/main/java/org/apache/commons/beanutils2/sql/RowSetDynaClass.java b/src/main/java/org/apache/commons/beanutils2/sql/RowSetDynaClass.java index 2d14e9c0..7c6be8a0 100644 --- a/src/main/java/org/apache/commons/beanutils2/sql/RowSetDynaClass.java +++ b/src/main/java/org/apache/commons/beanutils2/sql/RowSetDynaClass.java @@ -86,7 +86,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * </p> * * @param resultSet The result set to be wrapped - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -105,7 +104,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * * @param resultSet The result set to be wrapped * @param lowerCase Should property names be lower cased? - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -128,7 +126,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * @param resultSet The result set to be wrapped * @param lowerCase Should property names be lower cased? * @param useColumnLabel true if the column label should be used, otherwise false - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected * @since 1.8.3 @@ -152,7 +149,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * @param resultSet The result set to be wrapped * @param lowerCase Should property names be lower cased? * @param limit Maximum limit for the {@code List} of {@link DynaBean} - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -176,7 +172,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * @param lowerCase Should property names be lower cased? * @param limit Maximum limit for the {@code List} of {@link DynaBean} * @param useColumnLabel true if the column label should be used, otherwise false - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected * @since 1.8.3 @@ -201,7 +196,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * * @param resultSet The result set to be wrapped * @param limit The maximum for the size of the result. - * * @throws NullPointerException if {@code resultSet} is {@code null} * @throws SQLException if the metadata for this result set cannot be introspected */ @@ -216,7 +210,6 @@ public class RowSetDynaClass extends AbstractJdbcDynaClass { * </p> * * @param resultSet The {@code ResultSet} whose data is to be copied - * * @throws SQLException if an error is encountered copying the data */ protected void copy(final ResultSet resultSet) throws SQLException {