com.austinv11.collectiveframework.utils

Class ReflectionUtils

java.lang.Object

com.austinv11.collectiveframework.utils.ReflectionUtils

public class ReflectionUtils
extends java.lang.Object

Class that contains a few useful utilities to simplify reflection

Constructor Summary

Constructors

Constructor and Description
ReflectionUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	classImplementsInterface(java.lang.Class classToExamine, java.lang.Class interfaceClass) Checks if a class implements another class
static java.lang.Object[]	coerceStringToArray(java.lang.String containingString) Creates an array from a string
static java.lang.Object[]	coerceStringToArray(java.lang.String containingString, java.lang.Object toObject) Creates an array from a string
static java.lang.Object	coerceStringToJavaObject(java.lang.String containingString) This attempts to coerce a string into a standard java object
static java.util.List<java.lang.reflect.Field>	getDeclaredFieldsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.Class clazz) Gets a list of declared fields with the given annotation
static java.util.List<java.lang.reflect.Method>	getDeclaredMethodsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.Class clazz) Gets a list of declared methods with the given annotation
static java.lang.reflect.Field	getDeclaredOrNormalField(java.lang.String fieldName, java.lang.Class clazz) Attempts to find either a declared or normal field (in that order)
static java.lang.reflect.Method	getDeclaredOrNormalMethod(java.lang.String methodName, java.lang.Class clazz) Attempts to find either a declared or normal method (in that order)
static java.util.List<java.lang.reflect.Field>	getFieldsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.Class clazz) Gets a list of fields with the given annotation
static java.util.List<java.lang.reflect.Method>	getMethodsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation, java.lang.Class clazz) Gets a list of methods with the given annotation
static java.lang.Class	getPrimitiveSafeClassForName(java.lang.String name) Gets classes for a given name, including primitives
static java.lang.String	getSignatureFromObject(java.lang.Object o) Gets the jvm signature for an object
static java.lang.Class	getTypeFromSignature(java.lang.String signature) Gets the class for a signature (only handles one signature at a time)
static boolean	isNamePrimitive(java.lang.String name) This method checks if the specified class name is of a primitive
static boolean	isNamePrimitiveOrPrimitiveObject(java.lang.String name) This method checks if the specified class name is of a primitive, includes primitive object names
static boolean	isPrimitiveObject(java.lang.Object o) Checks if the given object is a primitive wrapper object
static java.lang.Object	objectFromString(java.lang.String objectString, java.lang.Object object) Tries to create an object from a string
static java.lang.String	objectToString(java.lang.Object o) Translates an object into a string readable by objectFromString(java.lang.String, java.lang.Object)
static java.lang.String	objectToString(java.lang.Object o, int tabs) Translates an object into a string readable by objectFromString(java.lang.String, java.lang.Object)
static boolean	paramsMatch(java.lang.reflect.Method method, java.lang.Class<?>... params) Checks if the given method has the required parameters

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionUtils

public ReflectionUtils()

Method Detail

getDeclaredMethodsWithAnnotation

public static java.util.List<java.lang.reflect.Method> getDeclaredMethodsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                                        java.lang.Class clazz)

Gets a list of declared methods with the given annotation

Parameters:

annotation - The annotation to search for

clazz - The class to search in

Returns:

The methods with the annotation

getDeclaredFieldsWithAnnotation

public static java.util.List<java.lang.reflect.Field> getDeclaredFieldsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                                      java.lang.Class clazz)

Gets a list of declared fields with the given annotation

Parameters:

annotation - The annotation to search for

clazz - The class to search in

Returns:

The fields with the annotation

getMethodsWithAnnotation

public static java.util.List<java.lang.reflect.Method> getMethodsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                                java.lang.Class clazz)

Gets a list of methods with the given annotation

Parameters:

annotation - The annotation to search for

clazz - The class to search in

Returns:

The methods with the annotation

getFieldsWithAnnotation

public static java.util.List<java.lang.reflect.Field> getFieldsWithAnnotation(java.lang.Class<? extends java.lang.annotation.Annotation> annotation,
                                                              java.lang.Class clazz)

Gets a list of fields with the given annotation

Parameters:

annotation - The annotation to search for

clazz - The class to search in

Returns:

The fields with the annotation

paramsMatch

public static boolean paramsMatch(java.lang.reflect.Method method,
                  java.lang.Class<?>... params)

Checks if the given method has the required parameters

Parameters:

method - The method

params - The parameters (ORDER MATTERS!)

Returns:

