Class CloneCopyPolicy
- java.lang.Object
-
- org.eclipse.persistence.descriptors.copying.AbstractCopyPolicy
-
- org.eclipse.persistence.descriptors.copying.CloneCopyPolicy
-
- All Implemented Interfaces:
java.io.Serializable,java.lang.Cloneable,CopyPolicy
public class CloneCopyPolicy extends AbstractCopyPolicy
Purpose: Allows a clone of an object to be created with a method that returns the cloned object. It is possible to define methods for two types of clones 1. methodName can be set to define the method EclipseLink uses to clone objects for it's own internal use. The objects created by this method will not be visible to the user, and instead used as a basis for comparison when a DeferredChangeDetectionPolicy used. This method will also be in place of the workingCopyMethod if it is not provided 2. workingCopyMethod this method is used to create the clone that is returned to the user when an Object is registered in a UnitOfWork
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected java.lang.reflect.Methodmethodprotected java.lang.StringmethodNameAllow for clone method to be specified.protected java.lang.reflect.MethodworkingCopyMethodprotected java.lang.StringworkingCopyMethodName-
Fields inherited from class org.eclipse.persistence.descriptors.copying.AbstractCopyPolicy
descriptor
-
-
Constructor Summary
Constructors Constructor Description CloneCopyPolicy()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.ObjectbuildClone(java.lang.Object domainObject, Session session)Clone through calling the clone method.booleanbuildsNewInstance()Return false as a shallow clone is returned, not a new instance.java.lang.ObjectbuildWorkingCopyClone(java.lang.Object domainObject, Session session)Clone through the workingCopyClone method, or if not specified the clone method.java.lang.ObjectbuildWorkingCopyCloneFromRow(Record row, ObjectBuildingQuery query, java.lang.Object primaryKey, UnitOfWork uow)Create a new instance, unless a workingCopyClone method is specified, then build a new instance and clone it.protected java.lang.reflect.MethodgetMethod()Return the clone method.java.lang.StringgetMethodName()Return the clone method name.protected java.lang.reflect.MethodgetWorkingCopyMethod()Return the workingCopyClone method.java.lang.StringgetWorkingCopyMethodName()Return the workingCopyClone method name.voidinitialize(Session session)Validate and build the methods.protected voidsetMethod(java.lang.reflect.Method method)Set the clone method.voidsetMethodName(java.lang.String methodName)Set the clone method name.protected voidsetWorkingCopyMethod(java.lang.reflect.Method method)Set the workingCopyClone method.voidsetWorkingCopyMethodName(java.lang.String methodName)Set the workingCopyClone method name.java.lang.StringtoString()-
Methods inherited from class org.eclipse.persistence.descriptors.copying.AbstractCopyPolicy
clone, getDescriptor, setDescriptor
-
-
-
-
Field Detail
-
methodName
protected java.lang.String methodName
Allow for clone method to be specified.
-
workingCopyMethodName
protected java.lang.String workingCopyMethodName
-
method
protected transient java.lang.reflect.Method method
-
workingCopyMethod
protected transient java.lang.reflect.Method workingCopyMethod
-
-
Method Detail
-
buildClone
public java.lang.Object buildClone(java.lang.Object domainObject, Session session) throws DescriptorExceptionClone through calling the clone method.- Specified by:
buildClonein interfaceCopyPolicy- Specified by:
buildClonein classAbstractCopyPolicy- Throws:
DescriptorException
-
buildWorkingCopyClone
public java.lang.Object buildWorkingCopyClone(java.lang.Object domainObject, Session session) throws DescriptorExceptionClone through the workingCopyClone method, or if not specified the clone method.- Specified by:
buildWorkingCopyClonein interfaceCopyPolicy- Overrides:
buildWorkingCopyClonein classAbstractCopyPolicy- Throws:
DescriptorException
-
buildWorkingCopyCloneFromRow
public java.lang.Object buildWorkingCopyCloneFromRow(Record row, ObjectBuildingQuery query, java.lang.Object primaryKey, UnitOfWork uow) throws DescriptorException
Create a new instance, unless a workingCopyClone method is specified, then build a new instance and clone it.- Specified by:
buildWorkingCopyCloneFromRowin interfaceCopyPolicy- Overrides:
buildWorkingCopyCloneFromRowin classAbstractCopyPolicy- Throws:
DescriptorException
-
getMethod
protected java.lang.reflect.Method getMethod()
Return the clone method.
-
getMethodName
public java.lang.String getMethodName()
Return the clone method name.
-
getWorkingCopyMethod
protected java.lang.reflect.Method getWorkingCopyMethod()
Return the workingCopyClone method. This is used to clone within a unit of work.
-
getWorkingCopyMethodName
public java.lang.String getWorkingCopyMethodName()
Return the workingCopyClone method name. This is used to clone within a unit of work.
-
initialize
public void initialize(Session session) throws DescriptorException
Validate and build the methods.- Specified by:
initializein interfaceCopyPolicy- Overrides:
initializein classAbstractCopyPolicy- Throws:
DescriptorException
-
setMethod
protected void setMethod(java.lang.reflect.Method method)
Set the clone method.
-
setMethodName
public void setMethodName(java.lang.String methodName)
Set the clone method name.
-
setWorkingCopyMethod
protected void setWorkingCopyMethod(java.lang.reflect.Method method)
Set the workingCopyClone method. This is used to clone within a unit of work.
-
setWorkingCopyMethodName
public void setWorkingCopyMethodName(java.lang.String methodName)
Set the workingCopyClone method name. This is used to clone within a unit of work.
-
buildsNewInstance
public boolean buildsNewInstance()
Return false as a shallow clone is returned, not a new instance.
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
-