- All Known Implementing Classes:
SDOChangeSummary
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interface -
Method Summary
Modifier and TypeMethodDescriptionvoidClears the List ofchangesand turns change logging on.voidAn implementation that requires logging may throw an UnsupportedOperationException.Returns a list consisting of all thedata objectsthat have been changed whilelogging.Deprecated.getOldContainer(DataObject dataObject) getOldContainmentProperty(DataObject dataObject) Returns the value of thecontainment propertydata object property at the point when loggingbegan.getOldSequence(DataObject dataObject) getOldValue(DataObject dataObject, Property property) getOldValues(DataObject dataObject) Returns the ChangeSummary root DataObject - the object from which changes are tracked.booleanisCreated(DataObject dataObject) Returns whether or not the specified data object was created whilelogging.booleanisDeleted(DataObject dataObject) Returns whether or not the specified data object was deleted whilelogging.booleanIndicates whether change logging is on (true) or off (false).booleanisModified(DataObject dataObject) Returns whether or not the specified data object was updated whilelogging.voidThis method is intended for use by service implementations only.
-
Method Details
-
isLogging
boolean isLogging()Indicates whether change logging is on (true) or off (false).- Returns:
trueif change logging is on.- See Also:
-
getDataGraph
DataGraph getDataGraph()Deprecated.Returns thedata graphassociated with this change summary or null.- Returns:
- the data graph.
- See Also:
-
getChangedDataObjects
List getChangedDataObjects()Returns a list consisting of all thedata objectsthat have been changed whilelogging.The
newandmodifiedobjects in the List are references to objects associated with this ChangeSummary. Thedeletedobjects in the List are references to objects at the time that event logging was enabled;Each changed object must have exactly one of the following methods return true:
isCreated,isDeleted, orisModified.- Returns:
- a list of changed data objects.
- See Also:
-
isCreated
Returns whether or not the specified data object was created whilelogging. Any object that was added to the scope but was not in the scope when logging began, will be considered created.- Parameters:
dataObject- the data object in question.- Returns:
trueif the specified data object was created.- See Also:
-
isDeleted
Returns whether or not the specified data object was deleted whilelogging. Any object that is not in scope but was in scope when logging began will be considered deleted.- Parameters:
dataObject- the data object in question.- Returns:
trueif the specified data object was deleted.- See Also:
-
getOldValues
Returns a list ofsettingsthat represent the property values of the givendataObjectat the point when loggingbegan.In the case of a
deletedobject, the List will include settings for all the Properties.An old value setting indicates the value at the point logging begins. A setting is only produced for
modifiedobjects if either the old value differs from the current value or if the isSet differs from the current value.No settings are produced for
createdobjects.- Parameters:
dataObject- the object in question.- Returns:
- a list of settings.
- See Also:
-
beginLogging
void beginLogging()Clears the List ofchangesand turns change logging on. No operation occurs if logging is already on.- See Also:
-
endLogging
void endLogging()An implementation that requires logging may throw an UnsupportedOperationException. Turns change logging off. No operation occurs if logging is already off.- See Also:
-
isModified
Returns whether or not the specified data object was updated whilelogging. An object that was contained in the scope when logging began and remains in the scope when logging ends will be considered potentially modified.An object considered modified must have at least one old value setting.
- Parameters:
dataObject- the data object in question.- Returns:
trueif the specified data object was modified.- See Also:
-
getRootObject
DataObject getRootObject()Returns the ChangeSummary root DataObject - the object from which changes are tracked.- Returns:
- the ChangeSummary root DataObject
-
getOldValue
Returns asettingfor the specified property representing the property value of the givendataObjectat the point when loggingbegan.Returns null if the property was not modified and has not been
deleted.- Parameters:
dataObject- the object in question.property- the property of the object.- Returns:
- the Setting for the specified property.
- See Also:
-
getOldContainer
- Parameters:
dataObject- the object in question.- Returns:
- the old container data object.
-
getOldContainmentProperty
Returns the value of thecontainment propertydata object property at the point when loggingbegan.- Parameters:
dataObject- the object in question.- Returns:
- the old containment property.
-
getOldSequence
- Parameters:
dataObject- the object in question.- Returns:
- the old containment property.
-
undoChanges
void undoChanges()This method is intended for use by service implementations only. Undoes all changes in the log to restore the tree of DataObjects to its original state when logging began. isLogging() is unchanged. The log is cleared.- See Also:
-