Class ReflectionUtils

java.lang.Object

io.fluxzero.common.reflection.ReflectionUtils

public class ReflectionUtils
extends Object

Utility class for high-performance reflection-based operations across the Fluxzero Runtime.

This class is intended for internal use only. It provides a wide range of methods for accessing and manipulating object members via reflection, including:

• Resolving annotated fields and methods (with support for meta-annotations)
• Accessing nested property paths via getters and setters (e.g., "user/address/street")
• Efficient member access using DefaultMemberInvoker, which leverages LambdaMetafactory for near-native invocation performance
• Generic type resolution, including collection element types and supertype inference
• Annotation hierarchy traversal and support for Kotlin nullability reflection (if available)
• Utilities for determining override relationships, class hierarchies, and bean property metadata
• Robust handling of Class loading and safe access to field/method/property values

Performance Considerations

This class uses extensive caching and memoization to avoid redundant reflective operations at runtime. All public methods are safe to use in high-performance contexts such as annotation scanning, handler dispatching, and JSON schema validation.

Modular Use

If Fluxzero adopts JPMS (Project Jigsaw) in the future, this utility would likely be placed in an internal module and not exported to consumers, to preserve encapsulation and forward compatibility.

See Also:

• MemberInvoker
• DefaultMemberInvoker
• JsonUtils
• TypeRegistry

Constructor Summary

Constructors

Constructor	Description
ReflectionUtils()

Method Summary

