org.eclipse.persistence.internal.sessions

Class DeferrableChangeRecord

java.lang.Object

org.eclipse.persistence.internal.sessions.ChangeRecord

org.eclipse.persistence.internal.sessions.DeferrableChangeRecord

All Implemented Interfaces:

java.io.Serializable, ChangeRecord

Direct Known Subclasses:

CollectionChangeRecord, DirectCollectionChangeRecord, DirectMapChangeRecord

public abstract class DeferrableChangeRecord
extends ChangeRecord

Abstract change record for collection type records that allow deferrable change detection. Used for change tracking when user sets entire collection.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DeferrableChangeRecord()
DeferrableChangeRecord(ObjectChangeSet owner)

Method Summary

Modifier and Type	Method and Description
abstract void	clearChanges() Clears info about added / removed objects set by change tracker.
java.lang.Object	getLatestCollection() Used for change tracking when user sets entire collection.
java.lang.Object	getOldValue() ADVANCED: If the owning UnitOfWork has shouldChangeRecordKeepOldValue set to true, then return the old value of the attribute represented by this ChangeRecord.
java.lang.Object	getOldValue(java.lang.Object currentCollection, AbstractSession session)
java.lang.Object	getOriginalCollection() Used for change tracking when user sets entire collection.
abstract void	internalRecreateOriginalCollection(java.lang.Object currentCollection, AbstractSession session) Recreates the original state of currentCollection.
boolean	isDeferred() Returns if this change should be calculated at commit time using the two collections.
void	recreateOriginalCollection(java.lang.Object currentCollection, AbstractSession session) Recreates the original state of the collection.
void	setIsDeferred(boolean isDeferred) Sets if this change should be calculated at commit time using the two collections.
void	setLatestCollection(java.lang.Object latestCollection) Used for change tracking when user sets entire collection.
void	setOriginalCollection(java.lang.Object originalCollection) Used for change tracking when user sets entire collection.

Methods inherited from class org.eclipse.persistence.internal.sessions.ChangeRecord

getAttribute, getMapping, getOwner, mergeRecord, prepareForSynchronization, setAttribute, setMapping, setOwner, toString, updateChangeRecordWithNewValue, updateReferences

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DeferrableChangeRecord

public DeferrableChangeRecord()

DeferrableChangeRecord

public DeferrableChangeRecord(ObjectChangeSet owner)

Method Detail

isDeferred

public boolean isDeferred()

Returns if this change should be calculated at commit time using the two collections. This is used to handle collection replacement.

setIsDeferred

public void setIsDeferred(boolean isDeferred)

Sets if this change should be calculated at commit time using the two collections. This is used to handle collection replacement.

getLatestCollection

public java.lang.Object getLatestCollection()

Used for change tracking when user sets entire collection. This is the last collection that was set on the object.

getOriginalCollection

public java.lang.Object getOriginalCollection()

Used for change tracking when user sets entire collection. This is the original collection that was set on the object when it was cloned.

setLatestCollection

public void setLatestCollection(java.lang.Object latestCollection)

Used for change tracking when user sets entire collection. This is the last collection that was set on the object.

setOriginalCollection

public void setOriginalCollection(java.lang.Object originalCollection)

Used for change tracking when user sets entire collection. This is the original collection that was set on the object when it was cloned.

internalRecreateOriginalCollection

public abstract void internalRecreateOriginalCollection(java.lang.Object currentCollection,
                                                        AbstractSession session)

Recreates the original state of currentCollection.

clearChanges

public abstract void clearChanges()

Clears info about added / removed objects set by change tracker. Called after the change info has been already used for creation of originalCollection. Also called to make sure there is no change info before comparison for change is performed (change info is still in the record after comparison for change is performed and may cause wrong results when the second comparison for change performed on the same change record).

recreateOriginalCollection

public void recreateOriginalCollection(java.lang.Object currentCollection,
                                       AbstractSession session)

Recreates the original state of the collection.

getOldValue

public java.lang.Object getOldValue()

ADVANCED: If the owning UnitOfWork has shouldChangeRecordKeepOldValue set to true, then return the old value of the attribute represented by this ChangeRecord.

getOldValue

public java.lang.Object getOldValue(java.lang.Object currentCollection,
                                    AbstractSession session)