com.lexmark.saperion.util

Class PropertyUtils

java.lang.Object

com.lexmark.saperion.util.PropertyUtils

public final class PropertyUtils
extends Object

Utility class to interface with common property utilities.

Author:

jschwarz, owaeldrich

Method Summary

Modifier and Type	Method and Description
static <Bean> void	copyProperties(Bean dest, Bean source) This method copies the properties of the given source bean to the target bean.
static void	copyPropertiesUntyped(Object dest, Object source) This method copies the properties of the given source object to the target object.
static Map<String,Object>	describe(Object bean) This method describes the given bean.
static Object	getProperty(Object bean, String name) This method gets the beans property with the given name.
static <Bean> void	merge(Bean changes, Bean target) This method merges the given changes to the given bean.
static <Bean> Bean	merge(Bean base, Bean changes, Bean target) This method merges the given changes to the given bean to the target bean.
static void	setProperty(Object bean, String name, Object value) This method sets the given beans property with the given name to the given value.

Methods inherited from class java.lang.Object

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

Method Detail

describe

public static Map<String,Object> describe(Object bean)
                                   throws IllegalAccessException,
                                          NoSuchMethodException,
                                          InvocationTargetException

This method describes the given bean.

Parameters:

bean - the bean to describe

Returns:

a map containing the beans properties by name and its class with the key "class"

Throws:

IllegalAccessException - the caller can't invoke the target's property accessor method

InvocationTargetException - the target's property accessor method has thrown an exception

NoSuchMethodException - the accessor method for the property cannot be found

getProperty

public static Object getProperty(Object bean,
                                 String name)
                          throws IllegalAccessException,
                                 NoSuchMethodException,
                                 InvocationTargetException

This method gets the beans property with the given name.

Parameters:

bean - the bean to get the property from

name - the name of the property

Returns:

the value of the given property in the given bean

Throws:

IllegalAccessException - the caller can't invoke the target's property accessor method

InvocationTargetException - the target's property accessor method has thrown an exception

NoSuchMethodException - the accessor method for the property cannot be found

setProperty

public static void setProperty(Object bean,
                               String name,
                               Object value)
                        throws IllegalAccessException,
                               NoSuchMethodException,
                               InvocationTargetException

This method sets the given beans property with the given name to the given value.

Parameters:

bean - the bean to set the property of

name - the name of the property

value - the value to set

Throws:

IllegalAccessException - the caller can't invoke the target's property accessor method

InvocationTargetException - the target's property accessor method has thrown an exception

NoSuchMethodException - the accessor method for the property cannot be found

merge

public static <Bean> Bean merge(Bean base,
                                Bean changes,
                                Bean target)
                         throws IllegalAccessException,
                                NoSuchMethodException,
                                InvocationTargetException

This method merges the given changes to the given bean to the target bean. null values in changes will not override values from base every other value will be taken from changes.

Type Parameters:

Bean - the bean type

Parameters:

base - the values to use for null-properties in changes

changes - the changes to merge to base

target - the merged properties

Returns:

the merged properties

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

merge

public static <Bean> void merge(Bean changes,
                                Bean target)
                         throws IllegalAccessException,
                                NoSuchMethodException,
                                InvocationTargetException

This method merges the given changes to the given bean. null values in changes will not override values from target every other value will be taken from changes.

Type Parameters:

Bean - the bean type

Parameters:

changes - the changes to merge to base

target - the merged properties

Throws:

IllegalAccessException

NoSuchMethodException

InvocationTargetException

copyProperties

public static <Bean> void copyProperties(Bean dest,
                                         Bean source)
                                  throws IllegalAccessException,
                                         InvocationTargetException,
                                         NoSuchMethodException

This method copies the properties of the given source bean to the target bean.

Type Parameters:

Bean - the type of both arguments

Parameters:

dest - the bean to copy to

source - the bean to copy from

Throws:

IllegalAccessException

InvocationTargetException

NoSuchMethodException

copyPropertiesUntyped

public static void copyPropertiesUntyped(Object dest,
                                         Object source)
                                  throws IllegalAccessException,
                                         InvocationTargetException,
                                         NoSuchMethodException

This method copies the properties of the given source object to the target object. This is done type independent: as long as the classes of both object define the same properties, they are written.

Parameters:

dest - the bean to copy to

source - the bean to copy from

Throws:

IllegalAccessException

InvocationTargetException

NoSuchMethodException