org.plasma.sdo
Interface PlasmaChangeSummary

All Superinterfaces:

ChangeSummary

All Known Implementing Classes:

CoreChangeSummary

public interface PlasmaChangeSummary
extends ChangeSummary

A change summary is used to record changes to DataObjects, allowing applications to efficiently and incrementally update back-end storage when required.

Nested Class Summary

Nested classes/interfaces inherited from interface commonj.sdo.ChangeSummary

ChangeSummary.Setting

Method Summary

void	clear(DataObject dataObject) Removes all change information for the given data object within this change summary.
void	created(DataObject dataObject) Register the given data object as a created object within this change summary.
void	deleted(DataObject dataObject) Register the given data object as a deleted object within this change summary.
int	getPathDepth(DataObject dataObject) Returns the path depth within the data graph for the given data object.
void	modified(DataObject dataObject, Property property, java.lang.Object oldValue) Register the given data object as a modified object within this change summary for the given property.

Methods inherited from interface commonj.sdo.ChangeSummary

beginLogging, endLogging, getChangedDataObjects, getDataGraph, getOldContainer, getOldContainmentProperty, getOldSequence, getOldValue, getOldValues, getRootObject, isCreated, isDeleted, isLogging, isModified, undoChanges

Method Detail

created

void created(DataObject dataObject)

Register the given data object as a created object within this change summary.

Parameters:

dataObject - the created data object

deleted

void deleted(DataObject dataObject)

Register the given data object as a deleted object within this change summary.

Parameters:

dataObject - the deleted data object

modified

void modified(DataObject dataObject,
              Property property,
              java.lang.Object oldValue)

Register the given data object as a modified object within this change summary for the given property.

Parameters:

dataObject - the modified data object

property - the modified property

oldValue - the previous value for the given property

clear

void clear(DataObject dataObject)

Removes all change information for the given data object within this change summary.

Parameters:

dataObject - the data object

getPathDepth

int getPathDepth(DataObject dataObject)

Returns the path depth within the data graph for the given data object.

Parameters:

dataObject - the data object

Returns:

the path depth