Package org.apache.jena.sparql.core
Interface DatasetGraph
-
- All Superinterfaces:
org.apache.jena.atlas.lib.Closeable,Transactional
- All Known Subinterfaces:
DatasetGraphWrapperView
- All Known Implementing Classes:
DatasetGraphBase,DatasetGraphBaseFind,DatasetGraphCollection,DatasetGraphFilteredView,DatasetGraphInMemory,DatasetGraphMap,DatasetGraphMapLink,DatasetGraphMonitor,DatasetGraphNull,DatasetGraphOne,DatasetGraphQuads,DatasetGraphRDFS,DatasetGraphReadOnly,DatasetGraphSink,DatasetGraphTriplesQuads,DatasetGraphViewGraphs,DatasetGraphWrapper,DatasetGraphZero,DifferenceDatasetGraph,DyadicDatasetGraph,DynamicDatasets.DynamicDatasetGraph,IntersectionDatasetGraph,UnionDatasetGraph
public interface DatasetGraph extends Transactional, org.apache.jena.atlas.lib.Closeable
DatasetGraph: The graph representation of an RDF Dataset. SeeDatasetfor the Model level of an RDF dataset.Whether a dataset contains a graph if there are no triples is not defined; see the specific implementation.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.apache.jena.sparql.core.Transactional
Transactional.Promote
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description voidadd(Node g, Node s, Node p, Node o)Add a quadvoidadd(Quad quad)Add a quaddefault voidaddAll(DatasetGraph src)Add thesrcDatasetGraph to this one.voidaddGraph(Node graphName, Graph graph)Add the given graph to the dataset.voidclear()Remove everything - remove all named graphs, clear the default graphvoidclose()Close the datasetbooleancontains(Node g, Node s, Node p, Node o)Test whether the dataset (including default graph) contains a quad - may include wildcards, Node.ANY or nullbooleancontains(Quad quad)Test whether the dataset contains a quad (including default graph)- may include wildcards, Node.ANY or nullbooleancontainsGraph(Node graphNode)Does the DatasetGraph contain a specific named graph? Whether a dataset contains a graph if there are no triples is not defined - see the specific implementation.voiddelete(Node g, Node s, Node p, Node o)Delete a quadvoiddelete(Quad quad)Delete a quadvoiddeleteAny(Node g, Node s, Node p, Node o)Delete any quads matching the patternjava.util.Iterator<Quad>find()Iterate over all quads in the dataset graphjava.util.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 nulljava.util.Iterator<Quad>find(Quad quad)Find matching quads in the dataset - may include wildcards, Node.ANY or nulljava.util.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 nullContextgetContext()Get the context associated with this object - may be nullGraphgetDefaultGraph()Get the default graph as a Jena GraphGraphgetGraph(Node graphNode)Get the graph named by graphNode : returns null when there is no such graph.LockgetLock()Return a lock for the dataset to help with concurrency controlGraphgetUnionGraph()Return aGraphthat is the union of all named graphs in this dataset.booleanisEmpty()Test whether the dataset is emptyjava.util.Iterator<Node>listGraphNodes()Iterate over all names of named graphsPrefixMapprefixes()Prefixes for this DatasetGraphvoidremoveGraph(Node graphName)Remove all data associated with the named graph.voidsetDefaultGraph(Graph g)Set the default graph.longsize()Get the size (number of named graphs) - may be -1 for unknowndefault booleansupportsTransactionAbort()Declare whetherTransactional.abort()is supported.booleansupportsTransactions()ADatasetGraphsupports transactions if it providesTransactional.begin()/Transactional.commit()/Transactional.end().-
Methods inherited from interface org.apache.jena.sparql.core.Transactional
abort, begin, begin, begin, calc, calculate, calculateRead, calculateWrite, commit, end, exec, execute, executeRead, executeWrite, isInTransaction, promote, promote, transactionMode, transactionType
-
-
-
-
Method Detail
-
getDefaultGraph
Graph getDefaultGraph()
Get the default graph as a Jena Graph
-
getGraph
Graph getGraph(Node graphNode)
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.
-
getUnionGraph
Graph getUnionGraph()
Return aGraphthat 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).
-
containsGraph
boolean containsGraph(Node graphNode)
Does the DatasetGraph contain a specific named graph? 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 and this returns true always.- Parameters:
graphNode-- Returns:
- boolean
-
setDefaultGraph
void setDefaultGraph(Graph g)
Set the default graph. Set the active graph if it was null. This replaces the contents default graph, not merge data into it. Do not assume that the same object is returned bygetDefaultGraph()
-
addGraph
void addGraph(Node graphName, Graph graph)
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 bygetGraph(org.apache.jena.graph.Node)
-
removeGraph
void removeGraph(Node graphName)
Remove all data associated with the named graph. This will include prefixes associated with the graph.
-
listGraphNodes
java.util.Iterator<Node> listGraphNodes()
Iterate over all names of named graphs
-
add
void add(Quad quad)
Add a quad
-
delete
void delete(Quad quad)
Delete a quad
-
addAll
default void addAll(DatasetGraph src)
Add thesrcDatasetGraph to this one.
-
find
java.util.Iterator<Quad> find()
Iterate over all quads in the dataset graph
-
find
java.util.Iterator<Quad> find(Quad quad)
Find matching quads in the dataset - may include wildcards, Node.ANY or null- See Also:
Graph.find(Triple)
-
find
java.util.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- See Also:
Graph.find(Node,Node,Node)
-
findNG
java.util.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- See Also:
Graph.find(Node,Node,Node)
-
contains
boolean contains(Node g, Node s, Node p, Node o)
Test whether the dataset (including default graph) contains a quad - may include wildcards, Node.ANY or null
-
contains
boolean contains(Quad quad)
Test whether the dataset contains a quad (including default graph)- may include wildcards, Node.ANY or null
-
clear
void clear()
Remove everything - remove all named graphs, clear the default graph
-
isEmpty
boolean isEmpty()
Test whether the dataset is empty
-
getLock
Lock getLock()
Return a lock for the dataset to help with concurrency control- See Also:
Lock
-
getContext
Context getContext()
Get the context associated with this object - may be null
-
size
long size()
Get the size (number of named graphs) - may be -1 for unknown
-
close
void close()
Close the dataset- Specified by:
closein interfaceorg.apache.jena.atlas.lib.Closeable
-
prefixes
PrefixMap prefixes()
Prefixes for this DatasetGraph
-
supportsTransactions
boolean supportsTransactions()
ADatasetGraphsupports transactions if it providesTransactional.begin()/Transactional.commit()/Transactional.end(). The core storageDatasetGraphs provide fully serialized transactions. ADatasetGraphthat 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 provideTransactional.abort().See
supportsTransactionAbort()forTransactional.abort(). In addition, check details of a specific implementation.
-
supportsTransactionAbort
default boolean supportsTransactionAbort()
Declare whetherTransactional.abort()is supported. This goes along with clearing up after exceptions inside application transaction code.
-
-