public abstract class DyadicDatasetGraph extends org.apache.jena.atlas.lib.PairOfSameType<DatasetGraph> implements DatasetGraph
Transactional.Promote
Modifier and Type | Method and Description |
---|---|
void |
abort()
Abort a transaction - finish the transaction and undo any changes (if a "write" transaction)
|
void |
add(Node g,
Node s,
Node p,
Node o)
Add a quad
|
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 readWrite)
Start either a READ or WRITE transaction.
|
void |
begin(TxnType type)
Start a transaction.
READ or WRITE transactions start in that state and do not change for the lifetime of the transaction. |
void |
clear()
Remove everything - remove all named graphs, clear the default graph
|
void |
close()
Close the dataset
|
void |
commit()
Commit a transaction - finish the transaction and make any changes permanent (if a "write" transaction)
|
boolean |
contains(Quad q)
Test whether the dataset contains a quad (including default graph)- may include wildcards, Node.ANY or null
|
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
|
void |
end()
Finish the transaction - if a write transaction and commit() has not been called, then abort
|
Iterator<Quad> |
find()
Iterate over all quads in the dataset graph
|
Iterator<Quad> |
find(Node g,
Node s,
Node p,
Node o)
Find matching quads in the dataset (including default graph) - may include wildcards, Node.ANY or null
|
Iterator<Quad> |
find(Quad q)
Find matching quads in the dataset - may include wildcards, Node.ANY or null
|
Iterator<Quad> |
findNG(Node g,
Node s,
Node p,
Node o)
Find matching quads in the dataset in named graphs only - may include wildcards, Node.ANY or null
|
Context |
getContext()
Get the context associated with this object - may be null
|
Lock |
getLock()
Return a lock for the dataset to help with concurrency control
|
Graph |
getUnionGraph()
Return a
Graph that is the union of all named graphs in this dataset. |
boolean |
isEmpty()
Test whether the dataset is empty
|
boolean |
isInTransaction()
Say whether inside a transaction.
|
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.
|
DatasetGraph |
setContext(Context c) |
void |
setDefaultGraph(Graph g)
Set the default graph.
|
long |
size()
Get the size (number of named graphs) - may be -1 for unknown
|
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) . |
apply, both, either, forEach
car, cdr, create, equals, getLeft, getRight, hashCode, toString
contains, containsGraph, getDefaultGraph, getGraph, listGraphNodes
promote
public void commit()
Transactional
commit
in interface Transactional
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.
begin
in interface Transactional
public void begin(TxnType type)
Transactional
WRITE
: 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.
begin
in interface Transactional
public boolean promote(Transactional.Promote txnType)
Transactional
READ
, 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.
promote
in interface Transactional
public ReadWrite transactionMode()
Transactional
transactionMode
in interface Transactional
public TxnType transactionType()
Transactional
begin(TxnType)
.
If the caller is not in a transaction, this method returns null.transactionType
in interface Transactional
public void begin(ReadWrite readWrite)
Transactional
begin
in interface Transactional
public void abort()
Transactional
abort
in interface Transactional
public void end()
Transactional
end
in interface Transactional
public boolean isInTransaction()
Transactional
isInTransaction
in interface Transactional
public void setDefaultGraph(Graph g)
DatasetGraph
DatasetGraph.getDefaultGraph()
setDefaultGraph
in interface DatasetGraph
public void addGraph(Node graphName, Graph graph)
DatasetGraph
DatasetGraph.getGraph(org.apache.jena.graph.Node)
addGraph
in interface DatasetGraph
public void removeGraph(Node graphName)
DatasetGraph
removeGraph
in interface DatasetGraph
public void add(Quad quad)
DatasetGraph
add
in interface DatasetGraph
public void delete(Quad quad)
DatasetGraph
delete
in interface DatasetGraph
public void add(Node g, Node s, Node p, Node o)
DatasetGraph
add
in interface DatasetGraph
public void delete(Node g, Node s, Node p, Node o)
DatasetGraph
delete
in interface DatasetGraph
public void deleteAny(Node g, Node s, Node p, Node o)
DatasetGraph
deleteAny
in interface DatasetGraph
public void clear()
DatasetGraph
clear
in interface DatasetGraph
public Iterator<Quad> find()
DatasetGraph
find
in interface DatasetGraph
public Iterator<Quad> find(Quad q)
DatasetGraph
find
in interface DatasetGraph
Graph.find(Triple)
public Iterator<Quad> find(Node g, Node s, Node p, Node o)
DatasetGraph
find
in interface DatasetGraph
Graph.find(Node,Node,Node)
public Iterator<Quad> findNG(Node g, Node s, Node p, Node o)
DatasetGraph
findNG
in interface DatasetGraph
Graph.find(Node,Node,Node)
public Graph getUnionGraph()
DatasetGraph
Graph
that is the union of all named graphs in this dataset. This
union graph is read-only (its prefix mapping in the current JVM may be changed but
that may not persist).getUnionGraph
in interface DatasetGraph
public boolean contains(Quad q)
DatasetGraph
contains
in interface DatasetGraph
public Lock getLock()
DatasetGraph
getLock
in interface DatasetGraph
Lock
public Context getContext()
DatasetGraph
getContext
in interface DatasetGraph
public DatasetGraph setContext(Context c)
public void close()
DatasetGraph
close
in interface org.apache.jena.atlas.lib.Closeable
close
in interface DatasetGraph
public boolean supportsTransactions()
DatasetGraph
DatasetGraph
supports transactions if it provides Transactional.begin()
/
Transactional.commit()
/Transactional.end()
. The core storage DatasetGraph
s
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.
supportsTransactions
in interface DatasetGraph
public boolean supportsTransactionAbort()
DatasetGraph
Transactional.abort()
is supported.
This goes along with clearing up after exceptions inside application transaction code.supportsTransactionAbort
in interface DatasetGraph
public long size()
DatasetGraph
size
in interface DatasetGraph
public boolean isEmpty()
DatasetGraph
isEmpty
in interface DatasetGraph
Licenced under the Apache License, Version 2.0