Modifier and Type	Method	Description
static Class<?>	asClass(@NonNull Object value)
static <T> T	asInstance(Object classOrInstance)
static boolean	classExists(String className)
static Class<?>	classForName(String type)
static Class<?>	classForName(String type, Class<?> defaultClass)
static <T> T	convertAnnotation(Annotation annotation, Class<? extends T> returnType)
static <V> V	copyFields(V source, V target)
static boolean	declaresField(Class<?> target, String fieldName)
static List<Class<?>>	determineCommonAncestors(Collection<?> elements)
static <T extends AccessibleObject> T	ensureAccessible(T member)
static List<Method>	getAllMethods(Class<?> type)
static List<Field>	getAnnotatedFields(Class<?> target, Class<? extends Annotation> annotation)
static List<Field>	getAnnotatedFields(Object target, Class<? extends Annotation> annotation)
static List<Method>	getAnnotatedMethods(Class<?> target, Class<? extends Annotation> annotation)
static List<Method>	getAnnotatedMethods(Object target, Class<? extends Annotation> annotation)
static List<? extends AccessibleObject>	getAnnotatedProperties(Class<?> target, Class<? extends Annotation> annotation)
static Optional<? extends AccessibleObject>	getAnnotatedProperty(Class<?> target, Class<? extends Annotation> annotation)
static Optional<? extends AccessibleObject>	getAnnotatedProperty(Object target, Class<? extends Annotation> annotation)
static Optional<String>	getAnnotatedPropertyName(Object target, Class<? extends Annotation> annotation)
static Optional<Object>	getAnnotatedPropertyValue(Object target, Class<? extends Annotation> annotation)
static Collection<Object>	getAnnotatedPropertyValues(Object target, Class<? extends Annotation> annotation)
static <A extends Annotation> Optional<A>	getAnnotation(AnnotatedElement m, Class<A> a)
static <T> Optional<T>	getAnnotationAs(Annotation annotation, Class<? extends Annotation> targetAnnotation, Class<? extends T> returnType)
static <T> Optional<T>	getAnnotationAs(Class<?> target, Class<? extends Annotation> annotationType, Class<T> returnType)
static <T> Optional<T>	getAnnotationAs(AnnotatedElement member, Class<? extends Annotation> annotationType, Class<? extends T> returnType)
static Class<?>	getCallerClass()
static Optional<Class<?>>	getCollectionElementType(AccessibleObject fieldOrMethod)
static Optional<Class<?>>	getCollectionElementType(Type parameterizedType)
static Class<?>	getEnclosingClass(AccessibleObject fieldOrMethod)
static Optional<Field>	getField(Class<?> owner, String name)
static <A extends Annotation> Optional<A>	getFieldAnnotation(Field f, Class<? extends Annotation> a)
static <T> Optional<T>	getFieldValue(String fieldName, Object target)
static <T extends Type> T	getFirstTypeArgument(Type genericType)
static Type	getGenericPropertyType(AccessibleObject fieldOrMethod)
static Type	getGenericType(Class<?> candidate, Class<?> wantedClass)
static <A extends Annotation> Optional<A>	getMemberAnnotation(Class<?> type, String memberName, Class<? extends Annotation> a)
static Optional<Method>	getMethod(Class<?> type, String name)
static <A extends Annotation> Optional<A>	getMethodAnnotation(Executable m, Class<? extends Annotation> a)
static <A extends Annotation> List<A>	getMethodAnnotations(Executable m, Class<? extends Annotation> a)
static Stream<Method>	getMethodOverrideHierarchy(Method method)
static String	getName(AccessibleObject fieldOrMethod)
static List<Package>	getPackageAndParentPackages(Package p)
static <A extends Annotation> Optional<A>	getPackageAnnotation(Package p, Class<A> annotationType)
static Collection<? extends Annotation>	getPackageAnnotations(Package p)
static Collection<? extends Annotation>	getPackageAnnotations(Package p, boolean recursive)
static int	getParameterIndex(Parameter parameter)
static Stream<Parameter>	getParameterOverrideHierarchy(Parameter parameter)
static <T> Optional<T>	getPropertyAnnotation(String propertyPath, Object target)
static String	getPropertyName(AccessibleObject property)
static Class<?>	getPropertyType(AccessibleObject fieldOrMethod)
static String	getSimpleName(Class<?> c)
static String	getSimpleName(Package p)
static String	getSimpleName(String fullyQualifiedName)
static <A extends Annotation> A	getTypeAnnotation(Class<?> type, Class<? extends Annotation> annotationType)
static Collection<? extends Annotation>	getTypeAnnotations(Class<?> type)
static <T extends Type> T	getTypeArgument(Type genericType, int index)
static List<Type>	getTypeArguments(Type genericType)
static Object	getValue(AccessibleObject fieldOrMethod, Object target)
static Object	getValue(AccessibleObject fieldOrMethod, Object target, boolean forceAccess)
static boolean	has(Class<? extends Annotation> annotationClass, Method method)
static boolean	has(Class<? extends Annotation> annotationClass, Parameter parameter)
static boolean	hasProperty(String propertyPath, Object target)
static Class<?>	ifClass(Object value)	Determines and returns the Class of the provided object if it is either an instance of Class or a Kotlin class that can be converted using Kotlin reflection utilities.
static boolean	isAnnotationPresent(Class<?> type, Class<? extends Annotation> annotationType)
static boolean	isAnnotationPresent(Parameter parameter, Class<? extends Annotation> annotationType)
static boolean	isKotlinReflectionSupported()
static boolean	isLeafValue(Object value)
static boolean	isMethodAnnotationPresent(Executable method, Class<? extends Annotation> annotation)
static boolean	isNullable(Parameter parameter)
static boolean	isOrHas(Annotation annotation, Class<? extends Annotation> annotationType)
static boolean	isStatic(Executable method)
static <T> Optional<T>	readProperty(String propertyPath, Object target)
static void	setField(Field field, Object target, Object value)
static void	setField(String fieldName, Object target, Object value)
static void	writeProperty(String propertyPath, Object target, Object value)

Methods inherited from class Object

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

Constructor Details

ReflectionUtils

public ReflectionUtils()

Method Details

getMethodOverrideHierarchy

public static Stream<Method> getMethodOverrideHierarchy(Method method)

getParameterOverrideHierarchy

public static Stream<Parameter> getParameterOverrideHierarchy(Parameter parameter)

