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 boolean	closeOutputStream(OutputStream out) Closes the given OutputStream.
static <ORIGINAL,DESTINATION> DESTINATION	copy(ORIGINAL original, DESTINATION destination) Copy the given original object to the given destination object.
static <ORIGINAL,DESTINATION> DESTINATION	copyPropertyWithReflection(ORIGINAL original, DESTINATION destination, String fieldName) Copy the given original object to the given destination object.
static <ORIGINAL,DESTINATION> DESTINATION	copyQuietly(ORIGINAL original, DESTINATION destination) Copy quietly 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.
static <DESTINATION,ORIGINAL> boolean	isCopyable(ORIGINAL original, DESTINATION destination) 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

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 or null if the copy process failed.

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

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.

copyQuietly

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

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:

original - the original object.

destination - the destination object.

Returns:

the destination object or null if the copy process failed.

isCopyable

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

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:

original - the original object.

destination - the destination object.

Returns:

true, if is copyable otherwise false.

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.

closeOutputStream

public static boolean closeOutputStream(OutputStream out)

Closes the given OutputStream.

Parameters:

out - The OutputStream to close.

Returns:

Returns true if the OutputStream is closed otherwise false.