org.springframework.beans
Class BeanUtils

java.lang.Object
  org.springframework.beans.BeanUtils

public abstract class BeanUtils

extends java.lang.Object

Static convenience methods for JavaBeans, for instantiating beans, copying bean properties, etc.

Mainly for use within the framework, but to some degree also useful for application classes.

Author:

Rod Johnson, Juergen Hoeller

Constructor Summary

BeanUtils()

Method Summary

static void	copyProperties(java.lang.Object source, java.lang.Object target) Copy the property values of the given source bean into the target bean.
static void	copyProperties(java.lang.Object source, java.lang.Object target, java.lang.String[] ignoreProperties) Copy the property values of the given source bean into the given target bean, ignoring the given ignoreProperties.
static java.lang.reflect.Method	findDeclaredMethod(java.lang.Class clazz, java.lang.String methodName, java.lang.Class[] paramTypes) Find a method with the given method name and the given parameter types, declared on the given class or one of its superclasses.
static java.lang.reflect.Method	findDeclaredMethodWithMinimalParameters(java.lang.Class clazz, java.lang.String methodName) Find a method with the given method name and minimal parameters (best case: none), declared on the given class or one of its superclasses.
static java.lang.reflect.Method	findMethod(java.lang.Class clazz, java.lang.String methodName, java.lang.Class[] paramTypes) Find a method with the given method name and the given parameter types, declared on the given class or one of its superclasses.
static java.lang.reflect.Method	findMethodWithMinimalParameters(java.lang.Class clazz, java.lang.String methodName) Find a method with the given method name and minimal parameters (best case: none), declared on the given class or one of its superclasses.
static java.lang.Object	instantiateClass(java.lang.Class clazz) Convenience method to instantiate a class using its no-arg constructor.
static java.lang.Object	instantiateClass(java.lang.reflect.Constructor ctor, java.lang.Object[] args) Convenience method to instantiate a class using the given constructor.
static boolean	isAssignable(java.lang.Class targetType, java.lang.Class valueType) Determine if the given target type is assignable from the given value type, assuming setting by reflection.
static boolean	isAssignable(java.lang.Class type, java.lang.Object value) Determine if the given type is assignable from the given value, assuming setting by reflection.
static boolean	isPrimitiveArray(java.lang.Class clazz) Check if the given class represents a primitive array, i.e. boolean, byte, char, short, int, long, float, or double.
static boolean	isPrimitiveWrapperArray(java.lang.Class clazz) Check if the given class represents an array of primitive wrappers, i.e.
static boolean	isSimpleProperty(java.lang.Class clazz) Check if the given class represents a "simple" property, i.e. a primitive, a String, a Class, or a corresponding array.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BeanUtils

public BeanUtils()

Method Detail

instantiateClass

public static java.lang.Object instantiateClass(java.lang.Class clazz)
                                         throws BeansException

Convenience method to instantiate a class using its no-arg constructor. As this method doesn't try to load classes by name, it should avoid class-loading issues.

Note that this method tries to set the constructor accessible if given a non-accessible (i.e. non-public) constructor.

Parameters:

clazz - class to instantiate

Returns:

the new instance

Throws:

BeansException

instantiateClass

public static java.lang.Object instantiateClass(java.lang.reflect.Constructor ctor,
                                                java.lang.Object[] args)
                                         throws BeansException

Convenience method to instantiate a class using the given constructor. As this method doesn't try to load classes by name, it should avoid class-loading issues.

Note that this method tries to set the constructor accessible if given a non-accessible (i.e. non-public) constructor.

Parameters:

ctor - constructor to instantiate

Returns:

the new instance

Throws:

BeansException

findMethod

public static java.lang.reflect.Method findMethod(java.lang.Class clazz,
                                                  java.lang.String methodName,
                                                  java.lang.Class[] paramTypes)

Find a method with the given method name and the given parameter types, declared on the given class or one of its superclasses. Prefers public methods, but will return a protected, package access, or private method too.

Checks Class.getMethod first, falling back to findDeclaredMethod. This allows to find public methods without issues even in environments with restricted Java security settings.

Parameters:

clazz - the class to check

methodName - the name of the method to find

paramTypes - the parameter types of the method to find

Returns:

the method object, or null if not found

See Also:

Class.getMethod(java.lang.String, java.lang.Class[]), findDeclaredMethod(java.lang.Class, java.lang.String, java.lang.Class[])

findDeclaredMethod

