Package org.apache.jena.rdfconnection

Interface RDFConnection

All Superinterfaces:

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

All Known Implementing Classes:

RDFConnectionFuseki, RDFConnectionLocal, RDFConnectionModular, RDFConnectionRemote, RDFConnectionWrapper

public interface RDFConnection
extends SparqlQueryConnection, SparqlUpdateConnection, RDFDatasetConnection, Transactional, java.lang.AutoCloseable

Interface for SPARQL operations on a datasets, whether local or remote. Operations can performed via this interface or via the various interfaces for a subset of the operations.

• query (SparqlQueryConnection)
• update (SparqlUpdateConnection)
• graph store protocol (RDFDatasetConnection).

For remote operations, the SPARQL Protocol is used for query and updates and SPARQL Graph Store Protocol for the graph operations and in addition, there are analogous operations on datasets (fetch, load, put; but not delete). RDFConnection provides transaction boundaries. If not in a transaction, an implicit transactional wrapper is applied ("autocommit"). Remote SPARQL operations are atomic but without additional capabilities from the remote server, multiple operations are not combined into a single transaction. Not all implementations may implement all operations. See the implementation notes for details.

See Also:

RDFConnectionFactory, RDFConnectionLocal, RDFConnectionRemote, SparqlQueryConnection, SparqlUpdateConnection, RDFDatasetConnection

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	close()	Close this connection.
void	delete()	Remove all data from the default graph.
void	delete(java.lang.String graphName)	Delete a graph from the dataset.
Model	fetch()	Fetch the default graph.
Model	fetch(java.lang.String graphName)	Fetch a named graph.
Dataset	fetchDataset()	Fetch the contents of the dataset
boolean	isClosed()	Test whether this connection is closed or not
void	load(java.lang.String file)	Load (add, append) RDF into the default graph of a dataset.
void	load(java.lang.String graphName, 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)
void	put(java.lang.String file)	Set the contents of the default graph of a dataset.
void	put(java.lang.String graphName, 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)
default QueryExecution	query(java.lang.String queryString)	Setup a SPARQL query execution.
QueryExecution	query(Query query)	Setup a SPARQL query execution.
default boolean	queryAsk(java.lang.String queryString)	Execute a ASK query and return a boolean
default boolean	queryAsk(Query query)	Execute a ASK query and return a boolean
default Model	queryConstruct(java.lang.String queryString)	Execute a CONSTRUCT query and return as a Model
default Model	queryConstruct(Query query)	Execute a CONSTRUCT query and return as a Model
default Model	queryDescribe(java.lang.String queryString)	Execute a DESCRIBE query and return as a Model
default Model	queryDescribe(Query query)	Execute a DESCRIBE query and return as a Model
default void	queryResultSet(java.lang.String queryString, java.util.function.Consumer<ResultSet> resultSetAction)	Execute a SELECT query and process the ResultSet with the handler code.
default void	queryResultSet(Query query, java.util.function.Consumer<ResultSet> resultSetAction)	Execute a SELECT query and process the ResultSet with the handler code.
default 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.
default void	querySelect(Query query, java.util.function.Consumer<QuerySolution> rowAction)	Execute a SELECT query and process the rows of the results with the handler code.
default void	update(java.lang.String updateString)	Execute a SPARQL Update.
default void	update(Update update)	Execute a SPARQL Update.
void	update(UpdateRequest update)	Execute a SPARQL Update.

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

queryResultSet

default 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 SparqlQueryConnection

Parameters:

queryString -

resultSetAction -

queryResultSet

default void queryResultSet(Query query,
                            java.util.function.Consumer<ResultSet> resultSetAction)

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

Specified by:

queryResultSet in interface SparqlQueryConnection

Parameters:

query -

resultSetAction -

querySelect

default 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 SparqlQueryConnection

Parameters:

queryString -

rowAction -

querySelect

