commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nia...@apache.org
Subject svn commit: r469863 [1/2] - /jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/
Date Wed, 01 Nov 2006 11:26:24 GMT
Author: niallp
Date: Wed Nov  1 03:26:22 2006
New Revision: 469863

URL: http://svn.apache.org/viewvc?view=rev&rev=469863
Log:
BEANUTILS-254 - Javadoc changes only

Modified:
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtilsBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ResultSetDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/RowSetDynaClass.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/WrapDynaBean.java
    jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/WrapDynaClass.java

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaBean.java Wed Nov  1 03:26:22 2006
@@ -359,6 +359,7 @@
      * Return the property descriptor for the specified property name.
      *
      * @param name Name of the property for which to retrieve the descriptor
+     * @return The property descriptor
      *
      * @exception IllegalArgumentException if this is not a valid property
      *  name for our DynaClass
@@ -380,6 +381,8 @@
      *
      * @param dest Destination class
      * @param source Source class
+     * @return <code>true</code> if the source class is assignable to the
+     * destination class, otherwise <code>false</code>
      */
     protected boolean isAssignable(Class dest, Class source) {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BasicDynaClass.java Wed Nov  1 03:26:22 2006
@@ -226,6 +226,8 @@
      * Return the Class object we will use to create new instances in the
      * <code>newInstance()</code> method.  This Class <strong>MUST</strong>
      * implement the <code>DynaBean</code> interface.
+     *
+     * @return The class of the {@link DynaBean}
      */
     public Class getDynaBeanClass() {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtils.java Wed Nov  1 03:26:22 2006
@@ -70,6 +70,8 @@
     private static int debug = 0;
 
     /**
+     * The <code>debug</code> static property is no longer used
+     * @return debug property
      * @deprecated BeanUtils now uses commons-logging for all log messages.
      *             Use your favorite logging tool to configure logging for
      *             this class.
@@ -79,6 +81,8 @@
     }
 
     /**
+     * The <code>debug</code> static property is no longer used
+     * @param newDebug debug property
      * @deprecated BeanUtils now uses commons-logging for all log messages.
      *             Use your favorite logging tool to configure logging for
      *             this class.
@@ -96,6 +100,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean to be cloned
+     * @return the cloned bean
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InstantiationException if a new instance of the bean's
+     *  class cannot be instantiated
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#cloneBean
      */
     public static Object cloneBean(Object bean)
@@ -113,6 +128,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param dest Destination bean whose properties are modified
+     * @param orig Origin bean whose properties are retrieved
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if the <code>dest</code> or
+     *  <code>orig</code> argument is null or if the <code>dest</code> 
+     *  property type is different from the source type and the relevant
+     *  converter has not been registered.
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
      * @see BeanUtilsBean#copyProperties
      */
     public static void copyProperties(Object dest, Object orig)
@@ -128,6 +154,14 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
      * @see BeanUtilsBean#copyProperty     
      */
     public static void copyProperty(Object bean, String name, Object value)
@@ -143,6 +177,15 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose properties are to be extracted
+     * @return Map of property descriptors
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#describe 
      */
     public static Map describe(Object bean)
@@ -159,6 +202,16 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name Name of the property to be extracted
+     * @return The array property value
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getArrayProperty 
      */
     public static String[] getArrayProperty(Object bean, String name)
@@ -175,6 +228,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name <code>propertyname[index]</code> of the property value
+     *  to be extracted
+     * @return The indexed property's value, converted to a String
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getIndexedProperty(Object, String)
      */
     public static String getIndexedProperty(Object bean, String name)
@@ -193,6 +257,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getIndexedProperty(Object, String, int)
      */
     public static String getIndexedProperty(Object bean,
@@ -211,6 +286,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name <code>propertyname(index)</code> of the property value
+     *  to be extracted
+     * @return The mapped property's value, converted to a String
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getMappedProperty(Object, String)
      */
     public static String getMappedProperty(Object bean, String name)
@@ -228,6 +314,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getMappedProperty(Object, String, String)
      */
     public static String getMappedProperty(Object bean,
@@ -246,6 +343,18 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getNestedProperty
      */
     public static String getNestedProperty(Object bean, String name)
@@ -263,6 +372,17 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getProperty
      */
     public static String getProperty(Object bean, String name)
@@ -280,6 +400,16 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  property cannot be found
      * @see BeanUtilsBean#getSimpleProperty
      */
     public static String getSimpleProperty(Object bean, String name)
@@ -297,6 +427,14 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
      * @see BeanUtilsBean#populate
      */
     public static void populate(Object bean, Map properties)
@@ -312,6 +450,14 @@
      *
      * <p>For more details see <code>BeanUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
      * @see BeanUtilsBean#setProperty
      */
     public static void setProperty(Object bean, String name, Object value)

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/BeanUtilsBean.java Wed Nov  1 03:26:22 2006
@@ -70,7 +70,9 @@
     /** 
      * Gets the instance which provides the functionality for {@link BeanUtils}.
      * This is a pseudo-singleton - an single instance is provided per (thread) context classloader.
-     * This mechanism provides isolation for web apps deployed in the same container. 
+     * This mechanism provides isolation for web apps deployed in the same container.
+     *
+     * @return The (pseudo-singleton) BeanUtils bean instance
      */
     public synchronized static BeanUtilsBean getInstance() {
         return (BeanUtilsBean) beansByClassLoader.get();
@@ -79,7 +81,9 @@
     /** 
      * Sets the instance which provides the functionality for {@link BeanUtils}.
      * This is a pseudo-singleton - an single instance is provided per (thread) context classloader.
-     * This mechanism provides isolation for web apps deployed in the same container. 
+     * This mechanism provides isolation for web apps deployed in the same container.
+     * 
+     * @param newInstance The (pseudo-singleton) BeanUtils bean instance
      */
     public synchronized static void setInstance(BeanUtilsBean newInstance) {
         beansByClassLoader.set(newInstance);
@@ -137,6 +141,7 @@
      * </p>
      *
      * @param bean Bean to be cloned
+     * @return the cloned bean
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -483,6 +488,7 @@
      * names (for example, <code>parametersMap</code>).
      * </p>
      * @param bean Bean whose properties are to be extracted
+     * @return Map of property descriptors
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -532,6 +538,7 @@
      *
      * @param bean Bean whose property is to be extracted
      * @param name Name of the property to be extracted
+     * @return The array property value
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -598,6 +605,7 @@
      * @param bean Bean whose property is to be extracted
      * @param name <code>propertyname[index]</code> of the property value
      *  to be extracted
+     * @return The indexed property's value, converted to a String
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -624,6 +632,7 @@
      * @param bean Bean whose property is to be extracted
      * @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
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -653,6 +662,7 @@
      * @param bean Bean whose property is to be extracted
      * @param name <code>propertyname(index)</code> of the property value
      *  to be extracted
+     * @return The mapped property's value, converted to a String
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -679,6 +689,7 @@
      * @param bean Bean whose property is to be extracted
      * @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
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -704,6 +715,7 @@
      *
      * @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
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -731,6 +743,7 @@
      * @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
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -754,6 +767,7 @@
      *
      * @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
      *
      * @exception IllegalAccessException if the caller does not have
      *  access to the property accessor method
@@ -1094,6 +1108,8 @@
     
     /** 
      * Gets the <code>ConvertUtilsBean</code> instance used to perform the conversions.
+     *
+     * @return The ConvertUtils bean instance
      */
     public ConvertUtilsBean getConvertUtils() {
         return convertUtilsBean;
@@ -1101,6 +1117,8 @@
     
     /**
      * Gets the <code>PropertyUtilsBean</code> instance used to access properties.
+     *
+     * @return The ConvertUtils bean instance
      */
     public PropertyUtilsBean getPropertyUtils() {
         return propertyUtilsBean;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConstructorUtils.java Wed Nov  1 03:26:22 2006
@@ -67,6 +67,11 @@
      * @param arg the actual argument
      * @return new instance of <code>klazz</code>
      *
+     * @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(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static Object invokeConstructor(Class klass, Object arg)
@@ -92,6 +97,11 @@
      * @param args actual argument array
      * @return new instance of <code>klazz</code>
      *
+     * @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(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static Object invokeConstructor(Class klass, Object[] args)
@@ -168,6 +178,11 @@
      * @param arg the actual argument
      * @return new instance of <code>klazz</code>
      *
+     * @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(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static Object invokeExactConstructor(Class klass, Object arg)
@@ -193,6 +208,11 @@
      * @param args actual argument array
      * @return new instance of <code>klazz</code>
      *
+     * @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(java.lang.Class, java.lang.Object[], java.lang.Class[])
      */
     public static Object invokeExactConstructor(Class klass, Object[] args)
@@ -261,6 +281,7 @@
     /**
      * Returns a constructor with single argument.
      * @param klass the class to be constructed
+     * @param parameterType The constructor parameter type
      * @return null if matching accessible constructor can not be found.
      * @see Class#getConstructor
      * @see #getAccessibleConstructor(java.lang.reflect.Constructor)

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ContextClassLoaderLocal.java Wed Nov  1 03:26:22 2006
@@ -105,6 +105,9 @@
     private boolean globalValueInitialized = false;
     private Object globalValue;
 
+    /**
+     * Construct a context classloader instance
+     */
     public ContextClassLoaderLocal() {
         super();
     }
@@ -205,6 +208,7 @@
     
     /** 
      * Unsets the value associated with the given classloader
+     * @param classLoader The classloader to <i>unset</i> for
      */
     public synchronized void unset(ClassLoader classLoader) {    
         valueByClassLoader.remove(classLoader);

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtils.java Wed Nov  1 03:26:22 2006
@@ -39,6 +39,7 @@
 
     /**
      * Gets the default value for Boolean conversions.
+     * @return The default Boolean value
      * @deprecated Register replacement converters for Boolean.TYPE and
      *  Boolean.class instead
      */
@@ -48,6 +49,7 @@
 
     /**
      * Sets the default value for Boolean conversions.
+     * @param newDefaultBoolean The default Boolean value
      * @deprecated Register replacement converters for Boolean.TYPE and
      *  Boolean.class instead
      */
@@ -58,6 +60,7 @@
 
     /**
      * Gets the default value for Byte conversions.
+     * @return The default Byte value
      * @deprecated Register replacement converters for Byte.TYPE and
      *  Byte.class instead
      */
@@ -67,6 +70,7 @@
 
     /**
      * Sets the default value for Byte conversions.
+     * @param newDefaultByte The default Byte value
      * @deprecated Register replacement converters for Byte.TYPE and
      *  Byte.class instead
      */
@@ -77,6 +81,7 @@
 
     /**
      * Gets the default value for Character conversions.
+     * @return The default Character value
      * @deprecated Register replacement converters for Character.TYPE and
      *  Character.class instead
      */
@@ -86,6 +91,7 @@
 
     /**
      * Sets the default value for Character conversions.
+     * @param newDefaultCharacter The default Character value
      * @deprecated Register replacement converters for Character.TYPE and
      *  Character.class instead
      */
@@ -96,6 +102,7 @@
 
     /**
      * Gets the default value for Double conversions.
+     * @return The default Double value
      * @deprecated Register replacement converters for Double.TYPE and
      *  Double.class instead
      */
@@ -105,6 +112,7 @@
 
     /**
      * Sets the default value for Double conversions.
+     * @param newDefaultDouble The default Double value
      * @deprecated Register replacement converters for Double.TYPE and
      *  Double.class instead
      */
@@ -115,6 +123,7 @@
 
     /**
      * Get the default value for Float conversions.
+     * @return The default Float value
      * @deprecated Register replacement converters for Float.TYPE and
      *  Float.class instead
      */
@@ -124,6 +133,7 @@
 
     /**
      * Sets the default value for Float conversions.
+     * @param newDefaultFloat The default Float value
      * @deprecated Register replacement converters for Float.TYPE and
      *  Float.class instead
      */
@@ -134,6 +144,7 @@
 
     /**
      * Gets the default value for Integer conversions.
+     * @return The default Integer value
      * @deprecated Register replacement converters for Integer.TYPE and
      *  Integer.class instead
      */
@@ -143,6 +154,7 @@
 
     /**
      * Sets the default value for Integer conversions.
+     * @param newDefaultInteger The default Integer value
      * @deprecated Register replacement converters for Integer.TYPE and
      *  Integer.class instead
      */
@@ -153,6 +165,7 @@
 
     /**
      * Gets the default value for Long conversions.
+     * @return The default Long value
      * @deprecated Register replacement converters for Long.TYPE and
      *  Long.class instead
      */
@@ -162,6 +175,7 @@
 
     /**
      * Sets the default value for Long conversions.
+     * @param newDefaultLong The default Long value
      * @deprecated Register replacement converters for Long.TYPE and
      *  Long.class instead
      */
@@ -172,6 +186,7 @@
 
     /**
      * Gets the default value for Short conversions.
+     * @return The default Short value
      * @deprecated Register replacement converters for Short.TYPE and
      *  Short.class instead
      */
@@ -181,6 +196,7 @@
 
     /**
      * Sets the default value for Short conversions.
+     * @param newDefaultShort The default Short value
      * @deprecated Register replacement converters for Short.TYPE and
      *  Short.class instead
      */
@@ -196,6 +212,9 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param value Value to be converted (may be null)
+     * @return The converted String value
+     *
      * @see ConvertUtilsBean#convert(Object)
      */
     public static String convert(Object value) {
@@ -211,6 +230,10 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param value Value to be converted (may be null)
+     * @param clazz Java class to be converted to
+     * @return The converted value
+     *
      * @see ConvertUtilsBean#convert(String, Class)
      */
     public static Object convert(String value, Class clazz) {
@@ -226,6 +249,10 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param values Array of values to be converted
+     * @param clazz Java array or element class to be converted to
+     * @return The converted value
+     *
      * @see ConvertUtilsBean#convert(String[], Class)
      */
     public static Object convert(String values[], Class clazz) {
@@ -256,6 +283,7 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param clazz Class for which to remove a registered Converter
      * @see ConvertUtilsBean#deregister(Class)
      */
     public static void deregister(Class clazz) {
@@ -272,6 +300,8 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param clazz Class for which to return a registered Converter
+     * @return The registered {@link Converter} or <code>null</code> if not found
      * @see ConvertUtilsBean#lookup(Class)
      */
     public static Converter lookup(Class clazz) {
@@ -287,6 +317,9 @@
      *
      * <p>For more details see <code>ConvertUtilsBean</code>.</p>
      *
+     * @param converter Converter to be registered
+     * @param clazz Destination class for conversions performed by this
+     *  Converter
      * @see ConvertUtilsBean#register(Converter, Class)
      */
     public static void register(Converter converter, Class clazz) {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/ConvertUtilsBean.java Wed Nov  1 03:26:22 2006
@@ -136,7 +136,10 @@
 public class ConvertUtilsBean {
     
     // ------------------------------------------------------- Class Methods
-    /** Get singleton instance */
+    /**
+     * Get singleton instance
+     * @return The singleton instance
+     */
     protected static ConvertUtilsBean getInstance() {
         return BeanUtilsBean.getInstance().getConvertUtils();
     }
@@ -175,6 +178,7 @@
 
     /**
      * Gets the default value for Boolean conversions.
+     * @return The default Boolean value
      * @deprecated Register replacement converters for Boolean.TYPE and
      *  Boolean.class instead
      */
@@ -184,6 +188,7 @@
 
     /**
      * Sets the default value for Boolean conversions.
+     * @param newDefaultBoolean The default Boolean value
      * @deprecated Register replacement converters for Boolean.TYPE and
      *  Boolean.class instead
      */
@@ -203,6 +208,7 @@
 
     /**
      * Gets the default value for Byte conversions.
+     * @return The default Byte value
      * @deprecated Register replacement converters for Byte.TYPE and
      *  Byte.class instead
      */
@@ -212,6 +218,7 @@
 
     /**
      * Sets the default value for Byte conversions.
+     * @param newDefaultByte The default Byte value
      * @deprecated Register replacement converters for Byte.TYPE and
      *  Byte.class instead
      */
@@ -231,6 +238,7 @@
 
     /**
      * Gets the default value for Character conversions.
+     * @return The default Character value
      * @deprecated Register replacement converters for Character.TYPE and
      *  Character.class instead
      */
@@ -240,6 +248,7 @@
 
     /**
      * Sets the default value for Character conversions.
+     * @param newDefaultCharacter The default Character value
      * @deprecated Register replacement converters for Character.TYPE and
      *  Character.class instead
      */
@@ -261,6 +270,7 @@
 
     /**
      * Gets the default value for Double conversions.
+     * @return The default Double value
      * @deprecated Register replacement converters for Double.TYPE and
      *  Double.class instead
      */
@@ -270,6 +280,7 @@
 
     /**
      * Sets the default value for Double conversions.
+     * @param newDefaultDouble The default Double value
      * @deprecated Register replacement converters for Double.TYPE and
      *  Double.class instead
      */
@@ -289,6 +300,7 @@
 
     /**
      * Gets the default value for Float conversions.
+     * @return The default Float value
      * @deprecated Register replacement converters for Float.TYPE and
      *  Float.class instead
      */
@@ -298,6 +310,7 @@
 
     /**
      * Sets the default value for Float conversions.
+     * @param newDefaultFloat The default Float value
      * @deprecated Register replacement converters for Float.TYPE and
      *  Float.class instead
      */
@@ -317,6 +330,7 @@
 
     /**
      * Gets the default value for Integer conversions.
+     * @return The default Integer value
      * @deprecated Register replacement converters for Integer.TYPE and
      *  Integer.class instead
      */
@@ -326,6 +340,7 @@
     
     /**
      * Sets the default value for Integer conversions.
+     * @param newDefaultInteger The default Integer value
      * @deprecated Register replacement converters for Integer.TYPE and
      *  Integer.class instead
      */
@@ -345,6 +360,7 @@
 
     /**
      * Gets the default value for Long conversions.
+     * @return The default Long value
      * @deprecated Register replacement converters for Long.TYPE and
      *  Long.class instead
      */
@@ -354,6 +370,7 @@
 
     /**
      * Sets the default value for Long conversions.
+     * @param newDefaultLong The default Long value
      * @deprecated Register replacement converters for Long.TYPE and
      *  Long.class instead
      */
@@ -373,6 +390,7 @@
 
     /**
      * Gets the default value for Short conversions.
+     * @return The default Short value
      * @deprecated Register replacement converters for Short.TYPE and
      *  Short.class instead
      */
@@ -382,6 +400,7 @@
 
     /**
      * Sets the default value for Short conversions.
+     * @param newDefaultShort The default Short value
      * @deprecated Register replacement converters for Short.TYPE and
      *  Short.class instead
      */
@@ -402,6 +421,7 @@
      * implementation simply uses toString()).
      *
      * @param value Value to be converted (may be null)
+     * @return The converted String value
      */
     public String convert(Object value) {
 
@@ -432,6 +452,7 @@
      *
      * @param value Value to be converted (may be null)
      * @param clazz Java class to be converted to
+     * @return The converted value
      *
      * @exception ConversionException if thrown by an underlying Converter
      */
@@ -462,6 +483,7 @@
      *
      * @param values Array of values to be converted
      * @param clazz Java array or element class to be converted to
+     * @return The converted value
      *
      * @exception ConversionException if thrown by an underlying Converter
      */
@@ -585,6 +607,7 @@
      * <code>null</code>.
      *
      * @param clazz Class for which to return a registered Converter
+     * @return The registered {@link Converter} or <code>null</code> if not found
      */
     public Converter lookup(Class clazz) {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/Converter.java Wed Nov  1 03:26:22 2006
@@ -47,6 +47,7 @@
      *
      * @param type Data type to which this value should be converted
      * @param value The input value to be converted
+     * @return The converted value
      *
      * @exception ConversionException if conversion cannot be performed
      *  successfully

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaBean.java Wed Nov  1 03:26:22 2006
@@ -40,6 +40,8 @@
      *
      * @param name Name of the property to check
      * @param key Name of the key to check
+     * @return <code>true<code> if the mapped property contains a value for
+     * the specified key, otherwise <code>false</code>
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -51,6 +53,7 @@
      * Return the value of a simple property with the specified name.
      *
      * @param name Name of the property whose value is to be retrieved
+     * @return The property's value
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -63,6 +66,7 @@
      *
      * @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
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -82,6 +86,7 @@
      *
      * @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
      *
      * @exception IllegalArgumentException if there is no property
      *  of the specified name
@@ -94,6 +99,8 @@
     /**
      * Return the <code>DynaClass</code> instance that describes the set of
      * properties available for this DynaBean.
+     *
+     * @return The associated DynaClass
      */
     public DynaClass getDynaClass();
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaClass.java Wed Nov  1 03:26:22 2006
@@ -43,6 +43,8 @@
      * <code>getName()</code> method of <code>java.lang.Class</code), which
      * allows the same <code>DynaClass</code> implementation class to support
      * different dynamic classes, with different sets of properties.
+     *
+     * @return the name of the DynaClass
      */
     public String getName();
 
@@ -53,6 +55,7 @@
      *
      * @param name Name of the dynamic property for which a descriptor
      *  is requested
+     * @return The descriptor for the specified property
      *
      * @exception IllegalArgumentException if no property name is specified
      */
@@ -67,6 +70,8 @@
      * <p><strong>FIXME</strong> - Should we really be implementing
      * <code>getBeanInfo()</code> instead, which returns property descriptors
      * and a bunch of other stuff?</p>
+     *
+     * @return the set of properties for this DynaClass
      */
     public DynaProperty[] getDynaProperties();
 
@@ -74,6 +79,8 @@
     /**
      * Instantiate and return a new DynaBean instance, associated
      * with this DynaClass.
+     *
+     * @return A new <code>DynaBean</code> instance
      *
      * @exception IllegalAccessException if the Class or the appropriate
      *  constructor is not accessible

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/DynaProperty.java Wed Nov  1 03:26:22 2006
@@ -116,6 +116,7 @@
     protected String name = null;
     /**
      * Get the name of this property.
+     * @return the name of the property
      */
     public String getName() {
         return (this.name);
@@ -132,6 +133,8 @@
      * Therefore, this field <strong>must not be serialized using the standard methods</strong>.</p>
      * 
      * <p><strong>Please leave this field as <code>transient</code></strong></p>
+     *
+     * @return the property type
      */
     public Class getType() {
         return (this.type);
@@ -160,6 +163,9 @@
 
     /**
      * Does this property represent an indexed value (ie an array or List)?
+     *
+     * @return <code>true</code> if the property is indexed (i.e. is a List or
+     * array), otherwise <code>false</code>
      */
     public boolean isIndexed() {
 
@@ -178,6 +184,9 @@
 
     /**
      * Does this property represent a mapped value (ie a Map)?
+     *
+     * @return <code>true</code> if the property is a Map
+     * otherwise <code>false</code>
      */
     public boolean isMapped() {
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/JDBCDynaClass.java Wed Nov  1 03:26:22 2006
@@ -124,6 +124,8 @@
      * If there is no such class loader, the class loader used to load this
      * class will be utilized.</p>
      *
+     * @param className The name of the class to load
+     * @return The loaded class
      * @exception SQLException if an exception was thrown trying to load
      *  the specified class
      */
@@ -149,6 +151,7 @@
      * @param metadata is the result set metadata
      * @param i is the column index in the metadata
      * @return the newly created DynaProperty instance
+     * @throws SQLException If an error occurs accessing the SQL metadata
      */
     protected DynaProperty createDynaProperty(
                                     ResultSetMetaData metadata,

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaBean.java Wed Nov  1 03:26:22 2006
@@ -115,14 +115,23 @@
     */
     private transient Log logger = LogFactory.getLog(LazyDynaBean.class);
 
+    /** BigInteger Zero */
     protected static final BigInteger BigInteger_ZERO = new BigInteger("0");
+    /** BigDecimal Zero */
     protected static final BigDecimal BigDecimal_ZERO = new BigDecimal("0");
+    /** Character Space */
     protected static final Character  Character_SPACE = new Character(' ');
+    /** Byte Zero */
     protected static final Byte       Byte_ZERO       = new Byte((byte)0);
+    /** Short Zero */
     protected static final Short      Short_ZERO      = new Short((short)0);
+    /** Integer Zero */
     protected static final Integer    Integer_ZERO    = new Integer(0);
+    /** Long Zero */
     protected static final Long       Long_ZERO       = new Long(0);
+    /** Float Zero */
     protected static final Float      Float_ZERO      = new Float((byte)0);
+    /** Double Zero */
     protected static final Double     Double_ZERO     = new Double((byte)0);
 
     /**
@@ -180,6 +189,7 @@
 
     /**
      * Return the Map backing this <code>DynaBean</code>
+     * @return the underlying Map
      */
     public Map getMap() {
         return values;
@@ -189,6 +199,7 @@
      * <p>Return the size of an indexed or mapped property.</p>
      *
      * @param name Name of the property
+     * @return The indexed or mapped property size
      * @exception IllegalArgumentException if no property name is specified
      */
     public int size(String name) {
@@ -550,6 +561,14 @@
 
     // ------------------- protected Methods ----------------------------------
 
+    /**
+     * Grow the size of an indexed property
+     * @param name The name of the property
+     * @param indexedProperty The current property value
+     * @param index The indexed value to grow the property to (i.e. one less than
+     * the required size)
+     * @return The new property value (grown to the appropriate size)
+     */
     protected Object growIndexedProperty(String name, Object indexedProperty, int index) {
 
         // Grow a List to the appropriate size
@@ -585,6 +604,9 @@
 
     /**
      * Create a new Instance of a Property
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createProperty(String name, Class type) {
 
@@ -615,6 +637,9 @@
 
     /**
      * Create a new Instance of an 'Indexed' Property
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createIndexedProperty(String name, Class type) {
 
@@ -654,6 +679,9 @@
 
     /**
      * Create a new Instance of a 'Mapped' Property
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createMappedProperty(String name, Class type) {
 
@@ -687,7 +715,10 @@
     }
 
     /**
-     * Create a new Instance of a 'Mapped' Property
+     * Create a new Instance of a 'DynaBean' Property.
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createDynaBeanProperty(String name, Class type) {
         try {
@@ -702,7 +733,10 @@
     }
 
     /**
-     * Create a new Instance of a 'Primitive' Property
+     * Create a new Instance of a 'Primitive' Property.
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createPrimitiveProperty(String name, Class type) {
 
@@ -730,6 +764,9 @@
 
     /**
      * Create a new Instance of a <code>java.lang.Number</code> Property.
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createNumberProperty(String name, Class type) {
 
@@ -739,6 +776,9 @@
 
     /**
      * Create a new Instance of other Property types
+     * @param name The name of the property
+     * @param type The class of the property
+     * @return The new value
      */
     protected Object createOtherProperty(String name, Class type) {
 
@@ -771,6 +811,7 @@
      *    or <code>Array</code> implementation is required for 'indexed' properties.</p>
      *
      * @param name Name of the 'indexed property.
+     * @return The default value for an indexed property (java.util.ArrayList)
      */
     protected Object defaultIndexedProperty(String name) {
         return new ArrayList();
@@ -784,6 +825,7 @@
      *    implementation is required for 'mapped' properties.</p>
      *
      * @param name Name of the 'mapped property.
+     * @return The default value for a mapped property (java.util.HashMap)
      */
     protected Map defaultMappedProperty(String name) {
         return new HashMap();
@@ -791,6 +833,9 @@
 
     /**
      * Indicates if there is a property with the specified name.
+     * @param name The name of the property to check
+     * @return <code>true<code> if there is a property of the
+     * specified name, otherwise <code>false</code>
      */
     protected boolean isDynaProperty(String name) {
 
@@ -813,6 +858,8 @@
      *
      * @param dest Destination class
      * @param source Source class
+     * @return <code>true<code> if the source class is assignable to the
+     * destination class, otherwise <code>false</code>
      */
     protected boolean isAssignable(Class dest, Class source) {
 
@@ -834,6 +881,7 @@
 
     /**
      * <p>Creates a new instance of the <code>Map</code>.</p>
+     * @return a new Map instance
      */
     protected Map newMap() {
         return new HashMap();

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaClass.java Wed Nov  1 03:26:22 2006
@@ -126,6 +126,10 @@
      * Should this DynaClass return a <code>null</code> from
      * the <code>getDynaProperty(name)</code> method if the property
      * doesn't exist.
+     *
+     * @return <code>true<code> if a <code>null</code> {@link DynaProperty}
+     * should be returned if the property doesn't exist, otherwise
+     * <code>false</code> if a new {@link DynaProperty} should be created.
      */
     public boolean isReturnNull() {
         return returnNull;
@@ -135,6 +139,9 @@
      * Set whether this DynaClass should return a <code>null</code> from
      * the <code>getDynaProperty(name)</code> method if the property
      * doesn't exist.
+     * @param returnNull <code>true<code> if a <code>null</code> {@link DynaProperty}
+     * should be returned if the property doesn't exist, otherwise
+     * <code>false</code> if a new {@link DynaProperty} should be created.
      */
     public void setReturnNull(boolean returnNull) {
         this.returnNull = returnNull;
@@ -327,6 +334,9 @@
      * return a DynaProperty if it doesn't exist (depending on the
      * <code>returnNull</code> indicator).</p>
      *
+     * @param name The name of the property to check
+     * @return <code>true<code> if there is a property of the
+     * specified name, otherwise <code>false</code>
      * @exception IllegalArgumentException if no property name is specified
      */
     public boolean isDynaProperty(String name) {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/LazyDynaMap.java Wed Nov  1 03:26:22 2006
@@ -143,6 +143,8 @@
 
     /**
      * Set the Map backing this <code>DynaBean</code>
+     *
+     * @param values The new Map of values
      */
     public void setMap(Map values) {
         this.values = values;
@@ -406,6 +408,10 @@
      * Should this DynaClass return a <code>null</code> from
      * the <code>getDynaProperty(name)</code> method if the property
      * doesn't exist.
+     *
+     * @return <code>true<code> if a <code>null</code> {@link DynaProperty}
+     * should be returned if the property doesn't exist, otherwise
+     * <code>false</code> if a new {@link DynaProperty} should be created.
      */
     public boolean isReturnNull() {
         return returnNull;
@@ -415,6 +421,10 @@
      * Set whether this DynaClass should return a <code>null</code> from
      * the <code>getDynaProperty(name)</code> method if the property
      * doesn't exist.
+     *
+     * @param returnNull <code>true<code> if a <code>null</code> {@link DynaProperty}
+     * should be returned if the property doesn't exist, otherwise
+     * <code>false</code> if a new {@link DynaProperty} should be created.
      */
     public void setReturnNull(boolean returnNull) {
         this.returnNull = returnNull;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MappedPropertyDescriptor.java Wed Nov  1 03:26:22 2006
@@ -22,8 +22,6 @@
 import java.beans.PropertyDescriptor;
 import java.lang.reflect.Method;
 import java.lang.reflect.Modifier;
-import java.security.AccessController;
-import java.security.PrivilegedAction;
 
 
 /**
@@ -237,6 +235,8 @@
      * Sets the method that should be used to read one of the property value.
      *
      * @param mappedGetter The mapped getter method.
+     * @throws IntrospectionException If an error occurs finding the
+     * mapped property
      */
     public void setMappedReadMethod(Method mappedGetter)
             throws IntrospectionException {
@@ -258,6 +258,8 @@
      * Sets the method that should be used to write the property value.
      *
      * @param mappedSetter The mapped setter method.
+     * @throws IntrospectionException If an error occurs finding the
+     * mapped property
      */
     public void setMappedWriteMethod(Method mappedSetter)
             throws IntrospectionException {

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MethodUtils.java Wed Nov  1 03:26:22 2006
@@ -102,7 +102,7 @@
      * <p>Invoke a named method whose parameter type matches the object type.</p>
      *
      * <p>The behaviour of this method is less deterministic 
-     * than {@link #invokeExactMethod}. 
+     * than <code>invokeExactMethod()</code>.
      * It loops through all methods with names that match
      * and then executes the first it finds with compatable parameters.</p>
      *
@@ -117,6 +117,7 @@
      * @param object invoke method on this object
      * @param methodName get method with this name
      * @param arg use this argument
+     * @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
@@ -158,6 +159,7 @@
      * @param object invoke method on this object
      * @param methodName get method with this name
      * @param args use these arguments - 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
@@ -205,6 +207,7 @@
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
      * @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
@@ -251,6 +254,7 @@
      * @param object invoke method on this object
      * @param methodName get method with this name
      * @param arg use this argument
+     * @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
@@ -278,11 +282,12 @@
      * types.</p>
      *
      * <p> This uses reflection to invoke the method obtained from a call to
-     * {@link #getAccessibleMethod}.</p>
+     * <code>getAccessibleMethod()</code>.</p>
      *
      * @param object invoke method on this object
      * @param methodName get method with this name
      * @param args use these arguments - 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
@@ -316,12 +321,13 @@
      * types given.</p>
      *
      * <p>This uses reflection to invoke the method obtained from a call to
-     * {@link #getAccessibleMethod}.</p>
+     * <code>getAccessibleMethod()</code>.</p>
      *
      * @param object invoke method on this object
      * @param methodName get method with this name
      * @param args use these arguments - treat null as empty array
      * @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
@@ -369,6 +375,7 @@
      * @param clazz get method from this class
      * @param methodName get method with this name
      * @param parameterType taking this type of parameter
+     * @return The accessible method
      */
     public static Method getAccessibleMethod(
             Class clazz,
@@ -391,6 +398,7 @@
      * @param clazz get method from this class
      * @param methodName get method with this name
      * @param parameterTypes with these parameters types
+     * @return The accessible method
      */
     public static Method getAccessibleMethod(
             Class clazz,
@@ -422,6 +430,7 @@
      * can be found, return <code>null</code>.</p>
      *
      * @param method The method that we wish to call
+     * @return The accessible method
      */
     public static Method getAccessibleMethod(Method method) {
 
@@ -537,6 +546,7 @@
      * @param clazz find method in this class
      * @param methodName find method with this name
      * @param parameterTypes find method with compatible parameters 
+     * @return The accessible method
      */
     public static Method getMatchingAccessibleMethod(
                                                 Class clazz,
@@ -702,9 +712,9 @@
     /**
      * Returns the sum of the object transformation cost for each class in the source
      * argument list.
-     * @param srcArgs The list of arguments to transform
-     * @param destArgs 
-     * @return
+     * @param srcArgs The source arguments
+     * @param destArgs The destination arguments
+     * @return The total transformation cost
      */
     private static float getTotalTransformationCost(Class[] srcArgs, Class[] destArgs) {
 
@@ -723,9 +733,9 @@
      * Gets the number of steps required needed to turn the source class into the 
      * destination class. This represents the number of steps in the object hierarchy 
      * graph.
-     * @param srcClass
-     * @param destClass
-     * @return
+     * @param srcClass The source class
+     * @param destClass The destination class
+     * @return The cost of transforming an object
      */
     private static float getObjectTransformationCost(Class srcClass, Class destClass) {
         float cost = 0.0f;

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/MutableDynaClass.java Wed Nov  1 03:26:22 2006
@@ -90,6 +90,9 @@
      * Is this DynaClass currently restricted, if so, no changes to the
      * existing registration of property names, data types, readability, or
      * writeability are allowed.
+     *
+     * @return <code>true</code> if this Mutable {@link DynaClass} is restricted,
+     * otherwise <code>false</code>
      */
     public boolean isRestricted();
 

Modified: jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java?view=diff&rev=469863&r1=469862&r2=469863
==============================================================================
--- jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java (original)
+++ jakarta/commons/proper/beanutils/trunk/src/java/org/apache/commons/beanutils/PropertyUtils.java Wed Nov  1 03:26:22 2006
@@ -98,6 +98,8 @@
     private static int debug = 0;
 
     /**
+     * The <code>debug</code> static property is no longer used
+     * @return debug property
      * @deprecated The <code>debug</code> static property is no longer used
      */
     public static int getDebug() {
@@ -105,6 +107,8 @@
     }
 
     /**
+     * The <code>debug</code> static property is no longer used
+     * @param newDebug debug property
      * @deprecated The <code>debug</code> static property is no longer used
      */
     public static void setDebug(int newDebug) {
@@ -138,6 +142,17 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param dest Destination bean whose properties are modified
+     * @param orig Origin bean whose properties are retrieved
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if the <code>dest</code> or
+     *  <code>orig</code> argument is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#copyProperties  
      */
     public static void copyProperties(Object dest, Object orig)
@@ -154,6 +169,16 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose properties are to be extracted
+     * @return The set of properties for the bean
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#describe  
      */
     public static Map describe(Object bean)
@@ -171,6 +196,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name <code>propertyname[index]</code> of the property value
+     *  to be extracted
+     * @return the indexed property value
+     *
+     * @exception ArrayIndexOutOfBoundsException if the specified index
+     *  is outside the valid range for the underlying array
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getIndexedProperty(Object,String)  
      */
     public static Object getIndexedProperty(Object bean, String name)
@@ -188,6 +228,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @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
+     *
+     * @exception ArrayIndexOutOfBoundsException if the specified index
+     *  is outside the valid range for the underlying array
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getIndexedProperty(Object,String, int)  
      */
     public static Object getIndexedProperty(Object bean,
@@ -205,6 +260,17 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name <code>propertyname(key)</code> of the property value
+     *  to be extracted
+     * @return the mapped property value
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getMappedProperty(Object,String)  
      */
     public static Object getMappedProperty(Object bean, String name)
@@ -222,6 +288,17 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getMappedProperty(Object,String, String)  
      */
     public static Object getMappedProperty(Object bean,
@@ -239,6 +316,8 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param beanClass Bean class to be introspected
+     * @return the mapped property descriptors
      * @see PropertyUtilsBean#getMappedPropertyDescriptors(Class)
      * @deprecated This method should not be exposed
      */
@@ -254,6 +333,8 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean to be introspected
+     * @return the mapped property descriptors
      * @see PropertyUtilsBean#getMappedPropertyDescriptors(Object)
      * @deprecated This method should not be exposed
      */
@@ -270,6 +351,20 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception NestedNullException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException 
+     * if the property accessor method throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getNestedProperty
      */
     public static Object getNestedProperty(Object bean, String name)
@@ -288,6 +383,19 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getProperty
      */
     public static Object getProperty(Object bean, String name)
@@ -306,6 +414,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getPropertyDescriptor
      */
     public static PropertyDescriptor getPropertyDescriptor(Object bean,
@@ -325,6 +448,9 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param beanClass Bean class for which property descriptors are requested
+     * @return the property descriptors
+     * @exception IllegalArgumentException if <code>beanClass</code> is null
      * @see PropertyUtilsBean#getPropertyDescriptors(Class)
      */
     public static PropertyDescriptor[]
@@ -342,6 +468,9 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean for which property descriptors are requested
+     * @return the property descriptors
+     * @exception IllegalArgumentException if <code>bean</code> is null
      * @see PropertyUtilsBean#getPropertyDescriptors(Object)
      */
     public static PropertyDescriptor[] getPropertyDescriptors(Object bean) {
@@ -357,6 +486,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getPropertyEditorClass(Object,String)
      */
     public static Class getPropertyEditorClass(Object bean, String name)
@@ -375,6 +519,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getPropertyType
      */
     public static Class getPropertyType(Object bean, String name)
@@ -391,6 +550,8 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param descriptor Property descriptor to return a getter for
+     * @return The read method
      * @see PropertyUtilsBean#getReadMethod
      */
     public static Method getReadMethod(PropertyDescriptor descriptor) {
@@ -406,6 +567,20 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be extracted
+     * @param name Name of the property to be extracted
+     * @return The property value
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if the property name
+     *  is nested or indexed
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#getSimpleProperty
      */
     public static Object getSimpleProperty(Object bean, String name)
@@ -423,6 +598,8 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param descriptor Property descriptor to return a setter for
+     * @return The write method
      * @see PropertyUtilsBean#getWriteMethod
      */
     public static Method getWriteMethod(PropertyDescriptor descriptor) {
@@ -439,6 +616,13 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean to be examined (may be a {@link DynaBean}
+     * @param name Property name to be evaluated
+     * @return <code>true</code> if the property is readable,
+     * otherwise <code>false</code>
+     *
+     * @exception IllegalArgumentException if <code>bean</code>
+     *  or <code>name</code> is <code>null</code>
      * @see PropertyUtilsBean#isReadable
      * @since BeanUtils 1.6
      */
@@ -455,6 +639,13 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean to be examined (may be a {@link DynaBean}
+     * @param name Property name to be evaluated
+     * @return <code>true</code> if the property is writeable,
+     * otherwise <code>false</code>
+     *
+     * @exception IllegalArgumentException if <code>bean</code>
+     *  or <code>name</code> is <code>null</code>
      * @see PropertyUtilsBean#isWriteable
      * @since BeanUtils 1.6
      */
@@ -470,6 +661,22 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be modified
+     * @param name <code>propertyname[index]</code> of the property value
+     *  to be modified
+     * @param value Value to which the specified property element
+     *  should be set
+     *
+     * @exception ArrayIndexOutOfBoundsException if the specified index
+     *  is outside the valid range for the underlying array
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setIndexedProperty(Object, String, Object)
      */
     public static void setIndexedProperty(Object bean, String name,
@@ -488,6 +695,21 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be set
+     * @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
+     *
+     * @exception ArrayIndexOutOfBoundsException if the specified index
+     *  is outside the valid range for the underlying array
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setIndexedProperty(Object, String, Object)
      */
     public static void setIndexedProperty(Object bean, String name,
@@ -505,6 +727,17 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be set
+     * @param name <code>propertyname(key)</code> of the property value
+     *  to be set
+     * @param value The property value to be set
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setMappedProperty(Object, String, Object)
      */
     public static void setMappedProperty(Object bean, String name,
@@ -522,6 +755,17 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @param bean Bean whose property is to be set
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setMappedProperty(Object, String, String, Object)
      */
     public static void setMappedProperty(Object bean, String name,
@@ -539,6 +783,20 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if a nested reference to a
+     *  property returns null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setNestedProperty
      */
     public static void setNestedProperty(Object bean,
@@ -557,6 +815,19 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setProperty
      */
     public static void setProperty(Object bean, String name, Object value)
@@ -574,6 +845,20 @@
      *
      * <p>For more details see <code>PropertyUtilsBean</code>.</p>
      *
+     * @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
+     *
+     * @exception IllegalAccessException if the caller does not have
+     *  access to the property accessor method
+     * @exception IllegalArgumentException if <code>bean</code> or
+     *  <code>name</code> is null
+     * @exception IllegalArgumentException if the property name is
+     *  nested or indexed
+     * @exception InvocationTargetException if the property accessor method
+     *  throws an exception
+     * @exception NoSuchMethodException if an accessor method for this
+     *  propety cannot be found
      * @see PropertyUtilsBean#setSimpleProperty
      */
     public static void setSimpleProperty(Object bean,



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message