de.alpharogroup.lang

Class ObjectExtensions

java.lang.Object

de.alpharogroup.lang.ObjectExtensions

public final class ObjectExtensions
extends Object

The Class ObjectExtensions provides methods to clone, copy and compare objects. It also provides methods to find changed data between Objects.

Method Summary

Modifier and Type	Method and Description
static <T> T	clone(T object) Try to clone the given generic object.
static Object	cloneObject(Object object) Try to clone the given object.
static Object	cloneObjectQuietly(Object object) Try to clone the given object quietly.
static boolean	compare(Object sourceOjbect, Object objectToCompare) Compares the given two objects.
static int	compareTo(Object sourceOjbect, Object objectToCompare, String property) Compares the given object over the given property.
static int	compareToQuietly(Object sourceOjbect, Object objectToCompare, String property) Compares the given object over the given property quietly.
static <DESTINATION,ORIGINAL> void	copy(DESTINATION destination, ORIGINAL original) Copy the given original object to the given destination object.
static <DESTINATION,ORIGINAL> DESTINATION	copyQuietly(DESTINATION destination, ORIGINAL original) Copy quietly the given original object to the given destination object.
static List<ChangedAttributeResult>	getChangedData(Object sourceOjbect, Object objectToCompare) Gets the changed data.
static Map<Object,ChangedAttributeResult>	getChangedDataMap(Object sourceOjbect, Object objectToCompare) Compares the given two objects and gets the changed data.
static Map<String,Integer>	getCompareToResult(Object sourceOjbect, Object objectToCompare) Gets the compare to result.
static <DESTINATION,ORIGINAL> boolean	isCopyable(DESTINATION destination, ORIGINAL original) Checks if is copyable and copies if its possible otherwise it returns false.

Methods inherited from class java.lang.Object

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

Method Detail

clone

public static <T> T clone(T object)

Try to clone the given generic object.

Type Parameters:

T - the generic type

Parameters:

object - the object to clone

Returns:

The cloned object or null if the clone process failed.

cloneObject

public static Object cloneObject(Object object)
                          throws NoSuchMethodException,
                                 SecurityException,
                                 IllegalAccessException,
                                 IllegalArgumentException,
                                 InvocationTargetException,
                                 ClassNotFoundException,
                                 InstantiationException,
                                 IOException

Try to clone the given object.

Parameters:

object - The object to clone.

Returns:

The cloned object or null if the clone process failed.

Throws:

NoSuchMethodException - the no such method exception

SecurityException - Thrown if the security manager indicates a security violation.

IllegalAccessException - the illegal access exception

IllegalArgumentException - the illegal argument exception

InvocationTargetException - the invocation target exception

ClassNotFoundException - the class not found exception

InstantiationException - the instantiation exception

IOException - Signals that an I/O exception has occurred.

cloneObjectQuietly

public static Object cloneObjectQuietly(Object object)

Try to clone the given object quietly.

Parameters:

object - The object to clone.

Returns:

The cloned object or null if the clone process failed.

compare

public static boolean compare(Object sourceOjbect,
                              Object objectToCompare)
                       throws IllegalAccessException,
                              InvocationTargetException,
                              NoSuchMethodException

Compares the given two objects.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

Returns:

true, if successful otherwise false

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

NoSuchMethodException - the no such method exception

compareTo

public static int compareTo(Object sourceOjbect,
                            Object objectToCompare,
                            String property)
                     throws IllegalAccessException,
                            InvocationTargetException,
                            NoSuchMethodException

Compares the given object over the given property.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

property - the property

Returns:

the int

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

NoSuchMethodException - the no such method exception

compareToQuietly

public static int compareToQuietly(Object sourceOjbect,
                                   Object objectToCompare,
                                   String property)

Compares the given object over the given property quietly.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

property - the property

Returns:

the int

copy

public static final <DESTINATION,ORIGINAL> void copy(DESTINATION destination,
                                                     ORIGINAL original)
                                              throws IllegalAccessException,
                                                     InvocationTargetException

Copy the given original object to the given destination object.

Type Parameters:

DESTINATION - the generic type of the destination object.

ORIGINAL - the generic type of the original object.

Parameters:

destination - the destination object.

original - the original object.

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

copyQuietly

public static final <DESTINATION,ORIGINAL> DESTINATION copyQuietly(DESTINATION destination,
                                                                   ORIGINAL original)

Copy quietly the given original object to the given destination object.

Type Parameters:

DESTINATION - the generic type of the destination object.

ORIGINAL - the generic type of the original object.

Parameters:

destination - the destination object.

original - the original object.

Returns:

the destination object.

getChangedData

public static List<ChangedAttributeResult> getChangedData(Object sourceOjbect,
                                                          Object objectToCompare)
                                                   throws IllegalAccessException,
                                                          InvocationTargetException,
                                                          NoSuchMethodException

Gets the changed data.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

Returns:

the changed data

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

NoSuchMethodException - the no such method exception

getChangedDataMap

public static Map<Object,ChangedAttributeResult> getChangedDataMap(Object sourceOjbect,
                                                                   Object objectToCompare)
                                                            throws IllegalAccessException,
                                                                   InvocationTargetException,
                                                                   NoSuchMethodException

Compares the given two objects and gets the changed data.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

Returns:

the changed data

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

NoSuchMethodException - the no such method exception

getCompareToResult

public static Map<String,Integer> getCompareToResult(Object sourceOjbect,
                                                     Object objectToCompare)
                                              throws IllegalAccessException,
                                                     InvocationTargetException,
                                                     NoSuchMethodException

Gets the compare to result.

Parameters:

sourceOjbect - the source ojbect

objectToCompare - the object to compare

Returns:

the compare to result

Throws:

IllegalAccessException - the illegal access exception

InvocationTargetException - the invocation target exception

NoSuchMethodException - the no such method exception

isCopyable

public static final <DESTINATION,ORIGINAL> boolean isCopyable(DESTINATION destination,
                                                              ORIGINAL original)

Checks if is copyable and copies if its possible otherwise it returns false.

Type Parameters:

DESTINATION - the generic type of the destination object.

ORIGINAL - the generic type of the original object.

Parameters:

destination - the destination object.

original - the original object.

Returns:

true, if is copyable otherwise false.