True of the parameters match, else false

getDeclaredOrNormalField

public static java.lang.reflect.Field getDeclaredOrNormalField(java.lang.String fieldName,
                                               java.lang.Class clazz)

Attempts to find either a declared or normal field (in that order)

Parameters:

fieldName - The field to get

clazz - The class to search

Returns:

The field, or null if it wasn't found

getDeclaredOrNormalMethod

public static java.lang.reflect.Method getDeclaredOrNormalMethod(java.lang.String methodName,
                                                 java.lang.Class clazz)

Attempts to find either a declared or normal method (in that order)

Parameters:

methodName - The method to get

clazz - The class to search

Returns:

The field, or null if it wasn't found

getSignatureFromObject

public static java.lang.String getSignatureFromObject(java.lang.Object o)

Gets the jvm signature for an object

Parameters:

o - The object

Returns:

The signature

getTypeFromSignature

public static java.lang.Class getTypeFromSignature(java.lang.String signature)
                                            throws java.lang.ClassNotFoundException

Gets the class for a signature (only handles one signature at a time)

Parameters:

signature - The signature

Returns:

The class representing the signature inputted

Throws:

java.lang.ClassNotFoundException

getPrimitiveSafeClassForName

public static java.lang.Class getPrimitiveSafeClassForName(java.lang.String name)
                                                    throws java.lang.ClassNotFoundException

Gets classes for a given name, including primitives

Parameters:

name - The name

Returns:

The class

Throws:

java.lang.ClassNotFoundException

isNamePrimitive

public static boolean isNamePrimitive(java.lang.String name)

This method checks if the specified class name is of a primitive

Parameters:

name - The class name

Returns:

True if the name is of a primitive data type

isNamePrimitiveOrPrimitiveObject

public static boolean isNamePrimitiveOrPrimitiveObject(java.lang.String name)

This method checks if the specified class name is of a primitive, includes primitive object names

Parameters:

name - The class name

Returns:

True if the name is of a primitive data type

isPrimitiveObject

public static boolean isPrimitiveObject(java.lang.Object o)

Checks if the given object is a primitive wrapper object

Parameters:

o - The object

Returns:

True of the object represents a primitive wrapper object

coerceStringToJavaObject

public static java.lang.Object coerceStringToJavaObject(java.lang.String containingString)

This attempts to coerce a string into a standard java object

Parameters:

containingString - The string to coerce

Returns:

The object, either a Double, Integer, Character, Boolean, null, or String

coerceStringToArray

public static java.lang.Object[] coerceStringToArray(java.lang.String containingString)

Creates an array from a string

Parameters:

containingString - The string

Returns:

The array

coerceStringToArray

public static java.lang.Object[] coerceStringToArray(java.lang.String containingString,
                                     java.lang.Object toObject)
                                              throws java.lang.ClassNotFoundException,
                                                     java.lang.InstantiationException,
                                                     java.lang.IllegalAccessException,
                                                     java.io.IOException

Creates an array from a string

Parameters:

containingString - The string

toObject - The type for the array

Returns:

The array

Throws:

java.lang.ClassNotFoundException

java.lang.InstantiationException

java.lang.IllegalAccessException

java.io.IOException

objectFromString

public static java.lang.Object objectFromString(java.lang.String objectString,
                                java.lang.Object object)
                                         throws java.io.IOException,
                                                java.lang.IllegalAccessException,
                                                java.lang.ClassNotFoundException,
                                                java.lang.InstantiationException

Tries to create an object from a string

Parameters:

objectString - The string representing the object

object - The object to deserialize the string into

Returns:

The object

Throws:

java.io.IOException

java.lang.IllegalAccessException

java.lang.ClassNotFoundException

java.lang.InstantiationException

objectToString

public static java.lang.String objectToString(java.lang.Object o)

Translates an object into a string readable by objectFromString(java.lang.String, java.lang.Object)

Parameters:

o - The object

Returns:

The String

objectToString

public static java.lang.String objectToString(java.lang.Object o,
                              int tabs)

Translates an object into a string readable by objectFromString(java.lang.String, java.lang.Object)

Parameters:

o - The object

tabs - The number of tab indents

Returns:

The string

classImplementsInterface

public static boolean classImplementsInterface(java.lang.Class classToExamine,
                               java.lang.Class interfaceClass)

Checks if a class implements another class

Parameters:

classToExamine - The class to check

interfaceClass - The interface to look for

Returns:

True if the class implements the provided interface