Module org.apache.jena.rdfconnection

Package org.apache.jena.rdflink

Class RDFLinkDataset

java.lang.Object

org.apache.jena.rdflink.RDFLinkDataset

All Implemented Interfaces:

AutoCloseable, LinkDatasetGraph, LinkDatasetGraphAccess, LinkSparqlQuery, LinkSparqlUpdate, RDFLink, Transactional

public class RDFLinkDataset
extends Object
implements RDFLink

Implement of RDFLink over a Graph in the same JVM.

Multiple levels of Isolation are provided. The default COPY level makes a local RDFLink that behaves like a remote connection. This should be the normal use in testing.

• COPY – Graphs and Datasets are copied. This is most like a remote connection.
• READONLY – Read-only wrappers are added but changes to the underlying graph or dataset will be seen.
• NONE (default) – Changes to the returned Graphs or Datasets act on the original object.

Nested Class Summary

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

Transactional.Promote

Method Summary

Modifier and Type	Method	Description
void	abort()
void	begin()
void	begin(ReadWrite mode)
void	begin(TxnType txnType)
void	clearDataset()	Clear the dataset - remove all named graphs, clear the default graph.
void	close()	Close this connection.
void	commit()
void	delete()	Remove all data from the default graph.
void	delete(Node graphName)	Delete a graph from the dataset.
void	end()
Graph	get()	Fetch the default graph.
Graph	get(Node graphName)	Fetch a named graph.
DatasetGraph	getDataset()	Fetch the contents of the dataset
boolean	isClosed()	Test whether this connection is closed or not
boolean	isInTransaction()
void	load(String file)	Send file - this merges the file RDF into the default graph of a dataset.
void	load(Graph graph)	Load (add, append) RDF into the default graph of a dataset.
void	load(Node graphName, String file)	Load (add, append) RDF into a named graph in a dataset.
void	load(Node graphName, Graph graphSrc)	Load (add, append) RDF into a named graph in a dataset.
void	loadDataset(String file)
void	loadDataset(DatasetGraph srcDataset)
QueryExecBuilder	newQuery()	Return a QueryExecBuilder that is initially configured for this link setup and type.
UpdateExecBuilder	newUpdate()	Return a UpdateExecBuilder that is initially configured for this link setup and type.
boolean	promote(Transactional.Promote promote)
void	put(String file)	Set the contents of the default graph of a dataset.
void	put(Graph graph)	Set the contents of the default graph of a dataset.
void	put(Node graphName, String file)	Set the contents of a named graph of a dataset.
void	put(Node graphName, Graph graph)	Set the contents of a named graph of a dataset.
void	putDataset(String file)
void	putDataset(DatasetGraph dataset)
QueryExec	query(Query query)	Setup a SPARQL query execution.
ReadWrite	transactionMode()
TxnType	transactionType()
void	update(UpdateRequest update)	Execute a SPARQL Update.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jena.rdflink.RDFLink

isRemote, query, queryAsk, queryAsk, queryConstruct, queryConstruct, queryConstructDataset, queryConstructDataset, queryDescribe, queryDescribe, queryRowSet, queryRowSet, querySelect, querySelect, update, update

Methods inherited from interface org.apache.jena.sparql.core.Transactional

calc, calculate, calculateRead, calculateWrite, exec, execute, executeRead, executeWrite, promote

Method Details

query

public QueryExec query(Query query)

Description copied from interface: RDFLink

Setup a SPARQL query execution. See also RDFLink.querySelect(Query, Consumer), RDFLink.queryConstruct(Query), RDFLink.queryDescribe(Query), RDFLink.queryAsk(Query) for ways to execute queries for of a specific form.

Specified by:

query in interface LinkSparqlQuery

Specified by:

query in interface RDFLink

Returns:

QueryExecution

newQuery

public QueryExecBuilder newQuery()

Description copied from interface: RDFLink

Return a QueryExecBuilder that is initially configured for this link setup and type. The query built will be set to go to the same dataset/remote endpoint as the other RDFLink operations.

