io.stallion.reflection

Class PropertyUtils

java.lang.Object

io.stallion.reflection.PropertyUtils

public final class PropertyUtils
extends Object

Utility class for getting and setting bean properties via reflection.

Method Summary

Modifier and Type	Method and Description
static <T extends Annotation> T	getAnnotationForProperty(Class cls, String name, Class<T> anno)
static Object	getDotProperty(Object target, String propertyName)
static Method	getGetter(Object target, String propertyName)
static Map<String,Object>	getProperties(Object target, Class<? extends Annotation>... excludeAnnotations) Build a map of direct javabeans properties of the target object.
static Object	getProperty(Object target, String propertyName) Get a direct or indirect property (dotted property: prop1.prop2.prop3) on the target object.
static List<String>	getPropertyNames(Class clazz)
static Object	getPropertyOrMappedValue(Object target, String propertyName)
static Boolean	isReadable(Object obj, String name)
static Boolean	isWriteable(Object target, String propertyName)
static String	propertiesToString(Object obj) Return a comma-separated String of r/w properties of the specified object.
static boolean	propertyHasAnnotation(Class cls, String name, Class<? extends Annotation> anno)
static void	resetCache()
static void	setProperties(Object target, Map properties) Set a Map of direct or indirect properties on the target object.
static void	setProperty(Object target, String propertyName, Object propertyValue) Set a direct or indirect property (dotted property: prop1.prop2.prop3) on the target object.
static Object	transform(Object value, Class destinationClass) Try to transform the passed in value into the destinationClass, via a applying a boatload of heuristics.

Methods inherited from class java.lang.Object

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

Method Detail

resetCache

public static void resetCache()

setProperty

public static void setProperty(Object target,
                               String propertyName,
                               Object propertyValue)
                        throws PropertyException

Set a direct or indirect property (dotted property: prop1.prop2.prop3) on the target object. This method tries to be smart in the way that intermediate properties currently set to null are set if it is possible to create and set an object. Conversions from propertyValue to the proper destination type are performed when possible.

Parameters:

target - the target object on which to set the property.

propertyName - the name of the property to set.

propertyValue - the value of the property to set.

Throws:

PropertyException - if an error happened while trying to set the property.

getProperties

public static Map<String,Object> getProperties(Object target,
                                               Class<? extends Annotation>... excludeAnnotations)
                                        throws PropertyException

Build a map of direct javabeans properties of the target object. Only read/write properties (ie: those who have both a getter and a setter) are returned.

Parameters:

target - the target object from which to get properties names.

Returns:

a Map of String with properties names as key and their values

Throws:

PropertyException - if an error happened while trying to get a property.

getPropertyNames

public static List<String> getPropertyNames(Class clazz)
                                     throws PropertyException

Throws:

PropertyException

propertyHasAnnotation

public static boolean propertyHasAnnotation(Class cls,
                                            String name,
                                            Class<? extends Annotation> anno)

getAnnotationForProperty

public static <T extends Annotation> T getAnnotationForProperty(Class cls,
                                                                String name,
                                                                Class<T> anno)

isReadable

public static Boolean isReadable(Object obj,
                                 String name)

isWriteable

public static Boolean isWriteable(Object target,
                                  String propertyName)

getProperty

public static Object getProperty(Object target,
                                 String propertyName)
                          throws PropertyException

Get a direct or indirect property (dotted property: prop1.prop2.prop3) on the target object.

Parameters:

target - the target object from which to get the property.

propertyName - the name of the property to get.

Returns:

the value of the specified property.

Throws:

PropertyException - if an error happened while trying to get the property.

getDotProperty

public static Object getDotProperty(Object target,
                                    String propertyName)
                             throws PropertyException

Throws:

PropertyException

getPropertyOrMappedValue

public static Object getPropertyOrMappedValue(Object target,
                                              String propertyName)
                                       throws PropertyException

Throws:

PropertyException

setProperties

public static void setProperties(Object target,
                                 Map properties)
                          throws PropertyException

Set a Map of direct or indirect properties on the target object.

Parameters:

target - the target object on which to set the properties.

properties - a Map of String/Object pairs.

Throws:

PropertyException - if an error happened while trying to set a property.

propertiesToString

public static String propertiesToString(Object obj)

Return a comma-separated String of r/w properties of the specified object.

Parameters:

obj - the object to introspect.

Returns:

a a comma-separated String of r/w properties.

transform

public static Object transform(Object value,
                               Class destinationClass)

Try to transform the passed in value into the destinationClass, via a applying a boatload of heuristics.

Parameters:

value -

destinationClass -

Returns:

getGetter

public static Method getGetter(Object target,
                               String propertyName)