org.plasma.sdo
Interface PlasmaDataGraph

All Superinterfaces:
DataGraph, java.io.Serializable
All Known Implementing Classes:
CoreDataGraph

public interface PlasmaDataGraph
extends DataGraph

Implementation specific extensions to SDO data graph API.

A data graph is used to package a graph of data objects along with their metadata, that is, data describing the data. A data graph also contains a change summary which is used to record changes made to the objects in the graph.


Method Summary
 void accept(PlasmaDataGraphEventVisitor visitor)
          Begin breadth-first traversal of this DataGraph, the given visitor receiving various events for each graph node traversed.
 void accept(PlasmaDataGraphVisitor visitor)
          Begin breadth-first traversal of this DataGraph, the given visitor receiving "visit" events for each graph node traversed.
 void acceptDepthFirst(PlasmaDataGraphVisitor visitor)
          Begin depth-first traversal of this DataGraph, the given visitor receiving "visit" events for each graph node traversed.
 java.lang.String dump()
           
 java.lang.String dumpDepthFirst()
           
 java.lang.Object getId()
          Returns an object to be used and managed by client Data Access Services as an identifier for a Data Graph.
 java.lang.String getPath(DataObject dataObject)
          Calculates and returns the path to the given Data Object relative to the Data Graph root.
 java.util.UUID getUUID()
          Returns the UUID for this data graph, which is the same UUID used for the root Data Object.
 java.lang.String getUUIDAsString()
          Returns the UUID for this data graph, which is the same UUID used for the root Data Object, as a character string.
 DataObject removeRootObject()
          Detaches and returns the root data object of this data graph.
 void setId(java.lang.Object id)
          Sets an object to be used and managed by client Data Access Services as an identifier for a Data Graph.
 
Methods inherited from interface commonj.sdo.DataGraph
createRootObject, createRootObject, getChangeSummary, getRootObject, getType
 

Method Detail

getUUID

java.util.UUID getUUID()
Returns the UUID for this data graph, which is the same UUID used for the root Data Object.

Returns:
the UUID for this data graph, which is the same UUID used for the root Data Object.

getUUIDAsString

java.lang.String getUUIDAsString()
Returns the UUID for this data graph, which is the same UUID used for the root Data Object, as a character string.

Returns:
the UUID for this data graph, which is the same UUID used for the root Data Object, as a character string.

setId

void setId(java.lang.Object id)
Sets an object to be used and managed by client Data Access Services as an identifier for a Data Graph.

Parameters:
id - the identifier

getId

java.lang.Object getId()
Returns an object to be used and managed by client Data Access Services as an identifier for a Data Graph.

Returns:
the identifier

removeRootObject

DataObject removeRootObject()
Detaches and returns the root data object of this data graph.

Returns:
the root data object.
See Also:
DataObject.getDataGraph()

getPath

java.lang.String getPath(DataObject dataObject)
Calculates and returns the path to the given Data Object relative to the Data Graph root.

Parameters:
dataObject - the target Data Object
Returns:
the path to the given Data Object relative to the Data Graph root.

accept

void accept(PlasmaDataGraphVisitor visitor)
Begin breadth-first traversal of this DataGraph, the given visitor receiving "visit" events for each graph node traversed.

Parameters:
visitor - the graph visitor receiving traversal events
See Also:
DataGraph, DataObject, PlasmaDataGraph, PlasmaDataObject, PlasmaDataGraphVisitor.visit()

acceptDepthFirst

void acceptDepthFirst(PlasmaDataGraphVisitor visitor)
Begin depth-first traversal of this DataGraph, the given visitor receiving "visit" events for each graph node traversed.

Parameters:
visitor - the graph visitor receiving traversal events
See Also:
DataGraph, DataObject, PlasmaDataGraph, PlasmaDataObject, PlasmaDataGraphVisitor.visit()

accept

void accept(PlasmaDataGraphEventVisitor visitor)
Begin breadth-first traversal of this DataGraph, the given visitor receiving various events for each graph node traversed.

Parameters:
visitor - the graph visitor receiving traversal events
See Also:
DataGraph, DataObject, PlasmaDataGraph, PlasmaDataObject, PlasmaDataGraphEventVisitor.start(), PlasmaDataGraphEventVisitor.end()

dump

java.lang.String dump()

dumpDepthFirst

java.lang.String dumpDepthFirst()


Copyright © 2013. All Rights Reserved.