BeanUtils (Bean Introspection Utilities (Version 1.7))

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.commons.beanutils
Class BeanUtils

java.lang.Object
  |
  +--org.apache.commons.beanutils.BeanUtils

Direct Known Subclasses:: LocaleBeanUtils

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 $
Author:: Craig R. McClanahan, Ralph Schaer, Chris Audley, Rey François, Gregor Raıman
See Also:: BeanUtilsBean

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 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 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.

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.