com.frameworkset.util

Class BeanUtils

java.lang.Object

com.frameworkset.util.BeanUtils

public abstract class BeanUtils
extends java.lang.Object

Title: BeanUtils.java

Description:

bboss workgroup

Copyright (c) 2008

Constructor Summary

Constructors

Constructor and Description
BeanUtils()

Method Summary

Modifier and Type	Method and Description
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 MethodParameter	getWriteMethodParameter(java.beans.PropertyDescriptor pd) Obtain a new MethodParameter object for the write method of the specified property.
static <T> T	instantiate(java.lang.Class<T> clazz) Convenience method to instantiate a class using its no-arg constructor.
static <T> T	instantiateClass(java.lang.Class<T> clazz) Convenience method to instantiate a class using its no-arg constructor.
static <T> T	instantiateClass(java.lang.Class<T> type, java.lang.reflect.Constructor ctor, java.lang.Object[] args) Convenience method to instantiate a class using the given 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 java.lang.Object	instantiateClass(java.lang.String clazz) Convenience method to instantiate a class using its no-arg 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) Deprecated. as of Bboss 2.0, in favor of ClassUtils.isAssignableValue
static boolean	isSimpleProperty(java.lang.Class clazz) Check if the given type represents a "simple" property: a primitive, a String or other CharSequence, a Number, a Date, a URI, a URL, a Locale, a Class, or a corresponding array.
static boolean	isSimpleValueType(java.lang.Class clazz) Check if the given type represents a "simple" value type: a primitive, a String or other CharSequence, a Number, a Date, a URI, a URL, a Locale or a Class.

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 <T> T instantiateClass(java.lang.Class<T> clazz)
                              throws BeanInstantiationException

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 (that is, non-public) constructor.

Parameters:

clazz - class to instantiate

Returns:

the new instance

Throws:

BeanInstantiationException - if the bean cannot be instantiated

instantiate

public static <T> T instantiate(java.lang.Class<T> clazz)
                         throws BeanInstantiationException

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.

Parameters:

clazz - class to instantiate

Returns:

the new instance

Throws:

BeanInstantiationException - if the bean cannot be instantiated

instantiateClass

public static java.lang.Object instantiateClass(java.lang.String clazz)
                                         throws BeanInstantiationException

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 (that is, non-public) constructor.

Parameters:

clazz - class to instantiate

Returns:

the new instance

Throws:

BeanInstantiationException - if the bean cannot be instantiated

instantiateClass

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

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 (that is, non-public) constructor.

Parameters:

ctor - the constructor to instantiate

args - the constructor arguments to apply

Returns:

the new instance

Throws:

BeanInstantiationException - if the bean cannot be instantiated

instantiateClass

public static <T> T instantiateClass(java.lang.Class<T> type,
                                     java.lang.reflect.Constructor ctor,
                                     java.lang.Object[] args)
                              throws BeanInstantiationException

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 (that is, non-public) constructor.

Parameters:

ctor - the constructor to instantiate

args - the constructor arguments to apply

Returns:

the new instance

Throws:

BeanInstantiationException - if the bean cannot be instantiated

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)
                                                                throws java.lang.IllegalArgumentException

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

Throws:

java.lang.IllegalArgumentException - if methods of the given name were found but could not be resolved to a unique method with minimal parameters

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)
                                                                        throws java.lang.IllegalArgumentException

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

Throws:

java.lang.IllegalArgumentException - if methods of the given name were found but could not be resolved to a unique method with minimal parameters

See Also:

Class.getDeclaredMethods()

isSimpleProperty

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

Check if the given type represents a "simple" property: a primitive, a String or other CharSequence, a Number, a Date, a URI, a URL, a Locale, a Class, or a corresponding array.

Used to determine properties to check for a "simple" dependency-check.

Parameters:

clazz - the type to check

Returns:

whether the given type represents a "simple" property

isSimpleValueType

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

Check if the given type represents a "simple" value type: a primitive, a String or other CharSequence, a Number, a Date, a URI, a URL, a Locale or a Class.

Parameters:

clazz - the type to check

Returns:

whether the given type represents a "simple" value type

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.

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 ClassUtils#isAssignable(Class, Class)

isAssignable

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

Deprecated. as of Bboss 2.0, in favor of ClassUtils.isAssignableValue

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.

Parameters:

type - the target type

value - the value that should be assigned to the type

Returns:

if the type is assignable from the value

See Also:

ClassUtils.isAssignableValue(Class, Object)

getWriteMethodParameter

public static MethodParameter getWriteMethodParameter(java.beans.PropertyDescriptor pd)

Obtain a new MethodParameter object for the write method of the specified property.

Parameters:

pd - the PropertyDescriptor for the property

Returns:

a corresponding MethodParameter object