com.almasb.fxgl.core.reflect

Class ReflectionUtils

java.lang.Object

com.almasb.fxgl.core.reflect.ReflectionUtils

public final class ReflectionUtils
extends Object

A collection of convenience methods to isolate reflection code.

Author:

Almas Baimagambetov (almaslvl@gmail.com)

Method Summary

Modifier and Type	Method and Description
static <T> T	call(Object instance, Method method, Object... args)
static Map<Class<?>,List<Class<?>>>	findClasses(String packageName, Class<? extends Annotation>... annotations)
static Array<Field>	findDeclaredFieldsByType(Object instance, Class<?> type) Find declared fields of "instance" that have type / subtype of given "type" parameter.
static <A extends Annotation> Array<Field>	findFieldsByAnnotation(Object instance, Class<A> annotationClass)
static Array<Field>	findFieldsByTypeRecursive(Object instance, Class<?> type) Find all fields of "instance" that have type / subtype of given "type" parameter.
static <A extends Annotation> Map<A,Method>	findMethods(Object instance, Class<A> annotationClass)
static <T,R,A extends Annotation> Map<A,Function<T,R>>	findMethodsMapToFunctions(Object instance, Class<A> annotationClass)
static <T,R,F extends Function<T,R>,A extends Annotation> Map<A,F>	findMethodsMapToFunctions(Object instance, Class<A> annotationClass, Class<F> functionClass)
static Optional<Field>	getDeclaredField(String fieldName, Object instance)
static void	inject(Field field, Object instance, Object injectionInstance) Injects field of an instance to injectionInstance.
static <T,R> Function<T,R>	mapToFunction(Object instance, Method method)
static <T> T	newInstance(Class<T> type)

Methods inherited from class java.lang.Object

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

Method Detail

findClasses

public static Map<Class<?>,List<Class<?>>> findClasses(String packageName,
                                                       Class<? extends Annotation>... annotations)

Returns:

mapping from annotation class to list of classes with that annotation (on the classpath)

findMethods

public static <A extends Annotation> Map<A,Method> findMethods(Object instance,
                                                               Class<A> annotationClass)

findMethodsMapToFunctions

public static <T,R,A extends Annotation> Map<A,Function<T,R>> findMethodsMapToFunctions(Object instance,
                                                                                        Class<A> annotationClass)

findMethodsMapToFunctions

public static <T,R,F extends Function<T,R>,A extends Annotation> Map<A,F> findMethodsMapToFunctions(Object instance,
                                                                                                    Class<A> annotationClass,
                                                                                                    Class<F> functionClass)

call

public static <T> T call(Object instance,
                         Method method,
                         Object... args)

mapToFunction

public static <T,R> Function<T,R> mapToFunction(Object instance,
                                                Method method)

findFieldsByAnnotation

public static <A extends Annotation> Array<Field> findFieldsByAnnotation(Object instance,
                                                                         Class<A> annotationClass)

findDeclaredFieldsByType

public static Array<Field> findDeclaredFieldsByType(Object instance,
                                                    Class<?> type)

Find declared fields of "instance" that have type / subtype of given "type" parameter.

Parameters:

instance - object whose fields to search

type - super type

Returns:

declared fields that meet criteria

findFieldsByTypeRecursive

public static Array<Field> findFieldsByTypeRecursive(Object instance,
                                                     Class<?> type)

Find all fields of "instance" that have type / subtype of given "type" parameter. Note: this will recursively search all matching fields in supertypes of "instance".

Parameters:

instance - object whose fields to search

type - super type

Returns:

all fields that meet criteria

getDeclaredField

public static Optional<Field> getDeclaredField(String fieldName,
                                               Object instance)

inject

public static void inject(Field field,
                          Object instance,
                          Object injectionInstance)

Injects field of an instance to injectionInstance.

Parameters:

field - the field object

instance - field's object

injectionInstance - the target value to inject

newInstance

public static <T> T newInstance(Class<T> type)

Parameters:

type - class

Returns:

instance of given class using its no-arg ctor

Throws:

ReflectionException - if cannot be instantiated