isKotlinReflectionSupported

public static boolean isKotlinReflectionSupported()

ifClass

public static Class<?> ifClass(Object value)

Determines and returns the Class of the provided object if it is either an instance of Class or a Kotlin class that can be converted using Kotlin reflection utilities. If the object does not satisfy these conditions or Kotlin reflection is not supported, returns null.

Parameters:

value - The object to check and convert to Class, if possible.

Returns:

The Class of the provided object, or null if the object is not a class or cannot be converted.

asClass

public static Class<?> asClass(@NonNull
 @NonNull Object value)

getAllMethods

public static List<Method> getAllMethods(Class<?> type)

getMethod

public static Optional<Method> getMethod(Class<?> type,
 String name)

getAnnotatedProperties

public static List<? extends AccessibleObject> getAnnotatedProperties(Class<?> target,
 Class<? extends Annotation> annotation)

getAnnotatedProperty

public static Optional<? extends AccessibleObject> getAnnotatedProperty(Object target,
 Class<? extends Annotation> annotation)

getAnnotatedProperty

public static Optional<? extends AccessibleObject> getAnnotatedProperty(Class<?> target,
 Class<? extends Annotation> annotation)

getAnnotatedPropertyValue

public static Optional<Object> getAnnotatedPropertyValue(Object target,
 Class<? extends Annotation> annotation)

getAnnotatedPropertyValues

public static Collection<Object> getAnnotatedPropertyValues(Object target,
 Class<? extends Annotation> annotation)

getAnnotatedPropertyName

public static Optional<String> getAnnotatedPropertyName(Object target,
 Class<? extends Annotation> annotation)

getPropertyName

public static String getPropertyName(AccessibleObject property)

getAnnotatedMethods

public static List<Method> getAnnotatedMethods(Class<?> target,
 Class<? extends Annotation> annotation)

getAnnotatedMethods

public static List<Method> getAnnotatedMethods(Object target,
 Class<? extends Annotation> annotation)

isMethodAnnotationPresent

public static boolean isMethodAnnotationPresent(Executable method,
 Class<? extends Annotation> annotation)

getAnnotatedFields

public static List<Field> getAnnotatedFields(Class<?> target,
 Class<? extends Annotation> annotation)

getAnnotatedFields

public static List<Field> getAnnotatedFields(Object target,
 Class<? extends Annotation> annotation)

isAnnotationPresent

public static boolean isAnnotationPresent(Class<?> type,
 Class<? extends Annotation> annotationType)

getTypeAnnotation

public static <A extends Annotation> A getTypeAnnotation(Class<?> type,
 Class<? extends Annotation> annotationType)

getTypeAnnotations

public static Collection<? extends Annotation> getTypeAnnotations(Class<?> type)

getPackageAnnotation

public static <A extends Annotation> Optional<A> getPackageAnnotation(Package p,
 Class<A> annotationType)

getPackageAnnotations

public static Collection<? extends Annotation> getPackageAnnotations(Package p)

getPackageAnnotations

public static Collection<? extends Annotation> getPackageAnnotations(Package p,
 boolean recursive)

readProperty

public static <T> Optional<T> readProperty(String propertyPath,
 Object target)

getTypeArguments

public static List<Type> getTypeArguments(Type genericType)

getFirstTypeArgument

public static <T extends Type> T getFirstTypeArgument(Type genericType)

getTypeArgument

public static <T extends Type> T getTypeArgument(Type genericType,
 int index)

getPropertyAnnotation

public static <T> Optional<T> getPropertyAnnotation(String propertyPath,
 Object target)

hasProperty

public static boolean hasProperty(String propertyPath,
 Object target)

getFieldValue

public static <T> Optional<T> getFieldValue(String fieldName,
 Object target)

getValue

public static Object getValue(AccessibleObject fieldOrMethod,
 Object target,
 boolean forceAccess)

getValue

