com.jmethods.catatumbo.impl

Class IntrospectionUtils

java.lang.Object

com.jmethods.catatumbo.impl.IntrospectionUtils

public class IntrospectionUtils
extends Object

Utility methods for helping with introspection/reflection.

Author:

Sai Pullabhotla

Method Summary

Modifier and Type	Method and Description
static String	getCapitalizedName(String fieldName) Capitalizes the given field name.
static <T> Constructor<T>	getConstructor(Class<T> clazz, Class<?>... parameterTypes) Returns a public constructor of the given class with the given parameter types.
static PropertyMetadata	getPropertyMetadata(Field field) Returns the meatdata for the given field.
static Method	getReadMethod(Class<?> clazz, String readMethodName, Class<?> expectedReturnType) Gets the method object with the given name and return type.
static Method	getReadMethod(PropertyMetadata propertyMetadata) Returns the read method for the given property.
static Method	getReadMethod(PropertyMetadata propertyMetadata, String readMethodName) Returns the Method object that allows reading of the given property.
static String	getReadMethodName(Field field) Returns the name of the method that can be used to read the given field.
static String	getReadMethodNameForBoolean(Field field) Returns the name of the method that can be used to read the given boolean field.
static Method	getWriteMethod(Class<?> clazz, String writeMethodName, Class<?> parameterType) Returns the write method with the given name and parameter type.
static Method	getWriteMethod(PropertyMetadata propertyMetadata) Returns the write method(setter method) for the given property.
static String	getWriteMethodName(Field field) Returns the name of the method that can be used to write (or set) the given field.
static Object	initializeEmbedded(EmbeddedMetadata embeddedMetadata, Object target) Initializes the Embedded object represented by the given metadata.
static Object	instantiateObject(Class<?> clazz) Creates a new object of given class by invoking the class' default public constructor.
static Class<?>[]	resolveCollectionType(Type type) Examines the given Collection type (List and Set) and returns the Class and Parameterized type, if any.
static Class<?>[]	resolveMapType(Type type) Examines the given Map type and returns the raw type, type of keys, type of values in the map.

Methods inherited from class java.lang.Object

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

Method Detail

getPropertyMetadata

public static PropertyMetadata getPropertyMetadata(Field field)

Returns the meatdata for the given field.

Parameters:

field - the field whose metadata has to be prepared

Returns:

metadata of the given field.

getReadMethod

public static Method getReadMethod(PropertyMetadata propertyMetadata)

Returns the read method for the given property.

Parameters:

propertyMetadata - the property metadata.

Returns:

the read method for the given property.

getReadMethod

public static Method getReadMethod(Class<?> clazz,
                                   String readMethodName,
                                   Class<?> expectedReturnType)

Gets the method object with the given name and return type.

Parameters:

clazz - the class that is supposed to have the specified method

readMethodName - the method name

expectedReturnType - the return type

Returns:

the Method object with the given name and return type.

getReadMethod

public static Method getReadMethod(PropertyMetadata propertyMetadata,
                                   String readMethodName)

Returns the Method object that allows reading of the given property.

Parameters:

propertyMetadata - the property metadata

readMethodName - the method name (e.g. getXXX or isXXX).

Returns:

the read Method.

getWriteMethod

public static Method getWriteMethod(PropertyMetadata propertyMetadata)

Returns the write method(setter method) for the given property.

Parameters:

propertyMetadata - the property

Returns:

the write Method

getWriteMethod

public static Method getWriteMethod(Class<?> clazz,
                                    String writeMethodName,
                                    Class<?> parameterType)

Returns the write method with the given name and parameter type.

Parameters:

clazz - The class that is supposed to have the specified method.

writeMethodName - the method name

parameterType - the parameter type.

Returns:

the write Method.

getReadMethodName

public static String getReadMethodName(Field field)

Returns the name of the method that can be used to read the given field.

Parameters:

field - the field

Returns:

the name of the read method,

getReadMethodNameForBoolean

public static String getReadMethodNameForBoolean(Field field)

Returns the name of the method that can be used to read the given boolean field.

Parameters:

field - the field name

Returns:

the name of the read method.

getWriteMethodName

public static String getWriteMethodName(Field field)

Returns the name of the method that can be used to write (or set) the given field.

Parameters:

field - the name of the field

Returns:

the name of the write method.

getCapitalizedName

public static String getCapitalizedName(String fieldName)

Capitalizes the given field name.

Parameters:

fieldName - the field name

Returns:

capitalized field name.

instantiateObject

public static Object instantiateObject(Class<?> clazz)

Creates a new object of given class by invoking the class' default public constructor.

Parameters:

clazz - the class whose instance needs to be created

Returns:

a new instance of the given class

Throws:

EntityManagerException - if any error occurs

initializeEmbedded

public static Object initializeEmbedded(EmbeddedMetadata embeddedMetadata,
                                        Object target)

Initializes the Embedded object represented by the given metadata.

Parameters:

embeddedMetadata - the metadata of the embedded field

target - the object in which the embedded field is declared/accessible from

Returns:

the initialized object

Throws:

EntityManagerException - if any error occurs during initialization of the embedded object

resolveCollectionType

public static Class<?>[] resolveCollectionType(Type type)

Examines the given Collection type (List and Set) and returns the Class and Parameterized type, if any.

Parameters:

type - the Collection type

Returns:

an array of Class objects with two elements. The first element will contain the raw type of the collection and the second will contain the parameterized type. If the collection declaration is not parameterized, the second element in the array is set to null.

resolveMapType

public static Class<?>[] resolveMapType(Type type)

Examines the given Map type and returns the raw type, type of keys, type of values in the map.

Parameters:

type - the type of map

Returns:

an array containing three elements:

• Raw type of Map
• Type of Keys, may be null
• Type of Values, may be null

getConstructor

public static <T> Constructor<T> getConstructor(Class<T> clazz,
                                                Class<?>... parameterTypes)

Returns a public constructor of the given class with the given parameter types. Returns null, if there is no matching constructor.

Parameters:

clazz - the class

parameterTypes - expected types of parameters

Returns:

the matching public constructor or null, if there is no matching constructor.