File Doc Category Size Date Package
ChangeRecord.java API Doc Glassfish v2 API 5521 Tue May 22 16:54:42 BST 2007 oracle.toplink.essentials.internal.sessions

ChangeRecord

java.lang.Object

public abstract class ChangeRecord extends Object implements Serializable, ChangeRecord

Purpose: This class was designed as a superclass to all possible Change Record types. These Change Records holds the changes made to the objects

see: KnownSubclasses prototype.changeset.CollectionChangeRecord,prototype.changeset.DirectToFieldChangeRecord,prototype.changeset.SingleObjectChangeRecord

Fields Summary
protected String
attribute
This is the attribute name that this change record represents
protected transient DatabaseMapping
mapping
This attribute stores the mapping allong with the attribute so that the mapping does not need to be looked up
protected ObjectChangeSet
owner
This is the object change set that holds this record
Constructors Summary
Methods Summary
public java.lang.String getAttribute()
ADVANCED: Returns the name of the attribute this ChangeRecord Represents
return
java.lang.String
return attribute;
public oracle.toplink.essentials.mappings.DatabaseMapping getMapping()
ADVANCED: Returns the mapping for the attribute this ChangeRecord Represents
return mapping;
public oracle.toplink.essentials.changesets.ObjectChangeSet getOwner()
Insert the method's description here. Creation date: (5/30/00 3:42:14 PM)
return
prototype.changeset.ObjectChangeSet
return (oracle.toplink.essentials.changesets.ObjectChangeSet)owner;
public abstract void mergeRecord(oracle.toplink.essentials.internal.sessions.ChangeRecord mergeFromRecord, oracle.toplink.essentials.internal.sessions.UnitOfWorkChangeSet mergeToChangeSet, oracle.toplink.essentials.internal.sessions.UnitOfWorkChangeSet mergeFromChangeSet)
INTERNAL: This method will be used to merge one record into another
public void prepareForSynchronization(oracle.toplink.essentials.internal.sessions.AbstractSession session)
INTERNAL: Ensure this change record is ready to by sent remotely for cache synchronization In general, this means setting the CacheSynchronizationType on any ObjectChangeSets associated with this ChangeRecord

public void setAttribute(java.lang.String newValue)
Sets the name of the attribute that this Record represents
param
newValue java.lang.String
this.attribute = newValue;
public void setMapping(oracle.toplink.essentials.mappings.DatabaseMapping mapping)
Sets the mapping for the attribute that this Record represents
this.mapping = mapping;
public void setOwner(oracle.toplink.essentials.internal.sessions.ObjectChangeSet newOwner)
INTERNAL: This method is used to set the ObjectChangeSet that uses this Record in that Record
param
newOwner prototype.changeset.ObjectChangeSet The changeSet that uses this record
owner = newOwner;
public java.lang.String toString()
return this.getClass().getName() + "(" + getAttribute() + ")";
public void updateChangeRecordWithNewValue(java.lang.Object newValue)
INTERNAL: used by the record to update the new value ignores the value in the default implementation
//no op
public abstract void updateReferences(oracle.toplink.essentials.internal.sessions.UnitOfWorkChangeSet mergeToChangeSet, oracle.toplink.essentials.internal.sessions.UnitOfWorkChangeSet mergeFromChangeSet)
INTERNAL: This method will be used to update the objectsChangeSets references