svn commit: r1441881 - /commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java

[br...@apache.org]

Author: britter
Date: Sun Feb  3 09:56:42 2013
New Revision: 1441881

URL: http://svn.apache.org/viewvc?rev=1441881&view=rev
Log:
Some more JavaDoc for BeanUtils. No functional changes.

Modified:
    commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java

Modified: commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java
URL: http://svn.apache.org/viewvc/commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java?rev=1441881&r1=1441880&r2=1441881&view=diff
==============================================================================
--- commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java (original)
+++ commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/BeanUtils.java Sun Feb  3 09:56:42 2013
@@ -35,22 +35,39 @@ public final class BeanUtils
 
     // POJO/JavaBean stuff
 
+    /**
+     * Create a {@link BeanAcessor} for the given bean, that allows access to the bean's properties and methods.
+     *
+     * @param bean the bean to be accessed. Must not be {@code null}!
+     * @return a BeanAccessor for the given bean.
+     */
     public static <B> BeanAccessor<B> on( B bean )
     {
         bean = checkNotNull( bean, "No bean specified" );
-
         return new DefaultBeanAccessor<B>( bean );
     }
 
     // introspection stuff
 
+    /**
+     * Creates a {@link ClassAccessor} for the given type that allows for creating instances of the type and calling
+     * static methods.
+     *
+     * @param beanType the type to be accessed. Must not be {@code null}!
+     * @return a ClassAccessor for the given type.
+     */
     public static <B> ClassAccessor<B> on( Class<B> beanType )
     {
         beanType = checkNotNull( beanType, "No bean class specified" );
-
         return new DefaultClassAccessor<B>( beanType );
     }
 
+    /**
+     * Creates a {@link ClassLoaderBuilder} that allows to load the type given by {@code beanTypeName}.
+     *
+     * @param beanTypeName the name of the type to load. Must not be {@code null}!
+     * @return the ClassLoaderBuilder for the given type name.
+     */
     public static ClassLoaderBuilder onClassName( String beanTypeName )
     {
         beanTypeName = checkNotNull( beanTypeName, "No bean class name specified" );