Package org.apache.jena.rdfconnection

Class RDFConnectionRemote

java.lang.Object

org.apache.jena.rdfconnection.RDFConnectionRemote

All Implemented Interfaces:

java.lang.AutoCloseable, RDFConnection, RDFDatasetAccessConnection, RDFDatasetConnection, SparqlQueryConnection, SparqlUpdateConnection, Transactional

Direct Known Subclasses:

RDFConnectionFuseki

public class RDFConnectionRemote
extends java.lang.Object
implements RDFConnection

Implementation of the RDFConnection interface using remote SPARQL operations.

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	close()	Close this connection.
void	commit()
static RDFConnectionRemoteBuilder	create()	Create a RDFConnectionRemoteBuilder.
static RDFConnectionRemoteBuilder	create(RDFConnectionRemote base)	Create a RDFConnectionRemoteBuilder initialized with the settings of another RDFConnectionRemote.
void	delete()	Remove all data from the default graph.
void	delete(java.lang.String graph)	Delete a graph from the dataset.
void	end()
Model	fetch()	Fetch the default graph.
Model	fetch(java.lang.String graphName)	Fetch a named graph.
Dataset	fetchDataset()	Fetch the contents of the dataset
java.lang.String	getDestination()	Return the destination URL for the connection.
org.apache.http.client.HttpClient	getHttpClient()	Return the HttpClient in-use.
org.apache.http.protocol.HttpContext	getHttpContext()	Return the HttpContext in-use.
boolean	isClosed()	Test whether this connection is closed or not
boolean	isInTransaction()
void	load(java.lang.String file)	Load (add, append) RDF into the default graph of a dataset.
void	load(java.lang.String graph, java.lang.String file)	Load (add, append) RDF into a named graph in a dataset.
void	load(java.lang.String graphName, Model model)	Load (add, append) RDF into a named graph in a dataset.
void	load(Model model)	Load (add, append) RDF into the default graph of a dataset.
void	loadDataset(java.lang.String file)
void	loadDataset(Dataset dataset)
boolean	promote(Transactional.Promote promote)
void	put(java.lang.String file)	Set the contents of the default graph of a dataset.
void	put(java.lang.String graph, java.lang.String file)	Set the contents of a named graph of a dataset.
void	put(java.lang.String graphName, Model model)	Set the contents of a named graph of a dataset.
void	put(Model model)	Set the contents of the default graph of a dataset.
void	putDataset(java.lang.String file)
void	putDataset(Dataset dataset)
QueryExecution	query(java.lang.String queryString)	Setup a SPARQL query execution.
QueryExecution	query(Query query)	Setup a SPARQL query execution.
boolean	queryAsk(java.lang.String queryString)	Execute a ASK query and return a boolean
Model	queryConstruct(java.lang.String queryString)	Execute a CONSTRUCT query and return as a Model
Model	queryDescribe(java.lang.String queryString)	Execute a DESCRIBE query and return as a Model
void	queryResultSet(java.lang.String queryString, java.util.function.Consumer<ResultSet> resultSetAction)	Execute a SELECT query and process the ResultSet with the handler code.
void	querySelect(java.lang.String queryString, java.util.function.Consumer<QuerySolution> rowAction)	Execute a SELECT query and process the rows of the results with the handler code.
ReadWrite	transactionMode()
TxnType	transactionType()
void	update(java.lang.String updateString)	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.rdfconnection.RDFConnection

queryAsk, queryConstruct, queryDescribe, queryResultSet, querySelect, update

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

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

Method Detail

create

public static RDFConnectionRemoteBuilder create()

Create a RDFConnectionRemoteBuilder.

create

public static RDFConnectionRemoteBuilder create(RDFConnectionRemote base)

Create a RDFConnectionRemoteBuilder initialized with the settings of another RDFConnectionRemote.

getHttpClient

public org.apache.http.client.HttpClient getHttpClient()

Return the HttpClient in-use.

getHttpContext

public org.apache.http.protocol.HttpContext getHttpContext()

Return the HttpContext in-use.

getDestination

public java.lang.String getDestination()

Return the destination URL for the connection.

queryResultSet

public void queryResultSet(java.lang.String queryString,
                           java.util.function.Consumer<ResultSet> resultSetAction)

Execute a SELECT query and process the ResultSet with the handler code.

Specified by:

queryResultSet in interface RDFConnection

Specified by:

queryResultSet in interface SparqlQueryConnection

Parameters:

queryString -

resultSetAction -

querySelect

public void querySelect(java.lang.String queryString,
                        java.util.function.Consumer<QuerySolution> rowAction)

Execute a SELECT query and process the rows of the results with the handler code.

Specified by:

querySelect in interface RDFConnection

Specified by:

querySelect in interface SparqlQueryConnection

Parameters:

queryString -

rowAction -

queryConstruct

public Model queryConstruct(java.lang.String queryString)

Execute a CONSTRUCT query and return as a Model

Specified by:

queryConstruct in interface RDFConnection

Specified by:

queryConstruct in interface SparqlQueryConnection

queryDescribe

public Model queryDescribe(java.lang.String queryString)

Execute a DESCRIBE query and return as a Model

Specified by:

queryDescribe in interface RDFConnection

