com.phloc.commons.lang

Class CloneHelper

java.lang.Object

com.phloc.commons.lang.CloneHelper

@Immutable
public final class CloneHelper
extends Object

Helper class for cloning objects.

Author:

Philip Helger

Method Summary

Methods

Modifier and Type	Method and Description
static <DATATYPE> DATATYPE	getClonedValue(DATATYPE aObject) Get a clone (= deep copy) of the passed value.
static <DATATYPE extends ICloneable<DATATYPE>> DATATYPE	getCloneIfNotNull(DATATYPE aObject) Get a clone (= deep copy) of the passed value for all objects implementing ICloneable.

Methods inherited from class java.lang.Object

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

Method Detail

getClonedValue

@Nullable
public static <DATATYPE> DATATYPE getClonedValue(@Nullable
                                          DATATYPE aObject)

Get a clone (= deep copy) of the passed value. The following things are tried for cloning:

1. If the object is immutable, it is returned as is (if it is a primitive type or marked with the Immutable annotation.
2. If the object implements ICloneable it is invoked.
3. If the object implements Cloneable it is invoked.
4. If a copy constructor (a constructor taking one argument of the same class as it declares)

If all tries fail, null is returned.

Parameters:

aObject - The object to be copied.

Returns:

null if the passed value is null or if no cloning could be performed.

getCloneIfNotNull

@Nullable
public static <DATATYPE extends ICloneable<DATATYPE>> DATATYPE getCloneIfNotNull(@Nullable
                                                                          DATATYPE aObject)

Get a clone (= deep copy) of the passed value for all objects implementing ICloneable.

Parameters:

aObject - The object to be copied. May be null.

Returns:

null if the passed value is null or a clone of the object.