Module org.apache.jena.rdfpatch

Package org.apache.jena.rdfpatch.system

Class RDFChangesSuppressEmpty

java.lang.Object

org.apache.jena.rdfpatch.changes.RDFChangesWrapper

org.apache.jena.rdfpatch.system.RDFChangesSuppressEmpty

All Implemented Interfaces:

RDFChanges

public class RDFChangesSuppressEmpty
extends RDFChangesWrapper

Note whether a change has happened and call different operations on txnCommit A change is a call to one of the dataset-changing operations, add, delete, addPrefix, deletePrefix. Setting headers is not consided a change.

If a change has been made, txnChangeCommit() is called, otherwise txnNoChangeCommit() is called. The implementation of these methods must call doCommit(), to accept the change or doAbort() to cancel it.

A common case is to suppress empty transactions. To do this, call doAbort() in txnNoChangeCommit()

Constructor Summary

Constructors

Constructor	Description
RDFChangesSuppressEmpty(RDFChanges other)

Method Summary

Modifier and Type	Method	Description
void	add(Node g, Node s, Node p, Node o)	Notification that a quad or triple is added.
void	addPrefix(Node gn, String prefix, String uriStr)	Add a prefix.
void	delete(Node g, Node s, Node p, Node o)	Notification that a quad or triple is deleted.
final void	deletePrefix(Node gn, String prefix)	Delete a prefix.
void	header(String field, Node value)	Header field.
final void	txnAbort()	Indicator that a transaction aborts
final void	txnBegin()	Indicator that a transaction begins, or becomes a write transaction.
final void	txnCommit()	Indicator that a transaction commits.

Methods inherited from class org.apache.jena.rdfpatch.changes.RDFChangesWrapper

finish, segment, start

Methods inherited from class java.lang.Object

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

Constructor Details

RDFChangesSuppressEmpty

public RDFChangesSuppressEmpty(RDFChanges other)

Method Details

header

public void header(String field,
 Node value)

Description copied from interface: RDFChanges

Header field. Headers are metadata about the changes being made.

Specified by:

header in interface RDFChanges

Overrides:

header in class RDFChangesWrapper

add

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

Description copied from interface: RDFChanges

Notification that a quad or triple is added. A stream of Triples outside a dataset will have null for the graph name. Inside an RDF Dataset, it may be more natural to use "urn:x-arq:DefaultGraph" or "urn:x-arq:DefaultGraphNode" in which case test with Quad.isDefaultGraph(Node).

It is not defined whether the add happens before or after this notification all.

Specified by:

add in interface RDFChanges

Overrides:

add in class RDFChangesWrapper

delete

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

Description copied from interface: RDFChanges

Notification that a quad or triple is deleted. A stream of Triples outside a dataset will have null for the graph name. Inside an RDF Dataset, it may be more natural to use "urn:x-arq:DefaultGraph" or "urn:x-arq:DefaultGraphNode" in which case test with Quad.isDefaultGraph(Node).

It is not defined whether the delete happens before or after this notification all.

Specified by:

delete in interface RDFChanges

Overrides:

delete in class RDFChangesWrapper

addPrefix

public void addPrefix(Node gn,
 String prefix,
 String uriStr)

Description copied from interface: RDFChanges

Add a prefix. The graph name follows the same rules as RDFChanges.add(org.apache.jena.graph.Node, org.apache.jena.graph.Node, org.apache.jena.graph.Node, org.apache.jena.graph.Node).

Specified by:

addPrefix in interface RDFChanges

Overrides:

addPrefix in class RDFChangesWrapper

deletePrefix

public final void deletePrefix(Node gn,
 String prefix)

Description copied from interface: RDFChanges

Delete a prefix. The graph name follows the same rules as RDFChanges.add(org.apache.jena.graph.Node, org.apache.jena.graph.Node, org.apache.jena.graph.Node, org.apache.jena.graph.Node).

Specified by:

deletePrefix in interface RDFChanges

Overrides:

deletePrefix in class RDFChangesWrapper

txnBegin

public final void txnBegin()

Description copied from interface: RDFChanges

Indicator that a transaction begins, or becomes a write transaction.

Specified by:

txnBegin in interface RDFChanges

Overrides:

txnBegin in class RDFChangesWrapper

txnCommit

public final void txnCommit()

Description copied from interface: RDFChanges

Indicator that a transaction commits. If this throws an exception, the transaction will be aborted locally and not commit after all.

Specified by:

txnCommit in interface RDFChanges

Overrides:

txnCommit in class RDFChangesWrapper

txnAbort

public final void txnAbort()

Description copied from interface: RDFChanges

Indicator that a transaction aborts

Specified by:

txnAbort in interface RDFChanges

Overrides:

txnAbort in class RDFChangesWrapper