desmoj.extensions.experimentation.reflect

Class ReflectionManager

java.lang.Object

desmoj.extensions.experimentation.reflect.ReflectionManager

public class ReflectionManager
extends java.lang.Object

A utility class for using the Java Reflection API.

Version:

DESMO-J, Ver. 2.5.1c copyright (c) 2015

Author:

Nicolas Knaak Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Constructor Summary

Constructors

Constructor and Description
ReflectionManager()

Method Summary

Modifier and Type	Method and Description
static java.lang.reflect.Constructor	getConstructor(java.lang.Class c, java.lang.Class[] params) Retrieves a constructor from a given class.
static java.lang.reflect.Field	getField(java.lang.Class c, java.lang.String fieldName) Retrieves a field from a given class.
static java.lang.reflect.Method	getMethod(java.lang.Class c, java.lang.String methodName) Retrieves a method of a given class with an empty parameter list.
static java.lang.reflect.Method	getMethod(java.lang.Class c, java.lang.String methodName, java.lang.Class[] params) Retrieves a method of a given class.
static java.lang.Object	getValue(java.lang.Object owner, java.lang.reflect.Field field) Returns the value of the given field has in the specified object.
static java.lang.Object	invokeConstructor(java.lang.reflect.Constructor c, java.lang.Object[] args) Invokes a constructor.
static java.lang.Object	invokeMethod(java.lang.Object owner, java.lang.reflect.Method method, java.lang.Object[] args) Invokes a method on an object If anything goes wrong a reflect exception is thrown
static void	setValue(java.lang.Object owner, java.lang.reflect.Field field, java.lang.Object value) Sets the value of the given field of the specified object.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionManager

public ReflectionManager()

Method Detail

getMethod

public static java.lang.reflect.Method getMethod(java.lang.Class c,
                                                 java.lang.String methodName,
                                                 java.lang.Class[] params)
                                          throws ReflectException

Retrieves a method of a given class. If anything goes wrong a ReflectException is thrown. In this implementation only methods declared directly by the given class are found.

Parameters:

c - the class

methodName - name of the method

params - parameter list of the method

Returns:

the method

Throws:

ReflectException

getMethod

public static java.lang.reflect.Method getMethod(java.lang.Class c,
                                                 java.lang.String methodName)
                                          throws ReflectException

Retrieves a method of a given class with an empty parameter list. If anything goes wrong a ReflectException is thrown. In this implementation only methods declared directly by the given class are found.

Parameters:

c - the class

methodName - name of the method

Returns:

the method

Throws:

ReflectException

invokeMethod

public static java.lang.Object invokeMethod(java.lang.Object owner,
                                            java.lang.reflect.Method method,
                                            java.lang.Object[] args)
                                     throws ReflectException

Invokes a method on an object If anything goes wrong a reflect exception is thrown

Parameters:

owner - the object to invoke the method on

method - the method to be invoked

args - arguments of the method call

Returns:

return value of the method call

Throws:

ReflectException

getConstructor

public static java.lang.reflect.Constructor getConstructor(java.lang.Class c,
                                                           java.lang.Class[] params)

Retrieves a constructor from a given class. If anything goes wrong a reflect exception is thrown

Parameters:

c - the class

params - the constructor's parameter list.

Returns:

a constructor object

invokeConstructor

public static java.lang.Object invokeConstructor(java.lang.reflect.Constructor c,
                                                 java.lang.Object[] args)
                                          throws ReflectException

Invokes a constructor. If anything goes wrong a reflect exception is thrown

Parameters:

c - the constructor object

args - the arguments for the constructor invocation

Returns:

the object created by the constructor

Throws:

ReflectException

getField

public static java.lang.reflect.Field getField(java.lang.Class c,
                                               java.lang.String fieldName)
                                        throws ReflectException

Retrieves a field from a given class. In this implementation only fields declared directly by the given class are found. On errors a reflect exception is thrown.

Parameters:

c - the class

fieldName - the field name

Returns:

a field object

Throws:

ReflectException

getValue

public static java.lang.Object getValue(java.lang.Object owner,
                                        java.lang.reflect.Field field)
                                 throws ReflectException

Returns the value of the given field has in the specified object. On any error a reflect exception is thrown

Parameters:

owner - the object who owns the field

field - the field

Returns:

the current field value

Throws:

ReflectException

setValue

public static void setValue(java.lang.Object owner,
                            java.lang.reflect.Field field,
                            java.lang.Object value)
                     throws ReflectException

Sets the value of the given field of the specified object. On errors a reflect exception is thrown.

Parameters:

owner - the object owning the field

field - the field

value - the value to set the field to

Throws:

ReflectException