Specified by:

newQuery in interface LinkSparqlQuery

Specified by:

newQuery in interface RDFLink

Returns:

QueryExecBuilder

newUpdate

public UpdateExecBuilder newUpdate()

Return a UpdateExecBuilder that is initially configured for this link setup and type. The update built will be set to go to the same dataset/remote endpoint as the other RDFLink operations.

Specified by:

newUpdate in interface LinkSparqlUpdate

Specified by:

newUpdate in interface RDFLink

Returns:

UpdateExecBuilder

update

public void update(UpdateRequest update)

Description copied from interface: RDFLink

Execute a SPARQL Update.

Specified by:

update in interface LinkSparqlUpdate

Specified by:

update in interface RDFLink

load

public void load(Node graphName,
 String file)

Description copied from interface: RDFLink

Load (add, append) RDF into a named graph in a dataset. This is SPARQL Graph Store Protocol HTTP POST or equivalent.

If this is a remote connection:

• The file is sent as-is and not parsed in the RDFLink
• The Content-Type is determined by the filename

Specified by:

load in interface LinkDatasetGraph

Specified by:

load in interface RDFLink

Parameters:

graphName - Graph name (null or Quad.defaultGraphIRI for the default graph)

file - File of the data.

load

public void load(String file)

Description copied from interface: RDFLink

Send file - this merges the file RDF into the default graph of a dataset. This is SPARQL Graph Store Protocol HTTP POST or equivalent.

If this is a remote connection:

• The file is sent as-is and not parsed in the RDFLink
• The Content-Type is determined by the filename

Specified by:

load in interface LinkDatasetGraph

Specified by:

load in interface RDFLink

Parameters:

file - File of the data.

load

public void load(Node graphName,
 Graph graphSrc)

Description copied from interface: RDFLink

Load (add, append) RDF into a named graph in a dataset. This is SPARQL Graph Store Protocol HTTP POST or equivalent.

Specified by:

load in interface LinkDatasetGraph

Specified by:

load in interface RDFLink

Parameters:

graphName - Graph name (null or Quad.defaultGraphIRI for the default graph)

graphSrc - Data.

load

public void load(Graph graph)

Description copied from interface: RDFLink

Load (add, append) RDF into the default graph of a dataset. This is SPARQL Graph Store Protocol HTTP POST or equivalent.

Specified by:

load in interface LinkDatasetGraph

Specified by:

load in interface RDFLink

Parameters:

graph - Data.

get

public Graph get(Node graphName)

Description copied from interface: RDFLink

Fetch a named graph. This is SPARQL Graph Store Protocol HTTP GET or equivalent.

Specified by:

get in interface LinkDatasetGraphAccess

Specified by:

get in interface RDFLink

Parameters:

graphName - URI string for the graph name (null or Quad.defaultGraphIRI for the default graph)

Returns:

Graph

get

public Graph get()

Description copied from interface: RDFLink

Fetch the default graph. This is SPARQL Graph Store Protocol HTTP GET or equivalent.

Specified by:

get in interface LinkDatasetGraphAccess

Specified by:

get in interface RDFLink

Returns:

Graph

put

public void put(String file)

Description copied from interface: RDFLink

Set the contents of the default graph of a dataset. Any existing data is lost. This is SPARQL Graph Store Protocol HTTP PUT or equivalent.

If this is a remote connection:

• The file is sent as-is and not parsed in the RDFLink
• The Content-Type is determined by the filename

Specified by:

put in interface LinkDatasetGraph

Specified by:

put in interface RDFLink

Parameters:

file - File of the data.

put

public void put(Node graphName,
 String file)

Description copied from interface: RDFLink

Set the contents of a named graph of a dataset. Any existing data is lost. This is SPARQL Graph Store Protocol HTTP PUT or equivalent.

Specified by:

put in interface LinkDatasetGraph

Specified by:

put in interface RDFLink

Parameters:

