public class DatasetGraphZero extends DatasetGraphBaseFind
DatasetGraph.
One graph (the default graph) with zero triples.
No changes allowed - this is not a sink.DatasetGraphSinkTransactional.Promote| Constructor and Description |
|---|
DatasetGraphZero() |
| Modifier and Type | Method and Description |
|---|---|
void |
abort()
Abort a transaction - finish the transaction and undo any changes (if a "write" transaction)
|
void |
add(Quad quad)
Add a quad
|
void |
addGraph(Node graphName,
Graph graph)
Add the given graph to the dataset.
|
void |
begin()
Start a transaction which is READ mode and which will switch to WRITE if an update
is attempted but only if no intermediate transaction has performed an update.
|
void |
begin(ReadWrite mode)
Start either a READ or WRITE transaction.
|
void |
begin(TxnType txnType)
Start a transaction.
READ or WRITE transactions start in that state and do not change for the lifetime of the transaction. |
void |
commit()
Commit a transaction - finish the transaction and make any changes permanent (if a "write" transaction)
|
static DatasetGraph |
create() |
void |
delete(Quad quad)
Delete a quad
|
void |
deleteAny(Node g,
Node s,
Node p,
Node o)
Delete any quads matching the pattern
|
void |
end()
Finish the transaction - if a write transaction and commit() has not been called, then abort
|
Graph |
getDefaultGraph()
Get the default graph as a Jena Graph
|
Graph |
getGraph(Node graphNode)
Get the graph named by graphNode : returns null on no graph
NB Whether a dataset contains a graph if there are no triples is not defined - see the specific implementation.
|
boolean |
isInTransaction()
Say whether inside a transaction.
|
Iterator<Node> |
listGraphNodes()
Iterate over all names of named graphs
|
boolean |
promote(Transactional.Promote txnType)
Attempt to promote a transaction from "read" mode to "write" and the transaction.
|
void |
removeGraph(Node graphName)
Remove all data associated with the named graph.
|
void |
setDefaultGraph(Graph g)
Set the default graph.
|
boolean |
supportsTransactionAbort()
Declare whether
Transactional.abort() is supported. |
boolean |
supportsTransactions()
A
DatasetGraph supports transactions if it provides Transactional.begin()/
Transactional.commit()/Transactional.end(). |
ReadWrite |
transactionMode()
Return the current mode of the transaction - "read" or "write".
|
TxnType |
transactionType()
Return the transaction type used in
begin(TxnType). |
find, findInUnionGraph, findNG, findQuadsInUnionGraphadd, clear, close, contains, contains, containsGraph, delete, find, find, getContext, getLock, getUnionGraph, isEmpty, size, toStringequals, getClass, hashCode, notify, notifyAll, wait, wait, waitpromotepublic static DatasetGraph create()
public void begin()
Transactional
See Transactional.begin(TxnType) for more details an options.
May not be implemented. See Transactional.begin(ReadWrite) is guaranteed to be provided.
public void begin(TxnType txnType)
TransactionalWRITE: this guarantees a WRITE will complete if commit() is
called. The same as begin(ReadWrite.WRITE).
READ: the transaction can not promote to WRITE,ensuring read-only
access to the data. The same as begin(ReadWrite.READ).
READ_PROMOTE: the transaction will go from "read" to "write" if an
update is attempted and if the dataset has not been changed by another write
transaction. See also Transactional.promote().
READ_COMMITTED_PROMOTE: Use this with care. The promotion will
succeed but changes from other transactions become visible.
begin). If READ_PROMOTE, the dataset must not have
changed; if READ_COMMITTED_PROMOTE any intermediate changes are
visible but the application can not assume any data it has read in the
transaction is the same as it was at the point the transaction started.
This operation is optional and some implementations may throw
a JenaTransactionException exception for some or all TxnType values.
See Transactional.begin(ReadWrite) for a form that is required of implementations.
public void begin(ReadWrite mode)
Transactionalpublic boolean promote(Transactional.Promote txnType)
TransactionalREAD, which is read-only.
An argument of READ_PROMOTE treats the promotion as if the transaction was started
with READ_PROMOTE (any other writer commiting since the transaction started
blocks promotion) and READ_COMMITTED_PROMOTE treats the promotion as if the transaction was started
with READ_COMMITTED_PROMOTE (intemediate writer commits become visible).
Returns "true" if the transaction is in write mode after the call. The method always succeeds of the transaction is already "write".
This method returns true if a READ_PROMOTE or
READ_COMMITTED_PROMOTE is promoted.
This method returns false if a READ_PROMOTE can't be promoted - the
transaction is still valid and in "read" mode.
This method throws an exception if there is an attempt to promote a READ
transaction.
public void commit()
Transactionalpublic void abort()
Transactionalpublic boolean isInTransaction()
Transactionalpublic void end()
Transactionalpublic ReadWrite transactionMode()
Transactionalpublic TxnType transactionType()
Transactionalbegin(TxnType).
If the caller is not in a transaction, this method returns null.public boolean supportsTransactions()
DatasetGraphDatasetGraph supports transactions if it provides Transactional.begin()/
Transactional.commit()/Transactional.end(). The core storage DatasetGraphs
provide fully serialized transactions. A DatasetGraph that provides
functionality across independent systems can not provide such strong guarantees.
For example, it may use MRSW locking and some isolation control.
Specifically, it would not necessarily provide Transactional.abort().
See DatasetGraph.supportsTransactionAbort() for Transactional.abort().
In addition, check details of a specific implementation.
public boolean supportsTransactionAbort()
DatasetGraphTransactional.abort() is supported.
This goes along with clearing up after exceptions inside application transaction code.public Iterator<Node> listGraphNodes()
DatasetGraphpublic Graph getDefaultGraph()
DatasetGraphgetDefaultGraph in interface DatasetGraphgetDefaultGraph in class DatasetGraphBasepublic Graph getGraph(Node graphNode)
DatasetGraphgetGraph in interface DatasetGraphgetGraph in class DatasetGraphBasepublic void add(Quad quad)
DatasetGraphadd in interface DatasetGraphadd in class DatasetGraphBasepublic void delete(Quad quad)
DatasetGraphdelete in interface DatasetGraphdelete in class DatasetGraphBasepublic void deleteAny(Node g, Node s, Node p, Node o)
DatasetGraphdeleteAny in interface DatasetGraphdeleteAny in class DatasetGraphBasepublic void setDefaultGraph(Graph g)
DatasetGraphDatasetGraph.getDefaultGraph()setDefaultGraph in interface DatasetGraphsetDefaultGraph in class DatasetGraphBasepublic void addGraph(Node graphName, Graph graph)
DatasetGraphDatasetGraph.getGraph(org.apache.jena.graph.Node)addGraph in interface DatasetGraphaddGraph in class DatasetGraphBasepublic void removeGraph(Node graphName)
DatasetGraphremoveGraph in interface DatasetGraphremoveGraph in class DatasetGraphBaseLicenced under the Apache License, Version 2.0