org.apache.jena.sparql.core

Class DatasetGraphMonitor

java.lang.Object

org.apache.jena.sparql.core.DatasetGraphWrapper

org.apache.jena.sparql.core.DatasetGraphMonitor

All Implemented Interfaces:

org.apache.jena.atlas.lib.Closeable, org.apache.jena.atlas.lib.Sync, DatasetGraph, Transactional

public class DatasetGraphMonitor
extends DatasetGraphWrapper

Connect a DatasetGraph to a DatasetChanges monitor. Any add or delete to the DatasetGraph is notified to the monitoring object with a QuadAction to indicate the change made.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.jena.sparql.core.Transactional

Transactional.Promote

Constructor Summary

Constructors

Constructor and Description
DatasetGraphMonitor(DatasetGraph dsg, DatasetChanges monitor) Create a DatasetGraph wrapper that monitors the dataset for changes (add or delete quads).
DatasetGraphMonitor(DatasetGraph dsg, DatasetChanges monitor, boolean recordOnlyIfRealChange) Create a DatasetGraph wrapper that monitors the dataset for changes (add or delete quads).

Method Summary

Modifier and Type	Method and Description
void	add(Node g, Node s, Node p, Node o) Add a quad
void	add(Quad quad) Add a quad
void	addGraph(Node gn, Graph g) Add the given graph to the dataset.
void	delete(Node g, Node s, Node p, Node o) Delete a quad
void	delete(Quad quad) Delete a quad
void	deleteAny(Node g, Node s, Node p, Node o) Delete any quads matching the pattern
Graph	getDefaultGraph() Get the default graph as a Jena Graph
Graph	getGraph(Node graphNode) Get the graph named by graphNode : returns null when there is no such graph.
DatasetChanges	getMonitor() Return the monitor
DatasetGraph	monitored() Return the monitored DatasetGraph
void	removeGraph(Node gn) Remove all data associated with the named graph.
void	sync()

Methods inherited from class org.apache.jena.sparql.core.DatasetGraphWrapper

abort, begin, begin, begin, clear, close, commit, contains, contains, containsGraph, end, find, find, find, findNG, getBase, getBaseForQuery, getContext, getLock, getUnionGraph, getWrapped, isEmpty, isInTransaction, listGraphNodes, promote, promote, setDefaultGraph, size, supportsTransactionAbort, supportsTransactions, toString, transactionMode, transactionType

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DatasetGraphMonitor

public DatasetGraphMonitor(DatasetGraph dsg,
                           DatasetChanges monitor)

Create a DatasetGraph wrapper that monitors the dataset for changes (add or delete quads). Use this DatasetGraph for all operations in order to record changes. Note whether additions of deletions cause an actual change to the dataset or not.

Parameters:

dsg - The DatasetGraph to monitor

monitor - The handler for a change

See Also:

DatasetChanges, QuadAction

DatasetGraphMonitor

public DatasetGraphMonitor(DatasetGraph dsg,
                           DatasetChanges monitor,
                           boolean recordOnlyIfRealChange)

Create a DatasetGraph wrapper that monitors the dataset for changes (add or delete quads). Use this DatasetGraph for all operations in order to record changes.

Parameters:

dsg - The DatasetGraph to monitor

monitor - The handler for a change

recordOnlyIfRealChange - If true, check to see if the change would have an effect (e.g. add is a new quad). If false, log changes as ADD/DELETE regardless of whether the dataset actually changes.

See Also:

DatasetChanges, QuadAction

Method Detail

getMonitor

public DatasetChanges getMonitor()

Return the monitor

monitored

public DatasetGraph monitored()

Return the monitored DatasetGraph

add

public void add(Quad quad)

Description copied from interface: DatasetGraph

Add a quad

Specified by:

add in interface DatasetGraph

Overrides:

add in class DatasetGraphWrapper

add

public void add(Node g,
                Node s,
                Node p,
                Node o)

Description copied from interface: DatasetGraph

Add a quad

Specified by:

add in interface DatasetGraph

Overrides:

add in class DatasetGraphWrapper

delete

public void delete(Quad quad)

Description copied from interface: DatasetGraph

Delete a quad

Specified by:

delete in interface DatasetGraph

Overrides:

delete in class DatasetGraphWrapper

delete

public void delete(Node g,
                   Node s,
                   Node p,
                   Node o)

Description copied from interface: DatasetGraph

Delete a quad

Specified by:

delete in interface DatasetGraph

Overrides:

delete in class DatasetGraphWrapper

deleteAny

public void deleteAny(Node g,
                      Node s,
                      Node p,
                      Node o)

Description copied from interface: DatasetGraph

Delete any quads matching the pattern

Specified by:

deleteAny in interface DatasetGraph

Overrides:

deleteAny in class DatasetGraphWrapper

addGraph

public void addGraph(Node gn,
                     Graph g)

Description copied from interface: DatasetGraph

Add the given graph to the dataset. Replaces any existing data for the named graph; to add data, get the graph and add triples to it, or add quads to the dataset. Do not assume that the same Java object is returned by DatasetGraph.getGraph(org.apache.jena.graph.Node)

Specified by:

addGraph in interface DatasetGraph

Overrides:

addGraph in class DatasetGraphWrapper

removeGraph

public void removeGraph(Node gn)

Description copied from interface: DatasetGraph

Remove all data associated with the named graph. This will include prefixes associated with the graph.

Specified by:

removeGraph in interface DatasetGraph

Overrides:

removeGraph in class DatasetGraphWrapper

sync

public void sync()

Specified by:

sync in interface org.apache.jena.atlas.lib.Sync

Overrides:

sync in class DatasetGraphWrapper

getDefaultGraph

public Graph getDefaultGraph()

Description copied from interface: DatasetGraph

Get the default graph as a Jena Graph

Specified by:

getDefaultGraph in interface DatasetGraph

Overrides:

getDefaultGraph in class DatasetGraphWrapper

getGraph

public Graph getGraph(Node graphNode)

Description copied from interface: DatasetGraph

Get the graph named by graphNode : returns null when there is no such graph. NB Whether a dataset contains a graph if there are no triples is not defined - see the specific implementation. Some datasets are "open" - they have all graphs even if no triples.

Specified by:

getGraph in interface DatasetGraph

Overrides:

getGraph in class DatasetGraphWrapper