ch.jalu.injector.utils

Class ReflectionUtils

java.lang.Object

ch.jalu.injector.utils.ReflectionUtils

public final class ReflectionUtils
extends Object

Reflection methods.

Method Summary

Modifier and Type	Method and Description
static Class<?>	getCollectionType(Class<?> mainType, Type genericType) Returns the type the collection (array, Iterable) consists of.
static Object	getFieldValue(Field field, Object instance) Gets the value of the given field in the given instance.
static Class<?>	getGenericType(Type genericType) Retrieves the generic subtype of the given type.
static Object	invokeMethod(Method method, Object instance, Object... parameters) Invokes the given method on the given instance with the provided parameters.
static <T> T	newInstance(Constructor<T> constructor, Object... parameters) Invokes the given constructor with the provided parameters.
static Field[]	safeGetDeclaredFields(Class<?> clazz) Returns all fields of a class if not annotated with NoFieldScan.
static Method[]	safeGetDeclaredMethods(Class<?> clazz) Returns all methods of a class if not annotated with NoMethodScan.
static void	setField(Field field, Object instance, Object value) Sets the given field on the given instance.
static <T> Object	toSuitableCollectionType(Class<?> rawType, Set<T> result) Attempts to convert the given result Set to the given collection type.

Methods inherited from class java.lang.Object

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

Method Detail

getFieldValue

public static Object getFieldValue(Field field,
                                   Object instance)

Gets the value of the given field in the given instance.

Parameters:

field - the field to retrieve

instance - the instance to retrieve it from (null for static fields)

Returns:

the field's value

setField

public static void setField(Field field,
                            Object instance,
                            Object value)

Sets the given field on the given instance.

Parameters:

field - the field to set

instance - the instance to set the field in (null for static fields)

value - the value to set

invokeMethod

public static Object invokeMethod(Method method,
                                  Object instance,
                                  Object... parameters)

Invokes the given method on the given instance with the provided parameters.

Parameters:

method - the method to invoke

instance - the instance to invoke it from (null for static methods)

parameters - the parameters to use

Returns:

the returned value from the method invocation

newInstance

public static <T> T newInstance(Constructor<T> constructor,
                                Object... parameters)

Invokes the given constructor with the provided parameters.

Type Parameters:

T - the type the constructor belongs to

Parameters:

constructor - the constructor

parameters - the parameters to invoke the constructor with

Returns:

the instantiated object

getGenericType

@Nullable
public static Class<?> getGenericType(@Nullable
                                                Type genericType)

Retrieves the generic subtype of the given type.

Parameters:

genericType - the type to get the generic type from

Returns:

the generic type, or null if not applicable

getCollectionType

@Nullable
public static Class<?> getCollectionType(Class<?> mainType,
                                                   @Nullable
                                                   Type genericType)

Returns the type the collection (array, Iterable) consists of.

Parameters:

mainType - the main type

genericType - the generic type if available

Returns:

the type the array/Iterable consists of, or null if not applicable

toSuitableCollectionType

public static <T> Object toSuitableCollectionType(Class<?> rawType,
                                                  Set<T> result)

Attempts to convert the given result Set to the given collection type. If the given class to match is an array, an array will be returned without any type checks. Otherwise, tries to satisfy the field by returning a Set or a List instance. Throws an exception if no type could be used.

Type Parameters:

T - the set's type

Parameters:

rawType - the collection type to match

result - the result Set to potentially convert

Returns:

result set as suitable collection type

safeGetDeclaredMethods

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

Returns all methods of a class if not annotated with NoMethodScan. Otherwise returns an empty array.

Parameters:

clazz - the class to process

Returns:

the class' methods or empty array if methods should not be scanned

safeGetDeclaredFields

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

Returns all fields of a class if not annotated with NoFieldScan. Otherwise returns an empty array.

Parameters:

clazz - the class to process

Returns:

the class' fields or empty array if fields should not be scanned