org.codehaus.gmavenplus.util

Class ReflectionUtils

java.lang.Object

org.codehaus.gmavenplus.util.ReflectionUtils

public class ReflectionUtils
extends Object

Inspired heavily by Spring's ReflectionUtils.

Since:

1.0-beta-1

Author:

Juergen Hoeller, Rob Harrop, Rod Johnson, Costin Leau, Sam Brannen, Chris Beams, Keegan Witt

Method Summary

Modifier and Type	Method and Description
static Constructor<?>	findConstructor(Class<?> clazz, Class<?>... paramTypes) Attempt to find a Constructor on the supplied class with the supplied parameter types.
static Field	findField(Class<?> clazz, String name, Class<?> type) Attempt to find a field on the supplied Class with the supplied name and/or type.
static Method	findMethod(Class<?> clazz, String name, Class<?>... paramTypes) Attempt to find a Method on the supplied class with the supplied name and parameter types.
static Object	getEnumValue(Class<?> clazz, String valueName) Find and return the specified value from the specified enum class.
static Object	getField(Field field, Object target) Get the field represented by the supplied field object on the specified target object.
static Object	getStaticField(Field field) Get the field represented by the supplied field object on the specified target object.
static Object	invokeConstructor(Constructor<?> constructor, Object... args) Invoke the specified Constructor with the supplied arguments.
static Object	invokeMethod(Method method, Object target, Object... args) Invoke the specified Method against the supplied target object with the supplied arguments.
static Object	invokeStaticMethod(Method method, Object... args) Invoke the specified static Method with the supplied arguments.

Methods inherited from class java.lang.Object

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

Method Detail

findConstructor

public static Constructor<?> findConstructor(Class<?> clazz,
                                             Class<?>... paramTypes)

Attempt to find a Constructor on the supplied class with the supplied parameter types. Searches all superclasses up to Object.

Parameters:

clazz - The class to introspect

paramTypes - The parameter types of the method (may be null to indicate any signature)

Returns:

The Constructor object

findField

public static Field findField(Class<?> clazz,
                              String name,
                              Class<?> type)

Attempt to find a field on the supplied Class with the supplied name and/or type. Searches all superclasses up to Object.

Parameters:

clazz - The class to introspect

name - The name of the field (may be null if type is specified)

type - The type of the field (may be null if name is specified)

Returns:

The corresponding Field object

findMethod

public static Method findMethod(Class<?> clazz,
                                String name,
                                Class<?>... paramTypes)

Attempt to find a Method on the supplied class with the supplied name and parameter types. Searches all superclasses up to Object.

Parameters:

clazz - The class to introspect

name - The name of the method

paramTypes - The parameter types of the method (may be null to indicate any signature)

Returns:

The Method object

getEnumValue

public static Object getEnumValue(Class<?> clazz,
                                  String valueName)

Find and return the specified value from the specified enum class.

Parameters:

clazz - The enum class to introspect

valueName - The name of the enum value to get

Returns:

The enum value

getField

public static Object getField(Field field,
                              Object target)
                       throws IllegalAccessException

Get the field represented by the supplied field object on the specified target object. In accordance with Field.get(Object) semantics, the returned value is automatically wrapped if the underlying field has a primitive type.

Parameters:

field - The field to get

target - The target object from which to get the field

Returns:

The field's current value

Throws:

IllegalAccessException - when unable to access the specified field because access modifiers prevent it

getStaticField

public static Object getStaticField(Field field)
                             throws IllegalAccessException

Get the field represented by the supplied field object on the specified target object. In accordance with Field.get(Object) semantics, the returned value is automatically wrapped if the underlying field has a primitive type.

Parameters:

field - The field to get

Returns:

The field's current value

Throws:

IllegalAccessException - when unable to access the specified field because access modifiers prevent it

invokeConstructor

public static Object invokeConstructor(Constructor<?> constructor,
                                       Object... args)
                                throws InvocationTargetException,
                                       IllegalAccessException,
                                       InstantiationException

Invoke the specified Constructor with the supplied arguments.

Parameters:

constructor - The method to invoke

args - The invocation arguments (may be null)

Returns:

The invocation result, if any

Throws:

IllegalAccessException - when unable to access the specified constructor because access modifiers prevent it

InvocationTargetException - when a reflection invocation fails

InstantiationException - when an instantiation fails

invokeMethod

public static Object invokeMethod(Method method,
                                  Object target,
                                  Object... args)
                           throws InvocationTargetException,
                                  IllegalAccessException

Invoke the specified Method against the supplied target object with the supplied arguments. The target object can be null when invoking a static Method.

Parameters:

method - The method to invoke

target - The target object to invoke the method on

args - The invocation arguments (may be null)

Returns:

The invocation result, if any

Throws:

IllegalAccessException - when unable to access the specified method because access modifiers prevent it

InvocationTargetException - when a reflection invocation fails

invokeStaticMethod

public static Object invokeStaticMethod(Method method,
                                        Object... args)
                                 throws InvocationTargetException,
                                        IllegalAccessException

Invoke the specified static Method with the supplied arguments.

Parameters:

method - The method to invoke

args - The invocation arguments (may be null)

Returns:

The invocation result, if any

Throws:

IllegalAccessException - when unable to access the specified method because access modifiers prevent it

InvocationTargetException - when a reflection invocation fails