RDFConnection (Apache Jena RDF Connection)

All Superinterfaces:

AutoCloseable, RDFDatasetAccessConnection, RDFDatasetConnection, SparqlQueryConnection, SparqlUpdateConnection, Transactional

All Known Implementing Classes:

RDFConnectionFuseki, RDFConnectionLocal, RDFConnectionModular, RDFConnectionRemote, RDFConnectionWrapper
```
public interface RDFConnection
extends SparqlQueryConnection, SparqlUpdateConnection, RDFDatasetConnection, Transactional, 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

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`close()` Close this connection.
`void`	`delete()` Remove all data from the default graph.
`void`	`delete(String graphName)` Delete a graph from the dataset.
`Model`	`fetch()` Fetch the default graph.
`Model`	`fetch(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(Model model)` Load (add, append) RDF into the default graph of a dataset.
`void`	`load(String file)` Load (add, append) RDF into the default graph of a dataset.
`void`	`load(String graphName, Model model)` Load (add, append) RDF into a named graph in a dataset.
`void`	`load(String graphName, String file)` Load (add, append) RDF into a named graph in a dataset.
`void`	`loadDataset(Dataset dataset)`
`void`	`loadDataset(String file)`
`void`	`put(Model model)` Set the contents of the default graph of a dataset.
`void`	`put(String file)` Set the contents of the default graph of a dataset.
`void`	`put(String graphName, Model model)` Set the contents of a named graph of a dataset.
`void`	`put(String graphName, String file)` Set the contents of a named graph of a dataset.
`void`	`putDataset(Dataset dataset)`
`void`	`putDataset(String file)`
`QueryExecution`	`query(Query query)` Setup a SPARQL query execution.
`default QueryExecution`	`query(String queryString)` Setup a SPARQL query execution.
`default boolean`	`queryAsk(Query query)` Execute a ASK query and return a boolean
`default boolean`	`queryAsk(String queryString)` Execute a ASK query and return a boolean
`default Model`	`queryConstruct(Query query)` Execute a CONSTRUCT query and return as a Model
`default Model`	`queryConstruct(String queryString)` Execute a CONSTRUCT query and return as a Model
`default Model`	`queryDescribe(Query query)` Execute a DESCRIBE query and return as a Model
`default Model`	`queryDescribe(String queryString)` Execute a DESCRIBE query and return as a Model
`default void`	`queryResultSet(Query query, Consumer<ResultSet> resultSetAction)` Execute a SELECT query and process the ResultSet with the handler code.
`default void`	`queryResultSet(String queryString, Consumer<ResultSet> resultSetAction)` Execute a SELECT query and process the ResultSet with the handler code.
`default void`	`querySelect(Query query, Consumer<QuerySolution> rowAction)` Execute a SELECT query and process the rows of the results with the handler code.
`default void`	`querySelect(String queryString, Consumer<QuerySolution> rowAction)` Execute a SELECT query and process the rows of the results with the handler code.
`default void`	`update(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, commit, end, isInTransaction, promote, promote, transactionMode, transactionType

- Method Detail
  - queryResultSet
```
default void queryResultSet(String queryString,
                            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,
                            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(String queryString,
                         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,
                         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(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(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(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(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(String updateString)
```
    Execute a SPARQL Update.
    
    Specified by:
    
    update in interface SparqlUpdateConnection
    
    Parameters:
    
    updateString -
  - fetch
```
Model fetch(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(String graphName,
          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(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(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(String graphName,
         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(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(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(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(String file)
```
    Specified by:
    
    loadDataset in interface RDFDatasetConnection
  - loadDataset
```
void loadDataset(Dataset dataset)
```
    Specified by:
    
    loadDataset in interface RDFDatasetConnection
  - putDataset
```
void putDataset(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 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

Interface RDFConnection

Nested Class Summary

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

Method Summary

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

Method Detail

queryResultSet

queryResultSet

querySelect

querySelect

queryConstruct

queryConstruct

queryDescribe

queryDescribe

queryAsk

queryAsk

query

query

update

update

update

fetch

fetch

fetchDataset

load

load

load

load

put

put

put

put

delete

delete

loadDataset

loadDataset

putDataset

putDataset

isClosed

close