Overview Package Class Use Tree Index Deprecated About
Prev Class | Next ClassFrames | No Frames
Summary: Nested | Field | Method | ConstrDetail: Nested | Field | Method | Constr

org.codehaus.plexus.util.reflection

Class Reflector

public final class Reflector
extends java.lang.Object
Utility class used to instantiate an object using reflection. This utility hides many of the gory details needed to do this.
Author:
John Casey

Field Summary

private static String
CONSTRUCTOR_METHOD_NAME
private static String
GET_INSTANCE_METHOD_NAME
private HashMap
classMaps

Constructor Summary

Reflector()
Ensure no instances of Reflector are created...this is a utility.

Method Summary

private Method
_getMethod(Class targetClass, String methodName, Class[] params)
Constructor
getConstructor(Class targetClass, Class[] params)
Return the constructor, checking the cache first and storing in cache if not already there..
private Map
getConstructorMap(Class theClass)
Retrieve the cache of constructors for the specified class.
Object
getField(Object target, String fieldName)
Object
getField(Object target, String fieldName, boolean breakAccessibility)
Method
getMethod(Class targetClass, String methodName, Class[] params)
Return the method, checking the cache first and storing in cache if not already there..
private Map
getMethodMap(Class theClass, String methodName)
Retrieve the cache of methods for the specified class and method name.
Object
getObjectProperty(Object target, String propertyName)
Object
getSingleton(Class theClass, Object[] initParams)
Retrieve the singleton instance of a class, given the array of parameters...
Object
getStaticField(Class targetClass, String fieldName)
Object
invoke(Object target, String methodName, Object[] params)
Invoke the specified method on the specified target with the specified params...
Object
invokeStatic(Class targetClass, String methodName, Object[] params)
Invoke the specified static method with the specified params...
Object
newInstance(Class theClass, Object[] params)
Create a new instance of a class, given the array of parameters...

Field Details

CONSTRUCTOR_METHOD_NAME

private static final String CONSTRUCTOR_METHOD_NAME

GET_INSTANCE_METHOD_NAME

private static final String GET_INSTANCE_METHOD_NAME

classMaps

private HashMap classMaps

Constructor Details

Reflector

public Reflector()
Ensure no instances of Reflector are created...this is a utility.

Method Details

_getMethod

private Method _getMethod(Class targetClass,
                          String methodName,
                          Class[] params)
            throws ReflectorException

getConstructor

public Constructor getConstructor(Class targetClass,
                                  Class[] params)
            throws ReflectorException
Return the constructor, checking the cache first and storing in cache if not already there..
Parameters:
targetClass - The class to get the constructor from
params - The classes of the parameters which the constructor should match.
Returns:
the Constructor object that matches.
Throws:
ReflectorException - In case we can't retrieve the proper constructor.

getConstructorMap

private Map getConstructorMap(Class theClass)
            throws ReflectorException
Retrieve the cache of constructors for the specified class.
Parameters:
theClass - the class to lookup.
Returns:
The cache of constructors.
Throws:
ReflectorException - in case of a lookup error.

getField

public Object getField(Object target,
                       String fieldName)
            throws ReflectorException

getField

public Object getField(Object target,
                       String fieldName,
                       boolean breakAccessibility)
            throws ReflectorException

getMethod

public Method getMethod(Class targetClass,
                        String methodName,
                        Class[] params)
            throws ReflectorException
Return the method, checking the cache first and storing in cache if not already there..
Parameters:
targetClass - The class to get the method from
params - The classes of the parameters which the method should match.
Returns:
the Method object that matches.
Throws:
ReflectorException - In case we can't retrieve the proper method.

getMethodMap

private Map getMethodMap(Class theClass,
                         String methodName)
            throws ReflectorException
Retrieve the cache of methods for the specified class and method name.
Parameters:
theClass - the class to lookup.
methodName - The name of the method to lookup.
Returns:
The cache of constructors.
Throws:
ReflectorException - in case of a lookup error.

getObjectProperty

public Object getObjectProperty(Object target,
                                String propertyName)
            throws ReflectorException

getSingleton

public Object getSingleton(Class theClass,
                           Object[] initParams)
            throws ReflectorException
Retrieve the singleton instance of a class, given the array of parameters... Uses constructor caching to find a constructor that matches the parameter types, either specifically (first choice) or abstractly...
Parameters:
theClass - The class to retrieve the singleton of
initParams - The parameters to pass to the constructor
Returns:
The singleton object
Throws:
ReflectorException - In case anything goes wrong here...

getStaticField

public Object getStaticField(Class targetClass,
                             String fieldName)
            throws ReflectorException

invoke

public Object invoke(Object target,
                     String methodName,
                     Object[] params)
            throws ReflectorException
Invoke the specified method on the specified target with the specified params...
Parameters:
target - The target of the invocation
methodName - The method name to invoke
params - The parameters to pass to the method invocation
Returns:
The result of the method call
Throws:
ReflectorException - In case of an error looking up or invoking the method.

invokeStatic

public Object invokeStatic(Class targetClass,
                           String methodName,
                           Object[] params)
            throws ReflectorException
Invoke the specified static method with the specified params...
Parameters:
targetClass - The target class of the invocation
methodName - The method name to invoke
params - The parameters to pass to the method invocation
Returns:
The result of the method call
Throws:
ReflectorException - In case of an error looking up or invoking the method.

newInstance

public Object newInstance(Class theClass,
                          Object[] params)
            throws ReflectorException
Create a new instance of a class, given the array of parameters... Uses constructor caching to find a constructor that matches the parameter types, either specifically (first choice) or abstractly...
Parameters:
theClass - The class to instantiate
params - The parameters to pass to the constructor
Returns:
The instantiated object
Throws:
ReflectorException - In case anything goes wrong here...

Overview Package Class Use Tree Index Deprecated About