Package de.rwth.swc.coffee4j.junit.engine.annotation.util

Class ReflectionUtils

java.lang.Object

de.rwth.swc.coffee4j.junit.engine.annotation.util.ReflectionUtils

public class ReflectionUtils
extends Object

Utility class that provides helper methods for reflection related tasks

Method Summary

Modifier and Type	Method	Description
static <T> T	createNewInstance(Class<T> clazz, Object... constructorArgs)	Creates a new instance of a provided class.
static String	extractMethodParameterName(Parameter parameter)	Extracts the name of the input parameter from a method parameter
static List<String>	extractMethodParameterNames(Method method)	Extracts the parameter names from all Parameter of a Method according to extractMethodParameterName(Parameter)
static Map<String,Integer>	extractMethodParameterPositionMap(Method method)	Extracts the assignment of input parameters to the method parameters
static Method	findQualifiedMethod(Class<?> clazz, String methodName)	Attempts to find the method defined by the given name.
static Method	findRequiredMethod(Class<?> clazz, String methodName, Class<?>... parameterTypes)	Finds a method with provided parameter type in a class
static Object[]	getInputForMethod(Combination combination, Method method)	Extracts the input for a method from a Combination
static Object	getObjectReturnedByMethod(Method method)	Gets the object returned by a method by potentially instantiating its declaring class in case the method is not static
static Object	invokeMethod(Method method, Object target, Object... args)	Invokes the method on the target with the provided arguments

Methods inherited from class java.lang.Object

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

Method Detail

getInputForMethod

public static Object[] getInputForMethod(Combination combination,
                                         Method method)

Extracts the input for a method from a Combination

Parameters:

combination - the combination from which to extract the input

method - the method for which to extract the inputs. Its Parameter parameters should be annotated with InputParameter

Returns:

the extracted input for the method

See Also:

extractMethodParameterName(Parameter)

extractMethodParameterPositionMap

public static Map<String,Integer> extractMethodParameterPositionMap(Method method)

Extracts the assignment of input parameters to the method parameters

Parameters:

method - the method from which to extract the map from

Returns:

the map, which assigns every input parameter an position in the Parameter list of a Method according to the names of the input parameters

extractMethodParameterNames

public static List<String> extractMethodParameterNames(Method method)

Extracts the parameter names from all Parameter of a Method according to extractMethodParameterName(Parameter)

Parameters:

method - the method whose parameter names should be extracts

Returns:

the names of the parameters

extractMethodParameterName

public static String extractMethodParameterName(Parameter parameter)

Extracts the name of the input parameter from a method parameter

Parameters:

parameter - the method parameter

Returns:

the name of the input parameter

See Also:

InputParameter

createNewInstance

public static <T> T createNewInstance(Class<T> clazz,
                                      Object... constructorArgs)

Creates a new instance of a provided class.

Wrapper around ReflectionSupport.newInstance(Class, Object...) for more meaningful exceptions in case of failure

Type Parameters:

T - the type of the class to instantiate

Parameters:

clazz - the class to instantiate

constructorArgs - the arguments of the constructor

Returns:

the instantiated class

See Also:

ReflectionSupport.newInstance(Class, Object...)

invokeMethod

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

Invokes the method on the target with the provided arguments

Wrapper around ReflectionSupport.invokeMethod(Method, Object, Object...) for more meaningful exceptions in case of failure

Parameters:

method - the method to invoked

target - the instance on which to invoke the method

args - the arguments of the method

Returns:

the value the method returns

See Also:

ReflectionSupport.invokeMethod(Method, Object, Object...)

findRequiredMethod

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

Finds a method with provided parameter type in a class

Wrapper around ReflectionSupport.findMethod(Class, String, Class[]) for more meaningful exceptions in case of failure

Parameters:

clazz - the class where to find the method

methodName - the name of the method

parameterTypes - the type of the parameters of the method

Returns:

the searched method

getObjectReturnedByMethod

public static Object getObjectReturnedByMethod(Method method)

Gets the object returned by a method by potentially instantiating its declaring class in case the method is not static

Parameters:

method - the method from which to get the object from

Returns:

the object return by the method

See Also:

createNewInstance(Class, Object...), invokeMethod(Method, Object, Object...)

findQualifiedMethod

public static Method findQualifiedMethod(Class<?> clazz,
                                         String methodName)

Attempts to find the method defined by the given name. If the methodName is blank, a method in the class with the same name as the test method is returned. Otherwise, either the method with the given name in the class (if the methodName is not fully qualified) or the method in another class (if the method name is fully qualified) is returned. To fully qualify a method name, put the class name before the method name and separate them with a"#".

Parameters:

clazz - the class where a non-qualified method is found

methodName - the name of the method which should be returned

Returns:

the method defined by the name with the rules explained above