org.jadira.reflection.cloning.api

Interface CloneImplementor

All Known Subinterfaces:

CloneDriver, CloneStrategy

All Known Implementing Classes:

AbstractCloneStrategy, ArrayListImplementor, AsmCloneStrategy, BasicCloner, ConcurrentHashMapImplementor, CopyConstructorImplementor, GregorianCalendarImplementor, HashMapImplementor, HashSetImplementor, InvokeDynamicCloneStrategy, LinkedListImplementor, MinimalCloner, NoCloneImplementor, PortableCloneStrategy, ReflectionMethodImplementor, TreeMapImplementor, UnsafeCloneStrategy

public interface CloneImplementor

A CloneImplementor represents an atomic cloning capability. The interface is implemented by classes that can clone a specific type, as well as by CloneStrategy and CloneDriver implementations. In general users do not work with the methods on this class, using Cloner instead

Method Summary

Modifier and Type	Method and Description
boolean	canClone(Class<?> clazz) True if this implementor can clone the given class
<T> T	clone(T obj, CloneDriver context, IdentityHashMap<Object,Object> referencesToReuse, long stackDepth) Performs a clone.
<T> T	newInstance(Class<T> c) Create a new, uninitialised instance of the given class (if supported).

Method Detail

newInstance

<T> T newInstance(Class<T> c)

Create a new, uninitialised instance of the given class (if supported). Depending on strategy, this may or may not initialise instance fields, and may or may not invoke constructors.

Type Parameters:

T - The type of the instance to be constructed

Parameters:

c - Type to create instance of

Returns:

The new instance

canClone

boolean canClone(Class<?> clazz)

True if this implementor can clone the given class

Parameters:

clazz - The class

Returns:

True if cloneable, false otherwise

clone

<T> T clone(T obj,
            CloneDriver context,
            IdentityHashMap<Object,Object> referencesToReuse,
            long stackDepth)

Performs a clone.

Type Parameters:

T - The type of the object to be cloned

Parameters:

obj - Object to clone

context - The CloneDriver that initiated the request

referencesToReuse - Any references for objects already cloned to ensure reference identity is preserved

stackDepth - The number of objects already cloned in the current data structure

Returns:

The cloned object