public static java.lang.reflect.Method findDeclaredMethod(java.lang.Class clazz,
                                                          java.lang.String methodName,
                                                          java.lang.Class[] paramTypes)

Find a method with the given method name and the given parameter types, declared on the given class or one of its superclasses. Will return a public, protected, package access, or private method.

Checks Class.getDeclaredMethod, cascading upwards to all superclasses.

Parameters:

clazz - the class to check

methodName - the name of the method to find

paramTypes - the parameter types of the method to find

Returns:

the method object, or null if not found

See Also:

Class.getDeclaredMethod(java.lang.String, java.lang.Class[])

findMethodWithMinimalParameters

public static java.lang.reflect.Method findMethodWithMinimalParameters(java.lang.Class clazz,
                                                                       java.lang.String methodName)

Find a method with the given method name and minimal parameters (best case: none), declared on the given class or one of its superclasses. Prefers public methods, but will return a protected, package access, or private method too.

Checks Class.getMethods first, falling back to findDeclaredMethodWithMinimalParameters. This allows to find public methods without issues even in environments with restricted Java security settings.

Parameters:

clazz - the class to check

methodName - the name of the method to find

Returns:

the method object, or null if not found

See Also:

Class.getMethods(), findDeclaredMethodWithMinimalParameters(java.lang.Class, java.lang.String)

findDeclaredMethodWithMinimalParameters

public static java.lang.reflect.Method findDeclaredMethodWithMinimalParameters(java.lang.Class clazz,
                                                                               java.lang.String methodName)

Find a method with the given method name and minimal parameters (best case: none), declared on the given class or one of its superclasses. Will return a public, protected, package access, or private method.

Checks Class.getDeclaredMethods, cascading upwards to all superclasses.

Parameters:

clazz - the class to check

methodName - the name of the method to find

Returns:

the method object, or null if not found

See Also:

Class.getDeclaredMethods()

isAssignable

public static boolean isAssignable(java.lang.Class type,
                                   java.lang.Object value)

Determine if the given type is assignable from the given value, assuming setting by reflection. Considers primitive wrapper classes as assignable to the corresponding primitive types.

For example used in a bean factory's constructor resolution.

Parameters:

type - the target type

value - the value that should be assigned to the type

Returns:

if the type is assignable from the value

isAssignable

public static boolean isAssignable(java.lang.Class targetType,
                                   java.lang.Class valueType)

Determine if the given target type is assignable from the given value type, assuming setting by reflection. Considers primitive wrapper classes as assignable to the corresponding primitive types.

For example used in BeanWrapperImpl's custom editor matrching.

Parameters:

targetType - the target type

valueType - the value type that should be assigned to the target type

Returns:

if the target type is assignable from the value type

isSimpleProperty

public static boolean isSimpleProperty(java.lang.Class clazz)

Check if the given class represents a "simple" property, i.e. a primitive, a String, a Class, or a corresponding array. Used to determine properties to check for a "simple" dependency-check.

See Also:

AbstractBeanDefinition.DEPENDENCY_CHECK_SIMPLE, AbstractAutowireCapableBeanFactory.dependencyCheck(java.lang.String, org.springframework.beans.factory.support.RootBeanDefinition, org.springframework.beans.BeanWrapper, org.springframework.beans.PropertyValues)

isPrimitiveArray

public static boolean isPrimitiveArray(java.lang.Class clazz)

Check if the given class represents a primitive array, i.e. boolean, byte, char, short, int, long, float, or double.

isPrimitiveWrapperArray

public static boolean isPrimitiveWrapperArray(java.lang.Class clazz)

Check if the given class represents an array of primitive wrappers, i.e. Boolean, Byte, Character, Short, Integer, Long, Float, or Double.

copyProperties

public static void copyProperties(java.lang.Object source,
                                  java.lang.Object target)
                           throws java.lang.IllegalArgumentException,
                                  BeansException

Copy the property values of the given source bean into the target bean.

Parameters:

source - source bean

target - target bean

Throws:

java.lang.IllegalArgumentException - if the classes of source and target do not match

BeansException

copyProperties

public static void copyProperties(java.lang.Object source,
                                  java.lang.Object target,
                                  java.lang.String[] ignoreProperties)
                           throws java.lang.IllegalArgumentException,
                                  BeansException

Copy the property values of the given source bean into the given target bean, ignoring the given ignoreProperties.

Parameters:

source - source bean

target - target bean

ignoreProperties - array of property names to ignore

Throws:

java.lang.IllegalArgumentException - if the classes of source and target do not match

BeansException