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> boolean	copyField(@NonNull Field field, ORIGINAL original, DESTINATION destination) Copy the given original object to the given destination object.
static <ORIGINAL,DESTINATION> DESTINATION	copyObject(ORIGINAL original, DESTINATION destination) Copy the given original object to the given destination object.
static <ORIGINAL,DESTINATION> DESTINATION	copyObject(ORIGINAL original, DESTINATION destination, String... ignoreFields) Copy the given original object to the given destination object.
static <T> T	copyObject(T original) Copy the given original 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

copyObject

public static <T> T copyObject(@NonNull
                               T original)
                        throws IllegalAccessException,
                               InstantiationException,
                               ClassNotFoundException

Copy the given original object.

Type Parameters:

T - the generic type of the given object

Parameters:

original - the original object

Returns:

a copy of the given original object

Throws:

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

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

ClassNotFoundException - is thrown if the class cannot be located

copyObject

public static <ORIGINAL,DESTINATION> DESTINATION copyObject(@NonNull
                                                            ORIGINAL original,
                                                            @NonNull
                                                            DESTINATION destination)
                                                     throws IllegalAccessException,
                                                            InstantiationException,
                                                            ClassNotFoundException

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.

Returns:

a copy of the given original object

Throws:

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

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

ClassNotFoundException - is thrown if the class cannot be located

copyObject

public static <ORIGINAL,DESTINATION> DESTINATION copyObject(@NonNull
                                                            ORIGINAL original,
                                                            @NonNull
                                                            DESTINATION destination,
                                                            String... ignoreFields)
                                                     throws IllegalAccessException,
                                                            InstantiationException,
                                                            ClassNotFoundException

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.

ignoreFields - optional field names to ignore

Returns:

a copy of the given original object

Throws:

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

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

ClassNotFoundException - is thrown if the class cannot be located

copyField

public static <ORIGINAL,DESTINATION> boolean copyField(@NonNull
                                                       @NonNull Field field,
                                                       @NonNull
                                                       ORIGINAL original,
                                                       @NonNull
                                                       DESTINATION destination)
                                                throws IllegalAccessException,
                                                       InstantiationException,
                                                       ClassNotFoundException

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:

field - the field

original - the original object.

destination - the destination object.

Returns:

true if the field is null or final otherwise false

Throws:

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

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

ClassNotFoundException - is thrown if the class cannot be located

copyPropertyWithReflection

public static <ORIGINAL,DESTINATION> DESTINATION copyPropertyWithReflection(ORIGINAL original,
                                                                            DESTINATION destination,
                                                                            String fieldName)
                                                                     throws NoSuchFieldException,
                                                                            SecurityException,
                                                                            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.

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

copy

public static <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

copyProperties

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

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

copyProperties

public static <T> T copyProperties(T original)
                            throws IllegalAccessException,
                                   InvocationTargetException,
                                   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

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.