Module org.apache.jena.rdfconnection

Package org.apache.jena.rdflink

Class RDFLinkAdapter

java.lang.Object

org.apache.jena.rdflink.RDFLinkAdapter

All Implemented Interfaces:

java.lang.AutoCloseable, LinkDatasetGraph, LinkDatasetGraphAccess, LinkSparqlQuery, LinkSparqlUpdate, RDFLink, Transactional

public class RDFLinkAdapter
extends java.lang.Object
implements RDFLink

Nested Class Summary

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

Transactional.Promote

Constructor Summary

Constructors

Constructor	Description
RDFLinkAdapter(RDFConnection conn)

Method Summary

Modifier and Type	Method	Description
void	abort()
static RDFLink	adapt(RDFConnection conn)
void	begin(ReadWrite readWrite)
void	begin(TxnType type)
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(java.lang.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, java.lang.String file)	Load (add, append) RDF into a named graph in a dataset.
void	load(Node graphName, Graph graph)	Load (add, append) RDF into a named graph in a dataset.
void	loadDataset(java.lang.String file)
void	loadDataset(DatasetGraph dataset)
QueryExecBuilder	newQuery()	Return a QueryExecBuilder that is initially configured for this link setup and type.
boolean	promote(Transactional.Promote mode)
void	put(java.lang.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, java.lang.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(java.lang.String file)
void	putDataset(DatasetGraph dataset)
QueryExec	query(java.lang.String queryString)	Setup a SPARQL query execution.
QueryExec	query(Query query)	Setup a SPARQL query execution.
ReadWrite	transactionMode()
TxnType	transactionType()
void	update(java.lang.String update)	Execute a SPARQL Update.
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, queryAsk, queryAsk, queryConstruct, queryConstruct, queryConstructDataset, queryConstructDataset, queryDescribe, queryDescribe, queryRowSet, queryRowSet, querySelect, querySelect, update

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

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

Constructor Detail

RDFLinkAdapter

public RDFLinkAdapter(RDFConnection conn)

Method Detail

adapt

public static RDFLink adapt(RDFConnection conn)

begin

public void begin(TxnType type)

Specified by:

begin in interface Transactional

begin

public void begin(ReadWrite readWrite)

Specified by:

begin in interface Transactional

promote

public boolean promote(Transactional.Promote mode)

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

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

isInTransaction

public boolean isInTransaction()

Specified by:

isInTransaction in interface Transactional

getDataset

public DatasetGraph getDataset()

Description copied from interface: LinkDatasetGraphAccess

Fetch the contents of the dataset

Specified by:

getDataset in interface LinkDatasetGraphAccess

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

query

public QueryExec query(java.lang.String queryString)

Description copied from interface: RDFLink

Setup a SPARQL query execution.

This is a low-level operation. Handling the QueryExecution should be done with try-resource. Some QueryExecutions, such as ones connecting to a remote server, need to be properly closed to release system resources.

See also RDFLink.querySelect(String, Consumer), RDFLink.queryConstruct(String), RDFLink.queryDescribe(String), RDFLink.queryAsk(String) for ways to execute queries 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

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

update

public void update(java.lang.String update)

Description copied from interface: RDFLink

Execute a SPARQL Update.

Specified by:

update in interface LinkSparqlUpdate

Specified by:

update in interface RDFLink

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

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

load

public void load(java.lang.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,
                 java.lang.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(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.

load

public void load(Node graphName,
                 Graph graph)

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)

graph - Data.

put

public void put(java.lang.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,
                java.lang.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

loadDataset

public void loadDataset(java.lang.String file)

Specified by:

loadDataset in interface LinkDatasetGraph

Specified by:

loadDataset in interface RDFLink

loadDataset

public void loadDataset(DatasetGraph dataset)

Specified by:

loadDataset in interface LinkDatasetGraph

Specified by:

loadDataset in interface RDFLink

putDataset

public void putDataset(java.lang.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

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

close

public void close()

Description copied from interface: RDFLink

Close this connection. Use with try-resource.

Specified by:

close in interface java.lang.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