|
|||||||||
| Home >> All >> org >> apache >> commons >> [ beanutils overview ] | PREV CLASS NEXT CLASS | ||||||||
SUMMARY: JAVADOC | SOURCE | DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||
org.apache.commons.beanutils
Class BeanUtils

java.lang.Objectorg.apache.commons.beanutils.BeanUtils
- public class BeanUtils
- extends java.lang.Object
Utility methods for populating JavaBeans properties via reflection.
The implementations are provided by BeanUtilsBean.
These static utility methods use the default instance.
More sophisticated behaviour can be provided by using a BeanUtilsBean instance.
- Version:
- $Revision: 1.40 $ $Date: 2004/02/28 13:18:33 $
| Field Summary | |
private static int |
debug
Deprecated. BeanUtils now uses commons-logging for all log messages. Use your favorite logging tool to configure logging for this class. |
private static org.apache.commons.collections.FastHashMap |
dummy
Dummy collection from the Commons Collections API, to force a ClassNotFoundException if commons-collections.jar is not present in the runtime classpath, and this class is the first one referenced. |
| Constructor Summary | |
BeanUtils()
|
|
| Method Summary | |
static java.lang.Object |
cloneBean(java.lang.Object bean)
Clone a bean based on the available property getters and setters, even if the bean class itself does not implement Cloneable. |
static void |
copyProperties(java.lang.Object dest,
java.lang.Object orig)
Copy property values from the origin bean to the destination bean for all cases where the property names are the same. |
static void |
copyProperty(java.lang.Object bean,
java.lang.String name,
java.lang.Object value)
Copy the specified property value to the specified destination bean, performing any type conversion that is required. |
static java.util.Map |
describe(java.lang.Object bean)
Return the entire set of properties for which the specified bean provides a read method. |
static java.lang.String[] |
getArrayProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the specified array property of the specified bean, as a String array. |
static int |
getDebug()
Deprecated. BeanUtils now uses commons-logging for all log messages. Use your favorite logging tool to configure logging for this class. |
static java.lang.String |
getIndexedProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the specified indexed property of the specified bean, as a String. |
static java.lang.String |
getIndexedProperty(java.lang.Object bean,
java.lang.String name,
int index)
Return the value of the specified indexed property of the specified bean, as a String. |
static java.lang.String |
getMappedProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the specified indexed property of the specified bean, as a String. |
static java.lang.String |
getMappedProperty(java.lang.Object bean,
java.lang.String name,
java.lang.String key)
Return the value of the specified mapped property of the specified bean, as a String. |
static java.lang.String |
getNestedProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the (possibly nested) property of the specified name, for the specified bean, as a String. |
static java.lang.String |
getProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the specified property of the specified bean, no matter which property reference format is used, as a String. |
static java.lang.String |
getSimpleProperty(java.lang.Object bean,
java.lang.String name)
Return the value of the specified simple property of the specified bean, converted to a String. |
static void |
populate(java.lang.Object bean,
java.util.Map properties)
Populate the JavaBeans properties of the specified bean, based on the specified name/value pairs. |
static void |
setDebug(int newDebug)
Deprecated. BeanUtils now uses commons-logging for all log messages. Use your favorite logging tool to configure logging for this class. |
static void |
setProperty(java.lang.Object bean,
java.lang.String name,
java.lang.Object value)
Set the specified property value, performing type conversions as required to conform to the type of the destination property. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
dummy
private static org.apache.commons.collections.FastHashMap dummy
- Dummy collection from the Commons Collections API, to force a
ClassNotFoundException if commons-collections.jar is not present in the
runtime classpath, and this class is the first one referenced.
Otherwise, the ClassNotFoundException thrown by ConvertUtils or
PropertyUtils can get masked.
debug
private static int debug
- Deprecated. BeanUtils now uses commons-logging for all log messages.
Use your favorite logging tool to configure logging for
this class.
- The debugging detail level for this component.
- The debugging detail level for this component.
| Constructor Detail |
BeanUtils
public BeanUtils()
| Method Detail |
getDebug
public static int getDebug()
- Deprecated. BeanUtils now uses commons-logging for all log messages.
Use your favorite logging tool to configure logging for
this class.
setDebug
public static void setDebug(int newDebug)
- Deprecated. BeanUtils now uses commons-logging for all log messages.
Use your favorite logging tool to configure logging for
this class.
cloneBean
public static java.lang.Object cloneBean(java.lang.Object bean) throws java.lang.IllegalAccessException, java.lang.InstantiationException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Clone a bean based on the available property getters and setters, even if the bean class itself does not implement Cloneable.
For more details see
BeanUtilsBean.
copyProperties
public static void copyProperties(java.lang.Object dest, java.lang.Object orig) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
Copy property values from the origin bean to the destination bean for all cases where the property names are the same.
For more details see
BeanUtilsBean.
copyProperty
public static void copyProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
Copy the specified property value to the specified destination bean, performing any type conversion that is required.
For more details see
BeanUtilsBean.
describe
public static java.util.Map describe(java.lang.Object bean) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the entire set of properties for which the specified bean provides a read method.
For more details see
BeanUtilsBean.
getArrayProperty
public static java.lang.String[] getArrayProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the value of the specified array property of the specified bean, as a String array.
For more details see
BeanUtilsBean.
getIndexedProperty
public static java.lang.String getIndexedProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the value of the specified indexed property of the specified bean, as a String.
For more details see
BeanUtilsBean.
getIndexedProperty
public static java.lang.String getIndexedProperty(java.lang.Object bean, java.lang.String name, int index) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
- Return the value of the specified indexed property of the specified
bean, as a String. The index is specified as a method parameter and
must *not* be included in the property name expression
For more details see
BeanUtilsBean.
getMappedProperty
public static java.lang.String getMappedProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
- Return the value of the specified indexed property of the specified
bean, as a String.
For more details see
BeanUtilsBean.
getMappedProperty
public static java.lang.String getMappedProperty(java.lang.Object bean, java.lang.String name, java.lang.String key) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
- Return the value of the specified mapped property of the specified
bean, as a String.
For more details see
BeanUtilsBean.
getNestedProperty
public static java.lang.String getNestedProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the value of the (possibly nested) property of the specified name, for the specified bean, as a String.
For more details see
BeanUtilsBean.
getProperty
public static java.lang.String getProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the value of the specified property of the specified bean, no matter which property reference format is used, as a String.
For more details see
BeanUtilsBean.
getSimpleProperty
public static java.lang.String getSimpleProperty(java.lang.Object bean, java.lang.String name) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException, java.lang.NoSuchMethodException
Return the value of the specified simple property of the specified bean, converted to a String.
For more details see
BeanUtilsBean.
populate
public static void populate(java.lang.Object bean, java.util.Map properties) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
Populate the JavaBeans properties of the specified bean, based on the specified name/value pairs.
For more details see
BeanUtilsBean.
setProperty
public static void setProperty(java.lang.Object bean, java.lang.String name, java.lang.Object value) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
Set the specified property value, performing type conversions as required to conform to the type of the destination property.
For more details see
BeanUtilsBean.
|
|||||||||
| Home >> All >> org >> apache >> commons >> [ beanutils overview ] | PREV CLASS NEXT CLASS | ||||||||
SUMMARY: JAVADOC | SOURCE | DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||
JAVADOC
org.apache.commons.beanutils.BeanUtils