org.gridgain.grid.cache.cloner

Interface GridCacheCloner

All Known Implementing Classes:

GridCacheBasicCloner, GridCacheDeepCloner

public interface GridCacheCloner

Cache cloner which clones cached values before returning them from cache. It will only be used if GridCacheFlag.CLONE flag is set on projection which the user is working with (this flag is disabled by default).

This behaviour is useful, as a an example, when we need to get some object from cache, change some of its properties and put it back into cache. In such a scenario it would be wrong to change properties of cached value itself without creating a copy first, since it would break cache integrity, and will affect the cached values returned to other threads even before the transaction commits.

Cache cloner can be set in cache configuration via GridCacheConfiguration.getCloner() method. By default, cache uses GridCacheBasicCloner implementation which will clone only objects implementing Cloneable interface. You can also configure cache to use GridCacheDeepCloner which will perform deep-cloning of all objects returned from cache, regardless of the Cloneable interface. If none of the above cloners fit your logic, you can also provide your own implementation of this interface.

See Also:

GridCacheBasicCloner, GridCacheDeepCloner, GridCacheConfiguration.getCloner(), GridCacheConfiguration.setCloner(GridCacheCloner)

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	cloneValue(T val)

Method Detail

cloneValue

@Nullable
<T> T cloneValue(T val)
             throws GridException

Parameters:

val - Object to make a clone for.

Returns:

Clone for given object.

Throws:

GridException - If failed to clone given object.