- All Known Implementing Classes:
SDOChangeSummary
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interface
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Clears the List ofchanges
and turns change logging on.void
An implementation that requires logging may throw an UnsupportedOperationException.Returns a list consisting of all thedata objects
that have been changed whilelogging
.Deprecated.getOldContainer
(DataObject dataObject) getOldContainmentProperty
(DataObject dataObject) Returns the value of thecontainment property
data 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.boolean
isCreated
(DataObject dataObject) Returns whether or not the specified data object was created whilelogging
.boolean
isDeleted
(DataObject dataObject) Returns whether or not the specified data object was deleted whilelogging
.boolean
Indicates whether change logging is on (true
) or off (false
).boolean
isModified
(DataObject dataObject) Returns whether or not the specified data object was updated whilelogging
.void
This 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:
true
if change logging is on.- See Also:
-
getDataGraph
DataGraph getDataGraph()Deprecated.Returns thedata graph
associated with this change summary or null.- Returns:
- the data graph.
- See Also:
-
getChangedDataObjects
List getChangedDataObjects()Returns a list consisting of all thedata objects
that have been changed whilelogging
.The
new
andmodified
objects in the List are references to objects associated with this ChangeSummary. Thedeleted
objects 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:
true
if 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:
true
if the specified data object was deleted.- See Also:
-
getOldValues
Returns a list ofsettings
that represent the property values of the givendataObject
at the point when loggingbegan
.In the case of a
deleted
object, 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
modified
objects if either the old value differs from the current value or if the isSet differs from the current value.No settings are produced for
created
objects.- Parameters:
dataObject
- the object in question.- Returns:
- a list of settings.
- See Also:
-
beginLogging
void beginLogging()Clears the List ofchanges
and 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:
true
if 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 asetting
for the specified property representing the property value of the givendataObject
at 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 property
data 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:
-