de.alpharogroup.lang.object

Class MergeObjectExtensions

java.lang.Object

de.alpharogroup.lang.object.MergeObjectExtensions

public final class MergeObjectExtensions
extends Object

The class MergeObjectExtensions provide extension methods for merge a source object with another object.

Constructor Summary

Constructors

Constructor and Description
MergeObjectExtensions()

Method Summary

Modifier and Type	Method and Description
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 <MERGE_IN,WITH> MERGE_IN	merge(MERGE_IN mergeInObject, WITH withObject) Merge the given to object with the given 'with' object.
static <MERGE_IN,WITH> MERGE_IN	mergeOrCopyQuietly(MERGE_IN mergeInObject, WITH withObject) Try first to merge quietly the given merge in object(destination) with the given 'with' object, if this fails try to copy.
static <MERGE_IN,WITH> void	mergeProperty(MERGE_IN mergeInObject, WITH withObject, PropertyDescriptor propertyDescriptor) Merge the given property to the given 'to' object with the given 'with' object.
static <MERGE_IN,WITH> MERGE_IN	mergeQuietly(MERGE_IN mergeInObject, WITH withObject) Merge quietly the given merge in object(destination) with the given 'with' object.

Methods inherited from class java.lang.Object

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

Constructor Detail

MergeObjectExtensions

public MergeObjectExtensions()

Method Detail

merge

public static final <MERGE_IN,WITH> MERGE_IN merge(MERGE_IN mergeInObject,
                                                   WITH withObject)
                                            throws InvocationTargetException,
                                                   IllegalAccessException,
                                                   IllegalArgumentException

Merge the given to object with the given 'with' object.

Type Parameters:

MERGE_IN - the generic type of the object to merge in

WITH - the generic type of the object to merge with

Parameters:

mergeInObject - the object to merge in

withObject - the object to merge with

Returns:

the merged object.

Throws:

InvocationTargetException - if the property accessor method throws an exception

IllegalAccessException - if the caller does not have access to the property accessor method

IllegalArgumentException - if the mergeInObject or withObject argument is null or if the mergeInObject property type is different from the source type and the relevant converter has not been registered.

mergeQuietly

public static final <MERGE_IN,WITH> MERGE_IN mergeQuietly(MERGE_IN mergeInObject,
                                                          WITH withObject)

Merge quietly the given merge in object(destination) with the given 'with' object.

Type Parameters:

MERGE_IN - the generic type of the object to merge in

WITH - the generic type of the object to merge with

Parameters:

mergeInObject - the object to merge in

withObject - the object to merge with

Returns:

the merged object or null if the merge process failed.

mergeOrCopyQuietly

public static final <MERGE_IN,WITH> MERGE_IN mergeOrCopyQuietly(MERGE_IN mergeInObject,
                                                                WITH withObject)

Try first to merge quietly the given merge in object(destination) with the given 'with' object, if this fails try to copy.

Type Parameters:

MERGE_IN - the generic type of the object to merge in

WITH - the generic type of the object to merge with

Parameters:

mergeInObject - the object to merge in

withObject - the object to merge with

Returns:

the merged object or null if the merge process failed.

mergeProperty

public static final <MERGE_IN,WITH> void mergeProperty(MERGE_IN mergeInObject,
                                                       WITH withObject,
                                                       PropertyDescriptor propertyDescriptor)
                                                throws IllegalAccessException,
                                                       InvocationTargetException,
                                                       IllegalArgumentException

Merge the given property to the given 'to' object with the given 'with' object.

Type Parameters:

MERGE_IN - the generic type of the object to merge in

WITH - the generic type of the object to merge with

Parameters:

mergeInObject - the object to merge in

withObject - the object to merge with

propertyDescriptor - the property descriptor

Throws:

InvocationTargetException - if the property accessor method throws an exception

IllegalAccessException - if the caller does not have access to the property accessor method

IllegalArgumentException - if the mergeInObject or withObject argument is null or if the mergeInObject property type is different from the source type and the relevant converter has not been registered.

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 - Thrown if this Method object is enforcing Java language access control and the underlying method is inaccessible.

InvocationTargetException - Thrown if the property accessor method throws an exception

NoSuchMethodException - Thrown if this Method object is enforcing Java language access control and the underlying method is inaccessible.

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