org.apache.bval.util.reflection

Class Reflection

java.lang.Object

org.apache.bval.util.reflection.Reflection

public class Reflection
extends Object

Security-agnostic "blueprint" class for reflection-related operations. Intended for use by Apache BVal code.

Constructor Summary

Constructors

Constructor and Description
Reflection()

Method Summary

Modifier and Type	Method and Description
static Object	getAnnotationValue(Annotation annotation, String name) Get the named value from the specified Annotation.
static ClassLoader	getClassLoader(Class<?> clazz) Get a usable ClassLoader: that of clazz if Thread.getContextClassLoader() returns null.
static <T> Constructor<T>	getDeclaredConstructor(Class<T> clazz, Class<?>... parameters) Get the declared constructor from clazz.
static Constructor<?>[]	getDeclaredConstructors(Class<?> clazz)
static Field	getDeclaredField(Class<?> clazz, String fieldName) Get the declared field from clazz.
static Field[]	getDeclaredFields(Class<?> clazz)
static Method	getDeclaredMethod(Class<?> clazz, String name, Class<?>... parameters) Get the declared method from clazz.
static Method[]	getDeclaredMethods(Class<?> clazz)
static String	getProperty(String name)
static Method	getPublicMethod(Class<?> clazz, String methodName, Class<?>... parameterTypes) Get the specified public Method from clazz.
static <T> T	newInstance(Class<T> cls) Construct a new instance of cls using its default constructor.
static Class<?>	primitiveToWrapper(Class<?> cls) Converts the specified primitive Class object to its corresponding wrapper Class object.
static boolean	setAccessible(AccessibleObject o, boolean accessible) Set the accessibility of o to accessible.
static Class<?>	toClass(String className)
static Class	toClass(String className, boolean resolve, ClassLoader loader) Return the class for the given string, correctly handling primitive types.
static Class	toClass(String className, ClassLoader loader) Return the class for the given string, correctly handling primitive types.
static Class<?>	wrapperToPrimitive(Class<?> cls)

Methods inherited from class java.lang.Object

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

Constructor Detail

Reflection

public Reflection()

Method Detail

primitiveToWrapper

public static Class<?> primitiveToWrapper(Class<?> cls)

Converts the specified primitive Class object to its corresponding wrapper Class object.

NOTE: From v2.2, this method handles Void.TYPE, returning Void.TYPE.

Parameters:

cls - the class to convert, may be null

Returns:

the wrapper class for cls or cls if cls is not a primitive. null if null input.

Since:

2.1

wrapperToPrimitive

public static Class<?> wrapperToPrimitive(Class<?> cls)

getAnnotationValue

public static Object getAnnotationValue(Annotation annotation,
                                        String name)
                                 throws IllegalAccessException,
                                        InvocationTargetException

Get the named value from the specified Annotation.

Parameters:

annotation -

name -

Returns:

Object value

Throws:

IllegalAccessException

InvocationTargetException

getClassLoader

public static ClassLoader getClassLoader(Class<?> clazz)

Get a usable ClassLoader: that of clazz if Thread.getContextClassLoader() returns null.

Parameters:

clazz -

Returns:

ClassLoader

toClass

public static Class<?> toClass(String className)
                        throws ClassNotFoundException

Throws:

ClassNotFoundException

toClass

public static Class toClass(String className,
                            ClassLoader loader)
                     throws ClassNotFoundException

Return the class for the given string, correctly handling primitive types. If the given class loader is null, the context loader of the current thread will be used.

Throws:

RuntimeException - on load error

ClassNotFoundException

toClass

public static Class toClass(String className,
                            boolean resolve,
                            ClassLoader loader)
                     throws ClassNotFoundException

Return the class for the given string, correctly handling primitive types. If the given class loader is null, the context loader of the current thread will be used.

Throws:

RuntimeException - on load error

ClassNotFoundException

getProperty

public static String getProperty(String name)

Parameters:

name -

Returns:

String

getDeclaredField

public static Field getDeclaredField(Class<?> clazz,
                                     String fieldName)

Get the declared field from clazz.

Parameters:

clazz -

fieldName -

Returns:

Field or null

getDeclaredFields

public static Field[] getDeclaredFields(Class<?> clazz)

Parameters:

clazz -

Returns:

Field array

getDeclaredConstructor

public static <T> Constructor<T> getDeclaredConstructor(Class<T> clazz,
                                                        Class<?>... parameters)

Get the declared constructor from clazz.

Parameters:

clazz -

parameters -

Returns:

Constructor or null

getDeclaredMethod

public static Method getDeclaredMethod(Class<?> clazz,
                                       String name,
                                       Class<?>... parameters)

Get the declared method from clazz.

Parameters:

clazz -

name -

parameters -

Returns:

Method or null

getDeclaredMethods

public static Method[] getDeclaredMethods(Class<?> clazz)

Parameters:

clazz -

Returns:

Method array

getDeclaredConstructors

public static Constructor<?>[] getDeclaredConstructors(Class<?> clazz)

Parameters:

clazz -

Returns:

Constructor array

getPublicMethod

public static Method getPublicMethod(Class<?> clazz,
                                     String methodName,
                                     Class<?>... parameterTypes)

Get the specified public Method from clazz.

Parameters:

clazz -

methodName -

Returns:

Method or null

newInstance

public static <T> T newInstance(Class<T> cls)

Construct a new instance of cls using its default constructor.

Parameters:

cls -

Returns:

T

setAccessible

public static boolean setAccessible(AccessibleObject o,
                                    boolean accessible)

Set the accessibility of o to accessible. If running without a SecurityManager and accessible == false, this call is ignored (because any code could reflectively make any object accessible at any time).

Parameters:

o -

accessible -

Returns:

whether a change was made.