default void querySelect(Query query,
                         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 SparqlQueryConnection

Parameters:

query -

rowAction -

queryConstruct

default Model queryConstruct(java.lang.String queryString)

Execute a CONSTRUCT query and return as a Model

Specified by:

queryConstruct in interface SparqlQueryConnection

queryConstruct

default Model queryConstruct(Query query)

Execute a CONSTRUCT query and return as a Model

Specified by:

queryConstruct in interface SparqlQueryConnection

queryDescribe

default Model queryDescribe(java.lang.String queryString)

Execute a DESCRIBE query and return as a Model

Specified by:

queryDescribe in interface SparqlQueryConnection

queryDescribe

default Model queryDescribe(Query query)

Execute a DESCRIBE query and return as a Model

Specified by:

queryDescribe in interface SparqlQueryConnection

queryAsk

default boolean queryAsk(java.lang.String queryString)

Execute a ASK query and return a boolean

Specified by:

queryAsk in interface SparqlQueryConnection

queryAsk

default boolean queryAsk(Query query)

Execute a ASK query and return a boolean

Specified by:

queryAsk in interface SparqlQueryConnection

query

QueryExecution query(Query query)

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

Specified by:

query in interface SparqlQueryConnection

Parameters:

query -

Returns:

QueryExecution

query

default QueryExecution query(java.lang.String queryString)

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

Specified by:

query in interface SparqlQueryConnection

Parameters:

queryString -

Returns:

QueryExecution

update

default void update(Update update)

Execute a SPARQL Update.

Specified by:

update in interface SparqlUpdateConnection

Parameters:

update -

update

void update(UpdateRequest update)

Execute a SPARQL Update.

Specified by:

update in interface SparqlUpdateConnection

Parameters:

update -

update

default void update(java.lang.String updateString)

Execute a SPARQL Update.

Specified by:

update in interface SparqlUpdateConnection

Parameters:

updateString -

fetch

Model fetch(java.lang.String graphName)

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

Specified by:

fetch in interface RDFDatasetAccessConnection

Parameters:

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

Returns:

Model

fetch

Model fetch()

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

Specified by:

fetch in interface RDFDatasetAccessConnection

Returns:

Model

fetchDataset

Dataset fetchDataset()

Fetch the contents of the dataset

Specified by:

fetchDataset in interface RDFDatasetAccessConnection

load

void load(java.lang.String graphName,
          java.lang.String file)

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 RDFDatasetConnection

Parameters:

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

file - File of the data.

load

void load(java.lang.String file)

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 RDFDatasetConnection

Parameters:

file - File of the data.

load

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

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 RDFDatasetConnection

Parameters:

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

model - Data.

load

void load(Model model)

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 RDFDatasetConnection

Parameters:

model - Data.

put

void put(java.lang.String graphName,
         java.lang.String file)

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 RDFDatasetConnection

Parameters:

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

file - File of the data.

put

void put(java.lang.String file)

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 RDFDatasetConnection

Parameters:

file - File of the data.

put

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

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 RDFDatasetConnection

Parameters:

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

model - Data.

put

void put(Model model)

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 RDFDatasetConnection

Parameters:

model - Data.

delete

void delete(java.lang.String graphName)

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

Specified by:

delete in interface RDFDatasetConnection

Parameters:

graphName -

delete

void delete()

Remove all data from the default graph.

Specified by:

delete in interface RDFDatasetConnection

loadDataset

void loadDataset(java.lang.String file)

Specified by:

loadDataset in interface RDFDatasetConnection

loadDataset

void loadDataset(Dataset dataset)

Specified by:

loadDataset in interface RDFDatasetConnection

putDataset

void putDataset(java.lang.String file)

Specified by:

putDataset in interface RDFDatasetConnection

putDataset

void putDataset(Dataset dataset)

Specified by:

putDataset in interface RDFDatasetConnection

isClosed

boolean isClosed()

Test whether this connection is closed or not

Specified by:

isClosed in interface RDFDatasetAccessConnection

Specified by:

isClosed in interface RDFDatasetConnection

close

void close()

Close this connection. Use with try-resource.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface RDFDatasetAccessConnection

Specified by:

close in interface RDFDatasetConnection

Specified by:

close in interface SparqlQueryConnection

Specified by:

close in interface SparqlUpdateConnection