java.lang.Object
org.apache.jena.rdflink.RDFLinkHTTP
- All Implemented Interfaces:
AutoCloseable
,LinkDatasetGraph
,LinkDatasetGraphAccess
,LinkSparqlQuery
,LinkSparqlUpdate
,RDFLink
,Transactional
- Direct Known Subclasses:
RDFLinkFuseki
Implementation of the
RDFLink
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 TypeMethodDescriptionvoid
abort()
void
begin()
void
void
void
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 a graph from the dataset.void
end()
static RDFLinkHTTPBuilder
from
(RDFLinkHTTP base) Create aRDFLinkHTTPBuilder
initialized with the settings of anotherRDFLinkRemote
.get()
Fetch the default graph.Fetch a named graph.Fetch the contents of the datasetReturn the destination URL for the connection.Return theHttpClient
in-use.boolean
isClosed()
Test whether this connection is closed or notboolean
boolean
isRemote()
Whether this RDFLink is to a remote server or not.void
Send file - this merges the file RDF into the default graph of a dataset.void
Load (add, append) RDF into the default graph of a dataset.void
Load (add, append) RDF into a named graph in a dataset.void
Load (add, append) RDF into a named graph in a dataset.void
loadDataset
(String file) void
loadDataset
(DatasetGraph dataset) static RDFLinkHTTPBuilder
Create aRDFLinkHTTPBuilder
.newQuery()
Return aQueryExecBuilder
that is initially configured for this link setup and type.Return aUpdateExecBuilder
that is initially configured for this link setup and type.boolean
promote
(Transactional.Promote promote) void
Set the contents of the default graph of a dataset.void
Set the contents of the default graph of a dataset.void
Set the contents of a named graph of a dataset.void
Set the contents of a named graph of a dataset.void
putDataset
(String file) void
putDataset
(DatasetGraph dataset) Setup a SPARQL query execution.Setup a SPARQL query execution.boolean
Execute a ASK query and return a booleanqueryConstruct
(String queryString) Execute a CONSTRUCT query and return as a GraphqueryDescribe
(String queryString) Execute a DESCRIBE query and return as a Graphvoid
queryRowSet
(String queryString, Consumer<RowSet> rowSetAction) Execute a SELECT query and process the RowSet with the handler code.void
querySelect
(String queryString, Consumer<Binding> rowAction) Execute a SELECT query and process the rows of the results with the handler code.static RDFLinkHTTPBuilder
Create aRDFLinkHTTPBuilder
.void
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
queryAsk, queryConstruct, queryConstructDataset, queryConstructDataset, queryDescribe, queryRowSet, querySelect, update
Methods inherited from interface org.apache.jena.sparql.core.Transactional
calc, calculate, calculateRead, calculateWrite, exec, execute, executeRead, executeWrite, promote
-
Method Details
-
newBuilder
Create aRDFLinkHTTPBuilder
. -
service
Create aRDFLinkHTTPBuilder
. -
from
Create aRDFLinkHTTPBuilder
initialized with the settings of anotherRDFLinkRemote
. -
isRemote
public boolean isRemote()Description copied from interface:RDFLink
Whether this RDFLink is to a remote server or not. -
getHttpClient
Return theHttpClient
in-use. -
getDestination
Return the destination URL for the connection. -
getQueryEndpoint
-
getUpdateEndpoint
-
getGraphStoreEndpoint
-
queryRowSet
Execute a SELECT query and process the RowSet with the handler code.- Specified by:
queryRowSet
in interfaceLinkSparqlQuery
- Specified by:
queryRowSet
in interfaceRDFLink
- Parameters:
queryString
-rowSetAction
-
-
querySelect
Execute a SELECT query and process the rows of the results with the handler code.- Specified by:
querySelect
in interfaceLinkSparqlQuery
- Specified by:
querySelect
in interfaceRDFLink
- Parameters:
queryString
-rowAction
-
-
queryConstruct
Execute a CONSTRUCT query and return as a Graph- Specified by:
queryConstruct
in interfaceLinkSparqlQuery
- Specified by:
queryConstruct
in interfaceRDFLink
-
queryDescribe
Execute a DESCRIBE query and return as a Graph- Specified by:
queryDescribe
in interfaceLinkSparqlQuery
- Specified by:
queryDescribe
in interfaceRDFLink
-
queryAsk
Execute a ASK query and return a boolean- Specified by:
queryAsk
in interfaceLinkSparqlQuery
- Specified by:
queryAsk
in interfaceRDFLink
-
query
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. SomeQueryExecutions
, 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 interfaceLinkSparqlQuery
- Specified by:
query
in interfaceRDFLink
- Returns:
- QueryExecution
-
query
Description copied from interface:RDFLink
Setup a SPARQL query execution. See alsoRDFLink.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 interfaceLinkSparqlQuery
- Specified by:
query
in interfaceRDFLink
- Returns:
- QueryExecution
-
newQuery
Description copied from interface:RDFLink
Return aQueryExecBuilder
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 interfaceLinkSparqlQuery
- Specified by:
newQuery
in interfaceRDFLink
- Returns:
- QueryExecBuilder
-
newUpdate
Return aUpdateExecBuilder
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 interfaceLinkSparqlUpdate
- Specified by:
newUpdate
in interfaceRDFLink
- Returns:
- UpdateExecBuilder
-
update
Description copied from interface:RDFLink
Execute a SPARQL Update.- Specified by:
update
in interfaceLinkSparqlUpdate
- Specified by:
update
in interfaceRDFLink
-
update
Description copied from interface:RDFLink
Execute a SPARQL Update.- Specified by:
update
in interfaceLinkSparqlUpdate
- Specified by:
update
in interfaceRDFLink
-
get
Fetch a named graph. This is SPARQL Graph Store Protocol HTTP GET or equivalent.- Specified by:
get
in interfaceLinkDatasetGraphAccess
- Specified by:
get
in interfaceRDFLink
- Parameters:
graphName
- URI string for the graph name (null orQuad.defaultGraphIRI
for the default graph)- Returns:
- 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 interfaceLinkDatasetGraphAccess
- Specified by:
get
in interfaceRDFLink
- Returns:
- Graph
-
load
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 interfaceLinkDatasetGraph
- Specified by:
load
in interfaceRDFLink
- Parameters:
file
- File of the data.
-
load
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 interfaceLinkDatasetGraph
- Specified by:
load
in interfaceRDFLink
- Parameters:
graphName
- Graph name (null orQuad.defaultGraphIRI
for the default graph)file
- File of the data.
-
load
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 interfaceLinkDatasetGraph
- Specified by:
load
in interfaceRDFLink
- Parameters:
graph
- Data.
-
load
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 interfaceLinkDatasetGraph
- Specified by:
load
in interfaceRDFLink
- Parameters:
graphName
- Graph name (null orQuad.defaultGraphIRI
for the default graph)graph
- Data.
-
put
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 interfaceLinkDatasetGraph
- Specified by:
put
in interfaceRDFLink
- Parameters:
file
- File of the data.
-
put
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 interfaceLinkDatasetGraph
- Specified by:
put
in interfaceRDFLink
- Parameters:
graphName
- Graph name (null orQuad.defaultGraphIRI
for the default graph)file
- File of the data.
-
put
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 interfaceLinkDatasetGraph
- Specified by:
put
in interfaceRDFLink
- Parameters:
graph
- Data.
-
put
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 interfaceLinkDatasetGraph
- Specified by:
put
in interfaceRDFLink
- Parameters:
graphName
- Graph name (null orQuad.defaultGraphIRI
for the default graph)graph
- Data.
-
delete
Description copied from interface:RDFLink
Delete a graph from the dataset. Null orQuad.defaultGraphIRI
means the default graph, which is cleared, not removed.- Specified by:
delete
in interfaceLinkDatasetGraph
- Specified by:
delete
in interfaceRDFLink
-
delete
public void delete()Description copied from interface:RDFLink
Remove all data from the default graph.- Specified by:
delete
in interfaceLinkDatasetGraph
- Specified by:
delete
in interfaceRDFLink
-
getDataset
Description copied from interface:LinkDatasetGraphAccess
Fetch the contents of the dataset- Specified by:
getDataset
in interfaceLinkDatasetGraphAccess
-
loadDataset
- Specified by:
loadDataset
in interfaceLinkDatasetGraph
- Specified by:
loadDataset
in interfaceRDFLink
-
loadDataset
- Specified by:
loadDataset
in interfaceLinkDatasetGraph
- Specified by:
loadDataset
in interfaceRDFLink
-
putDataset
- Specified by:
putDataset
in interfaceLinkDatasetGraph
- Specified by:
putDataset
in interfaceRDFLink
-
putDataset
- Specified by:
putDataset
in interfaceLinkDatasetGraph
- Specified by:
putDataset
in interfaceRDFLink
-
clearDataset
public void clearDataset()Description copied from interface:RDFLink
Clear the dataset - remove all named graphs, clear the default graph.- Specified by:
clearDataset
in interfaceLinkDatasetGraph
- Specified by:
clearDataset
in interfaceRDFLink
-
close
public void close()Description copied from interface:RDFLink
Close this connection. Use with try-resource.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceLinkDatasetGraph
- Specified by:
close
in interfaceLinkDatasetGraphAccess
- Specified by:
close
in interfaceLinkSparqlQuery
- Specified by:
close
in interfaceLinkSparqlUpdate
- Specified by:
close
in interfaceRDFLink
-
isClosed
public boolean isClosed()Description copied from interface:RDFLink
Test whether this connection is closed or not- Specified by:
isClosed
in interfaceLinkDatasetGraph
- Specified by:
isClosed
in interfaceLinkDatasetGraphAccess
- Specified by:
isClosed
in interfaceRDFLink
-
begin
public void begin()- Specified by:
begin
in interfaceTransactional
-
begin
- Specified by:
begin
in interfaceTransactional
-
begin
- Specified by:
begin
in interfaceTransactional
-
promote
- Specified by:
promote
in interfaceTransactional
-
commit
public void commit()- Specified by:
commit
in interfaceTransactional
-
abort
public void abort()- Specified by:
abort
in interfaceTransactional
-
isInTransaction
public boolean isInTransaction()- Specified by:
isInTransaction
in interfaceTransactional
-
end
public void end()- Specified by:
end
in interfaceTransactional
-
transactionMode
- Specified by:
transactionMode
in interfaceTransactional
-
transactionType
- Specified by:
transactionType
in interfaceTransactional
-