graphName - Graph name (null or Quad.defaultGraphIRI for the default graph)

file - File of the data.

put

public void put(Graph graph)

Description copied from interface: RDFLink

Set the contents of the default graph of a dataset. Any existing data is lost. This is SPARQL Graph Store Protocol HTTP PUT or equivalent.

If this is a remote connection:

• The file is sent as-is and not parsed in the RDFLink
• The Content-Type is determined by the filename

Specified by:

put in interface LinkDatasetGraph

Specified by:

put in interface RDFLink

Parameters:

graph - Data.

put

public void put(Node graphName,
 Graph graph)

Description copied from interface: RDFLink

Set the contents of a named graph of a dataset. Any existing data is lost. This is SPARQL Graph Store Protocol HTTP PUT or equivalent.

Specified by:

put in interface LinkDatasetGraph

Specified by:

put in interface RDFLink

Parameters:

graphName - Graph name (null or Quad.defaultGraphIRI for the default graph)

graph - Data.

delete

public void delete(Node graphName)

Description copied from interface: RDFLink

Delete a graph from the dataset. Null or Quad.defaultGraphIRI means the default graph, which is cleared, not removed.

Specified by:

delete in interface LinkDatasetGraph

Specified by:

delete in interface RDFLink

delete

public void delete()

Description copied from interface: RDFLink

Remove all data from the default graph.

Specified by:

delete in interface LinkDatasetGraph

Specified by:

delete in interface RDFLink

getDataset

public DatasetGraph getDataset()

Description copied from interface: LinkDatasetGraphAccess

Fetch the contents of the dataset

Specified by:

getDataset in interface LinkDatasetGraphAccess

loadDataset

public void loadDataset(String file)

Specified by:

loadDataset in interface LinkDatasetGraph

Specified by:

loadDataset in interface RDFLink

loadDataset

public void loadDataset(DatasetGraph srcDataset)

Specified by:

loadDataset in interface LinkDatasetGraph

Specified by:

loadDataset in interface RDFLink

putDataset

public void putDataset(String file)

Specified by:

putDataset in interface LinkDatasetGraph

Specified by:

putDataset in interface RDFLink

putDataset

public void putDataset(DatasetGraph dataset)

Specified by:

putDataset in interface LinkDatasetGraph

Specified by:

putDataset in interface RDFLink

clearDataset

public void clearDataset()

Description copied from interface: RDFLink

Clear the dataset - remove all named graphs, clear the default graph.

Specified by:

clearDataset in interface LinkDatasetGraph

Specified by:

clearDataset in interface RDFLink

close

public void close()

Description copied from interface: RDFLink

Close this connection. Use with try-resource.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface LinkDatasetGraph

Specified by:

close in interface LinkDatasetGraphAccess

Specified by:

close in interface LinkSparqlQuery

Specified by:

close in interface LinkSparqlUpdate

Specified by:

close in interface RDFLink

isClosed

public boolean isClosed()

Description copied from interface: RDFLink

Test whether this connection is closed or not

Specified by:

isClosed in interface LinkDatasetGraph

Specified by:

isClosed in interface LinkDatasetGraphAccess

Specified by:

isClosed in interface RDFLink

begin

public void begin()

Specified by:

begin in interface Transactional

begin

public void begin(TxnType txnType)

Specified by:

begin in interface Transactional

begin

public void begin(ReadWrite mode)

Specified by:

begin in interface Transactional

promote

public boolean promote(Transactional.Promote promote)

Specified by:

promote in interface Transactional

commit

public void commit()

Specified by:

commit in interface Transactional

abort

public void abort()

Specified by:

abort in interface Transactional

isInTransaction

public boolean isInTransaction()

Specified by:

isInTransaction in interface Transactional

end

public void end()

Specified by:

end in interface Transactional

transactionMode

public ReadWrite transactionMode()

Specified by:

transactionMode in interface Transactional

transactionType

public TxnType transactionType()

Specified by:

transactionType in interface Transactional