public static Object getValue(AccessibleObject fieldOrMethod,
 Object target)

getName

public static String getName(AccessibleObject fieldOrMethod)

getEnclosingClass

public static Class<?> getEnclosingClass(AccessibleObject fieldOrMethod)

getPropertyType

public static Class<?> getPropertyType(AccessibleObject fieldOrMethod)

getGenericPropertyType

public static Type getGenericPropertyType(AccessibleObject fieldOrMethod)

writeProperty

public static void writeProperty(String propertyPath,
 Object target,
 Object value)

isOrHas

public static boolean isOrHas(Annotation annotation,
 Class<? extends Annotation> annotationType)

getField

public static Optional<Field> getField(Class<?> owner,
 String name)

getCallerClass

public static Class<?> getCallerClass()

isNullable

public static boolean isNullable(Parameter parameter)

asInstance

public static <T> T asInstance(Object classOrInstance)

getParameterIndex

public static int getParameterIndex(Parameter parameter)

determineCommonAncestors

public static List<Class<?>> determineCommonAncestors(Collection<?> elements)

getPackageAndParentPackages

public static List<Package> getPackageAndParentPackages(Package p)

getMemberAnnotation

public static <A extends Annotation> Optional<A> getMemberAnnotation(Class<?> type,
 String memberName,
 Class<? extends Annotation> a)

isStatic

public static boolean isStatic(Executable method)

isLeafValue

public static boolean isLeafValue(Object value)

isAnnotationPresent

public static boolean isAnnotationPresent(Parameter parameter,
 Class<? extends Annotation> annotationType)

getGenericType

public static Type getGenericType(Class<?> candidate,
 Class<?> wantedClass)

getCollectionElementType

public static Optional<Class<?>> getCollectionElementType(AccessibleObject fieldOrMethod)

getCollectionElementType

public static Optional<Class<?>> getCollectionElementType(Type parameterizedType)

declaresField

public static boolean declaresField(Class<?> target,
 String fieldName)

setField

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

setField

public static void setField(String fieldName,
 Object target,
 Object value)

ensureAccessible

public static <T extends AccessibleObject> T ensureAccessible(T member)

getAnnotation

public static <A extends Annotation> Optional<A> getAnnotation(AnnotatedElement m,
 Class<A> a)

getAnnotationAs

public static <T> Optional<T> getAnnotationAs(Class<?> target,
 Class<? extends Annotation> annotationType,
 Class<T> returnType)

getAnnotationAs

public static <T> Optional<T> getAnnotationAs(AnnotatedElement member,
 Class<? extends Annotation> annotationType,
 Class<? extends T> returnType)

getAnnotationAs

public static <T> Optional<T> getAnnotationAs(Annotation annotation,
 Class<? extends Annotation> targetAnnotation,
 Class<? extends T> returnType)

convertAnnotation

public static <T> T convertAnnotation(Annotation annotation,
 Class<? extends T> returnType)

has

public static boolean has(Class<? extends Annotation> annotationClass,
 Method method)

has

public static boolean has(Class<? extends Annotation> annotationClass,
 Parameter parameter)

getFieldAnnotation

public static <A extends Annotation> Optional<A> getFieldAnnotation(Field f,
 Class<? extends Annotation> a)

getMethodAnnotation

public static <A extends Annotation> Optional<A> getMethodAnnotation(Executable m,
 Class<? extends Annotation> a)

getMethodAnnotations

public static <A extends Annotation> List<A> getMethodAnnotations(Executable m,
 Class<? extends Annotation> a)

copyFields

public static <V> V copyFields(V source,
 V target)

classForName

public static Class<?> classForName(String type)

classForName

public static Class<?> classForName(String type,
 Class<?> defaultClass)

classExists

public static boolean classExists(String className)

getSimpleName

public static String getSimpleName(Class<?> c)

getSimpleName

public static String getSimpleName(Package p)

getSimpleName

public static String getSimpleName(String fullyQualifiedName)