Module org.apache.jena.rdfconnection
Package org.apache.jena.rdflink

Class RDFLinkHTTP

java.lang.Object
org.apache.jena.rdflink.RDFLinkHTTP
All Implemented Interfaces:
AutoCloseable, LinkDatasetGraph, LinkDatasetGraphAccess, LinkSparqlQuery, LinkSparqlUpdate, RDFLink, org.apache.jena.sparql.core.Transactional
Direct Known Subclasses:
RDFLinkFuseki
public class RDFLinkHTTP extends Object implements RDFLink
Implementation of the RDFLink interface using remote SPARQL operations.

  • Nested Class Summary

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

    org.apache.jena.sparql.core.Transactional.Promote

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    abort()
     
    void
    begin()
     
    void
    begin(org.apache.jena.query.ReadWrite mode)
     
    void
    begin(org.apache.jena.query.TxnType txnType)
     
    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(org.apache.jena.graph.Node graphName)
    Delete a graph from the dataset.
    void
    end()
     
    static RDFLinkHTTPBuilder
    from(RDFLinkHTTP base)
    Create a RDFLinkHTTPBuilder initialized with the settings of another RDFLinkRemote.
    org.apache.jena.graph.Graph
    get()
    Fetch the default graph.
    org.apache.jena.graph.Graph
    get(org.apache.jena.graph.Node graphName)
    Fetch a named graph.
    org.apache.jena.sparql.core.DatasetGraph
    getDataset()
    Fetch the contents of the dataset
    String
    getDestination()
    Return the destination URL for the connection.
    String
    getGraphStoreEndpoint()
     
    HttpClient
    getHttpClient()
    Return the HttpClient in-use.
    String
    getQueryEndpoint()
     
    String
    getUpdateEndpoint()
     
    boolean
    isClosed()
    Test whether this connection is closed or not
    boolean
    isInTransaction()
     
    boolean
    isRemote()
    Whether this RDFLink is to a remote server or not.
    void
    load(String file)
    Send file - this merges the file RDF into the default graph of a dataset.
    void
    load(org.apache.jena.graph.Graph graph)
    Load (add, append) RDF into the default graph of a dataset.
    void
    load(org.apache.jena.graph.Node graphName, String file)
    Load (add, append) RDF into a named graph in a dataset.
    void
    load(org.apache.jena.graph.Node graphName, org.apache.jena.graph.Graph graph)
    Load (add, append) RDF into a named graph in a dataset.
    void
    loadDataset(String file)
     
    void
    loadDataset(org.apache.jena.sparql.core.DatasetGraph dataset)
     
    static RDFLinkHTTPBuilder
    newBuilder()
    Create a RDFLinkHTTPBuilder.
    org.apache.jena.sparql.exec.QueryExecBuilder
    newQuery()
    Return a QueryExecBuilder that is initially configured for this link setup and type.
    org.apache.jena.sparql.exec.UpdateExecBuilder
    newUpdate()
    Return a UpdateExecBuilder that is initially configured for this link setup and type.
    boolean
    promote(org.apache.jena.sparql.core.Transactional.Promote promote)
     
    void
    put(String file)
    Set the contents of the default graph of a dataset.
    void
    put(org.apache.jena.graph.Graph graph)
    Set the contents of the default graph of a dataset.
    void
    put(org.apache.jena.graph.Node graphName, String file)
    Set the contents of a named graph of a dataset.
    void
    put(org.apache.jena.graph.Node graphName, org.apache.jena.graph.Graph graph)
    Set the contents of a named graph of a dataset.
    void
    putDataset(String file)
     
    void
    putDataset(org.apache.jena.sparql.core.DatasetGraph dataset)
     
    org.apache.jena.sparql.exec.QueryExec
    query(String queryString)
    Setup a SPARQL query execution.
    org.apache.jena.sparql.exec.QueryExec
    query(org.apache.jena.query.Query query)
    Setup a SPARQL query execution.
    boolean
    queryAsk(String queryString)
    Execute a ASK query and return a boolean
    org.apache.jena.graph.Graph
    queryConstruct(String queryString)
    Execute a CONSTRUCT query and return as a Graph
    org.apache.jena.graph.Graph
    queryDescribe(String queryString)
    Execute a DESCRIBE query and return as a Graph
    void
    queryRowSet(String queryString, Consumer<org.apache.jena.sparql.exec.RowSet> rowSetAction)
    Execute a SELECT query and process the RowSet with the handler code.
    void
    querySelect(String queryString, Consumer<org.apache.jena.sparql.engine.binding.Binding> rowAction)
    Execute a SELECT query and process the rows of the results with the handler code.
    static RDFLinkHTTPBuilder
    service(String destinationURL)
    Create a RDFLinkHTTPBuilder.
    org.apache.jena.query.ReadWrite
    transactionMode()
     
    org.apache.jena.query.TxnType
    transactionType()
     
    void
    update(String updateString)
    Execute a SPARQL Update.
    void
    update(org.apache.jena.update.UpdateRequest update)
    Execute a SPARQL Update.

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    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

      public static RDFLinkHTTPBuilder newBuilder()
      Create a RDFLinkHTTPBuilder.

    • service

      public static RDFLinkHTTPBuilder service(String destinationURL)
      Create a RDFLinkHTTPBuilder.

    • from

      public static RDFLinkHTTPBuilder from(RDFLinkHTTP base)
      Create a RDFLinkHTTPBuilder initialized with the settings of another RDFLinkRemote.

    • isRemote

      public boolean isRemote()
      Description copied from interface: RDFLink
      Whether this RDFLink is to a remote server or not.
      Specified by:
      isRemote in interface RDFLink

    • getHttpClient

      public HttpClient getHttpClient()
      Return the HttpClient in-use.

    • getDestination

      public String getDestination()
      Return the destination URL for the connection.

    • getQueryEndpoint

      public String getQueryEndpoint()

    • getUpdateEndpoint

      public String getUpdateEndpoint()

    • getGraphStoreEndpoint

      public String getGraphStoreEndpoint()

    • queryRowSet

      public void queryRowSet(String queryString, Consumer<org.apache.jena.sparql.exec.RowSet> rowSetAction)
      Execute a SELECT query and process the RowSet with the handler code.
      Specified by:
      queryRowSet in interface LinkSparqlQuery
      Specified by:
      queryRowSet in interface RDFLink
      Parameters:
      queryString -
      rowSetAction -

    • querySelect

      public void querySelect(String queryString, Consumer<org.apache.jena.sparql.engine.binding.Binding> rowAction)
      Execute a SELECT query and process the rows of the results with the handler code.
      Specified by:
      querySelect in interface LinkSparqlQuery
      Specified by:
      querySelect in interface RDFLink
      Parameters:
      queryString -
      rowAction -

    • queryConstruct

      public org.apache.jena.graph.Graph queryConstruct(String queryString)
      Execute a CONSTRUCT query and return as a Graph
      Specified by:
      queryConstruct in interface LinkSparqlQuery
      Specified by:
      queryConstruct in interface RDFLink

    • queryDescribe

      public org.apache.jena.graph.Graph queryDescribe(String queryString)
      Execute a DESCRIBE query and return as a Graph
      Specified by:
      queryDescribe in interface LinkSparqlQuery
      Specified by:
      queryDescribe in interface RDFLink

    • queryAsk

      public boolean queryAsk(String queryString)
      Execute a ASK query and return a boolean
      Specified by:
      queryAsk in interface LinkSparqlQuery
      Specified by:
      queryAsk in interface RDFLink

    • query

      public org.apache.jena.sparql.exec.QueryExec query(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

    • query

      public org.apache.jena.sparql.exec.QueryExec query(org.apache.jena.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

    • newQuery

      public org.apache.jena.sparql.exec.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

    • newUpdate

      public org.apache.jena.sparql.exec.UpdateExecBuilder newUpdate()
      Return a UpdateExecBuilder 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 interface LinkSparqlUpdate
      Specified by:
      newUpdate in interface RDFLink
      Returns:
      UpdateExecBuilder

    • update

      public void update(String updateString)
      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(org.apache.jena.update.UpdateRequest update)
      Description copied from interface: RDFLink
      Execute a SPARQL Update.
      Specified by:
      update in interface LinkSparqlUpdate
      Specified by:
      update in interface RDFLink

    • get

      public org.apache.jena.graph.Graph get(org.apache.jena.graph.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

    • get

      public org.apache.jena.graph.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

    • load

      public void load(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(org.apache.jena.graph.Node graphName, 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(org.apache.jena.graph.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(org.apache.jena.graph.Node graphName, org.apache.jena.graph.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(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(org.apache.jena.graph.Node graphName, 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(org.apache.jena.graph.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(org.apache.jena.graph.Node graphName, org.apache.jena.graph.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(org.apache.jena.graph.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

    • getDataset

      public org.apache.jena.sparql.core.DatasetGraph getDataset()
      Description copied from interface: LinkDatasetGraphAccess
      Fetch the contents of the dataset
      Specified by:
      getDataset in interface LinkDatasetGraphAccess

    • loadDataset

      public void loadDataset(String file)
      Specified by:
      loadDataset in interface LinkDatasetGraph
      Specified by:
      loadDataset in interface RDFLink

    • loadDataset

      public void loadDataset(org.apache.jena.sparql.core.DatasetGraph dataset)
      Specified by:
      loadDataset in interface LinkDatasetGraph
      Specified by:
      loadDataset in interface RDFLink

    • putDataset

      public void putDataset(String file)
      Specified by:
      putDataset in interface LinkDatasetGraph
      Specified by:
      putDataset in interface RDFLink

    • putDataset

      public void putDataset(org.apache.jena.sparql.core.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

    • close

      public void close()
      Description copied from interface: RDFLink
      Close this connection. Use with try-resource.
      Specified by:
      close in interface 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

    • 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

    • begin

      public void begin()
      Specified by:
      begin in interface org.apache.jena.sparql.core.Transactional

    • begin

      public void begin(org.apache.jena.query.TxnType txnType)
      Specified by:
      begin in interface org.apache.jena.sparql.core.Transactional

    • begin

      public void begin(org.apache.jena.query.ReadWrite mode)
      Specified by:
      begin in interface org.apache.jena.sparql.core.Transactional

    • promote

      public boolean promote(org.apache.jena.sparql.core.Transactional.Promote promote)
      Specified by:
      promote in interface org.apache.jena.sparql.core.Transactional

    • commit

      public void commit()
      Specified by:
      commit in interface org.apache.jena.sparql.core.Transactional

    • abort

      public void abort()
      Specified by:
      abort in interface org.apache.jena.sparql.core.Transactional

    • isInTransaction

      public boolean isInTransaction()
      Specified by:
      isInTransaction in interface org.apache.jena.sparql.core.Transactional

    • end

      public void end()
      Specified by:
      end in interface org.apache.jena.sparql.core.Transactional

    • transactionMode

      public org.apache.jena.query.ReadWrite transactionMode()
      Specified by:
      transactionMode in interface org.apache.jena.sparql.core.Transactional

    • transactionType

      public org.apache.jena.query.TxnType transactionType()
      Specified by:
      transactionType in interface org.apache.jena.sparql.core.Transactional