de.alpharogroup.copy.object

Class CopyObjectExtensions

java.lang.Object

de.alpharogroup.copy.object.CopyObjectExtensions

public final class CopyObjectExtensions
extends Object

The class CopyObjectExtensions provide methods for copy an original object to a given destination object.

Constructor Summary

Constructors

Constructor and Description
CopyObjectExtensions()

Method Summary

Modifier and Type	Method and Description
static <ORIGINAL,DESTINATION> DESTINATION	copy(ORIGINAL original, DESTINATION destination) A delegate method to copyProperties(Object, Object) for copy the given original object to the given destination object.
static <ORIGINAL,DESTINATION> DESTINATION	copyProperties(ORIGINAL original, DESTINATION destination) Copy the given original object to the given destination object.
static <T> T	copyProperties(T original) Copy the given object and return a copy of it.
static <ORIGINAL,DESTINATION> DESTINATION	copyPropertyWithReflection(ORIGINAL original, DESTINATION destination, String fieldName) Copy the given original object to the given destination object.
static <T extends Serializable> T	copySerializedObject(T orig) Copys the given Object and returns the copy from the object or null if the object can't be serialized.

Methods inherited from class java.lang.Object

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

Constructor Detail

CopyObjectExtensions

public CopyObjectExtensions()

Method Detail

copyPropertyWithReflection

public static final <ORIGINAL,DESTINATION> DESTINATION copyPropertyWithReflection(ORIGINAL original,
                                                                                  DESTINATION destination,
                                                                                  String fieldName)
                                                                           throws NoSuchFieldException,
                                                                                  SecurityException,
                                                                                  IllegalArgumentException,
                                                                                  IllegalAccessException

Copy the given original object to the given destination object. This also works on private fields.

Type Parameters:

ORIGINAL - the generic type of the original object.

DESTINATION - the generic type of the destination object.

Parameters:

original - the original object.

destination - the destination object.

fieldName - the field name

Returns:

the destination object

Throws:

NoSuchFieldException - is thrown if no such field exists.

SecurityException - is thrown if a security manager says no.

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

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

copy

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

A delegate method to copyProperties(Object, Object) for 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:

original - the original object.

destination - the destination object.

Returns:

the destination object.

Throws:

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

InvocationTargetException - if the property accessor method throws an exception

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

copyProperties

public static final <ORIGINAL,DESTINATION> DESTINATION copyProperties(ORIGINAL original,
                                                                      DESTINATION destination)
                                                               throws IllegalAccessException,
                                                                      InvocationTargetException,
                                                                      IllegalArgumentException

Copy the given original object to the given destination object. Note: this method decorates the method of BeanUtils.copyProperties(Object, Object)

Type Parameters:

DESTINATION - the generic type of the destination object.

ORIGINAL - the generic type of the original object.

Parameters:

original - the original object.

destination - the destination object.

Returns:

the destination object.

Throws:

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

InvocationTargetException - if the property accessor method throws an exception

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

copyProperties

public static final <T> T copyProperties(T original)
                                  throws IllegalAccessException,
                                         InvocationTargetException,
                                         IllegalArgumentException,
                                         InstantiationException

Copy the given object and return a copy of it. Note: this method decorates the method of BeanUtils.copyProperties(Object, Object) and create a new object for the returned object.

Type Parameters:

T - the generic type of the given object.

Parameters:

original - the original object.

Returns:

the new object that is a copy of the given object.

Throws:

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

InvocationTargetException - if the property accessor method throws an exception

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

InstantiationException - Thrown if one of the following reasons: the class object

• represents an abstract class
• represents an interface
• represents an array class
• represents a primitive type
• represents void
• has no nullary constructor

copySerializedObject

public static <T extends Serializable> T copySerializedObject(T orig)
                                                       throws IOException,
                                                              ClassNotFoundException

Copys the given Object and returns the copy from the object or null if the object can't be serialized.

Type Parameters:

T - the generic type of the given object

Parameters:

orig - The object to copy.

Returns:

Returns a copy from the original object.

Throws:

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

ClassNotFoundException - is thrown when a class is not found in the classloader or no definition for the class with the specified name could be found.