org.gridgain.grid.cache.cloner

Class GridCacheDeepCloner

java.lang.Object

org.gridgain.grid.cache.cloner.GridCacheDeepCloner

All Implemented Interfaces:

GridCacheCloner

public class GridCacheDeepCloner
extends Object
implements GridCacheCloner

Cache deep cloner that creates a copy of an object using deep reflection.

If isHonorCloneable() is set to true, then deep cloner will first check if the passed in object implements Cloneable interface and, if it does, will delegate to clone() method. It is advisable for instances that need to be cloned to implement Cloneable, as cloning this way will generally be faster than reflection-based cloning.

This implementation will first check if the object to clone has an empty constructor. If it does, then it will be instantiated using such constructor. Otherwise an empty constructor will be fetched from JDK and used instead. Note that this behavior may not work on some JDKs in which case cloneValue(Object) method will result in GridException being thrown.

Constructor Summary

Constructors

Constructor and Description
GridCacheDeepCloner() Creates deep cloner with isHonorCloneable() flag set to true.
GridCacheDeepCloner(boolean honorCloneable) Creates a new instance of deep cloner with specified flag to honor Cloneable interface or not.

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	cloneValue(T val)
boolean	isHonorCloneable() Gets flag indicating if Cloneable interface should be honored when cloning, or if reflection-based deep cloning should always be performed.
void	setHonorCloneable(boolean honorCloneable) Sets flag indicating if Cloneable interface should be honored when cloning, or if reflection-based deep cloning should always be performed.

Methods inherited from class java.lang.Object

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

Constructor Detail

GridCacheDeepCloner

public GridCacheDeepCloner()

Creates deep cloner with isHonorCloneable() flag set to true.

GridCacheDeepCloner

public GridCacheDeepCloner(boolean honorCloneable)

Creates a new instance of deep cloner with specified flag to honor Cloneable interface or not.

Parameters:

honorCloneable - Flag indicating whether Cloneable interface should be honored or not when cloning.

Method Detail

isHonorCloneable

public boolean isHonorCloneable()

Gets flag indicating if Cloneable interface should be honored when cloning, or if reflection-based deep cloning should always be performed.

Returns:

Flag indicating if Cloneable interface should be honored when cloning

setHonorCloneable

public void setHonorCloneable(boolean honorCloneable)

Sets flag indicating if Cloneable interface should be honored when cloning, or if reflection-based deep cloning should always be performed.

Parameters:

honorCloneable - Flag indicating whether Cloneable interface should be honored or not when cloning.

cloneValue

public <T> T cloneValue(T val)
             throws GridException

Specified by:

cloneValue in interface GridCacheCloner

Parameters:

val - Object to make a clone for.

Returns:

Clone for given object.

Throws:

GridException - If failed to clone given object.