xyz.luan.reflection

Class ReflectionUtils

java.lang.Object

xyz.luan.reflection.ReflectionUtils

public final class ReflectionUtils
extends Object

The utility class ReflectionUtils contains methods for performing common reflexive operations not found in Java's default API.

Author:

Luan Nico

Method Summary

Modifier and Type	Method and Description
static void	consumeFieldsRecursively(Class<?> clazz, FieldConsumer consumer) Applies a given consumer to every field returned by getFieldsRecursively().
static Class<?>	getClass(Type type) Returns the Class<?> object for this Type.
static List<Field>	getFieldsRecursively(Class<?> clazz) Returns all the instance fields of a given class, going up throughout it's hierarchy until reaching the Object class.
static List<Field>	getFieldsRecursivelyExceptJavaClasses(Class<?> clazz) Returns all the instance fields of a given class, going up throughout it's hierarchy until reaching any Java class.
static List<Field>	getImmediateFields(Class<?> clazz) Returns all the immediate declared instance fields of a given class.
static boolean	isBaseClass(Class<?> clazz) Returns true whether clazz is a base class or not.
static boolean	isInnerClass(Class<?> clazz) Returns whether clazz is an inner class (either anonymous, method local or non-static nested).
static boolean	isJavaClass(Class<?> clazz) Returns true whether clazz is a Java class or not.

Methods inherited from class java.lang.Object

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

Method Detail

isInnerClass

public static boolean isInnerClass(Class<?> clazz)

Returns whether clazz is an inner class (either anonymous, method local or non-static nested).

Parameters:

clazz - the class to be evaluated

Returns:

if clazz is an inner class or not

getImmediateFields

public static List<Field> getImmediateFields(Class<?> clazz)

Returns all the immediate declared instance fields of a given class. This iterates through the class and selects every non-static and non-synthetic field, returning them as a List rather than an array.

Parameters:

clazz - the class to be evaluated

Returns:

a List with all the class's immediate declared instance fields

getFieldsRecursivelyExceptJavaClasses

public static List<Field> getFieldsRecursivelyExceptJavaClasses(Class<?> clazz)

Returns all the instance fields of a given class, going up throughout it's hierarchy until reaching any Java class. The method selects all non-static non-synthetic declared fields. It will stop going up the hierarchy if it reaches a Java class (see isJavaClass()). For example, the internal array inside String class will not be returned if you class extends String.

Parameters:

clazz - the class to be evaluated

Returns:

a List with all the class's fields

getFieldsRecursively

public static List<Field> getFieldsRecursively(Class<?> clazz)

Returns all the instance fields of a given class, going up throughout it's hierarchy until reaching the Object class. The method selects all non-static non-synthetic declared fields. If the class used is a base class (see isBaseClass()) the list will be empty.

Parameters:

clazz - the class to be evaluated

Returns:

a List with all the class's fields

consumeFieldsRecursively

public static void consumeFieldsRecursively(Class<?> clazz,
                                            FieldConsumer consumer)

Applies a given consumer to every field returned by getFieldsRecursively(). Easy to use as it unchecks every exception thrown in the process.

Parameters:

clazz - The class to be evaluated

consumer - The function to be run for each field

isBaseClass

public static boolean isBaseClass(Class<?> clazz)

Returns true whether clazz is a base class or not. Base classes are primitives, enums, arrays of any kind or the Object class.

Parameters:

clazz - the class to be evaluated

Returns:

whether clazz is a base class or not

isJavaClass

public static boolean isJavaClass(Class<?> clazz)

Returns true whether clazz is a Java class or not. Java classes are any classes that:

• are base classes (see isBaseClass())
• belong to the packages java.* or javax* (or any of their subpackages).

Parameters:

clazz - the class to be evaluated

Returns:

whether clazz is a Java class or not

getClass

public static Class<?> getClass(Type type)

Returns the Class<?> object for this Type.

Parameters:

type - the type object

Returns:

a Class<?> object associated with the type parameter