Specified by:

queryDescribe in interface SparqlQueryConnection

queryAsk

public boolean queryAsk(java.lang.String queryString)

Execute a ASK query and return a boolean

Specified by:

queryAsk in interface RDFConnection

Specified by:

queryAsk in interface SparqlQueryConnection

query

public QueryExecution query(java.lang.String queryString)

Description copied from interface: RDFConnection

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 RDFConnection.querySelect(String, Consumer), RDFConnection.queryConstruct(String), RDFConnection.queryDescribe(String), RDFConnection.queryAsk(String) for ways to execute queries of a specific form.

Specified by:

query in interface RDFConnection

Specified by:

query in interface SparqlQueryConnection

Returns:

QueryExecution

query

public QueryExecution query(Query query)

Description copied from interface: RDFConnection

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

Specified by:

query in interface RDFConnection

Specified by:

query in interface SparqlQueryConnection

Returns:

QueryExecution

update

public void update(java.lang.String updateString)

Description copied from interface: RDFConnection

Execute a SPARQL Update.

Specified by:

update in interface RDFConnection

Specified by:

update in interface SparqlUpdateConnection

update

public void update(UpdateRequest update)

Description copied from interface: RDFConnection

Execute a SPARQL Update.

Specified by:

update in interface RDFConnection

Specified by:

update in interface SparqlUpdateConnection

fetch

public Model fetch(java.lang.String graphName)

Description copied from interface: RDFConnection

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

Specified by:

fetch in interface RDFConnection

Specified by:

fetch in interface RDFDatasetAccessConnection

Parameters:

graphName - URI string for the graph name (null or "default" for the default graph)

Returns:

Model

fetch

public Model fetch()

Description copied from interface: RDFConnection

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

Specified by:

fetch in interface RDFConnection

Specified by:

fetch in interface RDFDatasetAccessConnection

Returns:

Model

load

public void load(java.lang.String graph,
                 java.lang.String file)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

load in interface RDFDatasetConnection

Parameters:

graph - Graph name (null or "default" for the default graph)

file - File of the data.

load

public void load(java.lang.String file)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

load in interface RDFDatasetConnection

Parameters:

file - File of the data.

load

public void load(Model model)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

load in interface RDFDatasetConnection

Parameters:

model - Data.

load

public void load(java.lang.String graphName,
                 Model model)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

load in interface RDFDatasetConnection

Parameters:

graphName - Graph name (null or "default" for the default graph)

model - Data.

put

public void put(java.lang.String graph,
                java.lang.String file)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

put in interface RDFDatasetConnection

Parameters:

graph - Graph name (null or "default" for the default graph)

file - File of the data.

put

public void put(java.lang.String file)

Description copied from interface: RDFConnection

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.

Specified by:

put in interface RDFConnection

Specified by:

put in interface RDFDatasetConnection

Parameters:

file - File of the data.

put

public void put(java.lang.String graphName,
                Model model)

Description copied from interface: RDFConnection

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 RDFConnection

Specified by:

put in interface RDFDatasetConnection

Parameters:

graphName - Graph name (null or "default" for the default graph)

model - Data.

put

public void put(Model model)

Description copied from interface: RDFConnection

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.

Specified by:

put in interface RDFConnection

Specified by:

put in interface RDFDatasetConnection

Parameters:

model - Data.

delete

public void delete(java.lang.String graph)

Description copied from interface: RDFConnection

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

Specified by:

delete in interface RDFConnection

Specified by:

delete in interface RDFDatasetConnection

delete

public void delete()

Description copied from interface: RDFConnection

Remove all data from the default graph.

Specified by:

delete in interface RDFConnection

Specified by:

delete in interface RDFDatasetConnection

fetchDataset

public Dataset fetchDataset()

Description copied from interface: RDFConnection

Fetch the contents of the dataset

Specified by:

fetchDataset in interface RDFConnection

Specified by:

fetchDataset in interface RDFDatasetAccessConnection

loadDataset

public void loadDataset(java.lang.String file)

Specified by:

loadDataset in interface RDFConnection

Specified by:

loadDataset in interface RDFDatasetConnection

loadDataset

public void loadDataset(Dataset dataset)

Specified by:

loadDataset in interface RDFConnection

Specified by:

loadDataset in interface RDFDatasetConnection

putDataset

public void putDataset(java.lang.String file)

Specified by:

putDataset in interface RDFConnection

Specified by:

putDataset in interface RDFDatasetConnection

putDataset

public void putDataset(Dataset dataset)

Specified by:

putDataset in interface RDFConnection

Specified by:

putDataset in interface RDFDatasetConnection

close

public void close()

Description copied from interface: RDFConnection

Close this connection. Use with try-resource.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface RDFConnection

Specified by:

close in interface RDFDatasetAccessConnection

Specified by:

close in interface RDFDatasetConnection

Specified by:

close in interface SparqlQueryConnection

Specified by:

close in interface SparqlUpdateConnection

isClosed

public boolean isClosed()

Description copied from interface: RDFConnection

Test whether this connection is closed or not

Specified by:

isClosed in interface RDFConnection

Specified by:

isClosed in interface RDFDatasetAccessConnection

Specified by:

isClosed in interface RDFDatasetConnection

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