Class ResultSetFactory

java.lang.Object
org.apache.jena.query.ResultSetFactory

public class ResultSetFactory extends Object
ResultSetFactory - make result sets from places other than a query.
  • Constructor Details

    • ResultSetFactory

      public ResultSetFactory()
  • Method Details

    • load

      public static ResultSet load(String filenameOrURI)
      Load a result set from file or URL into a result set (memory backed).
      Parameters:
      filenameOrURI -
      Returns:
      ResultSet
    • load

      public static ResultSet load(String filenameOrURI, ResultsFormat format)
      Load a result set from file or URL into a result set (memory backed).
      Parameters:
      filenameOrURI -
      format -
      Returns:
      ResultSet
    • load

      public static ResultSet load(InputStream input, ResultsFormat format)
      Load a result set from input stream into a result set (memory backed).
      Parameters:
      input -
      format -
      Returns:
      ResultSet
    • loadAsModel

      public static org.apache.jena.rdf.model.Model loadAsModel(String filenameOrURI)
      Load a result set (or any other model) from file or URL
      Parameters:
      filenameOrURI -
      Returns:
      Model
    • loadAsModel

      public static org.apache.jena.rdf.model.Model loadAsModel(org.apache.jena.rdf.model.Model model, String filenameOrURI)
      Load a result set (or any other model) from file or URL
      Parameters:
      model - Load into this model (returned)
      filenameOrURI -
      Returns:
      Model
    • loadAsModel

      public static org.apache.jena.rdf.model.Model loadAsModel(String filenameOrURI, ResultsFormat format)
      Load a result set (or any other model) from file or URL
      Parameters:
      filenameOrURI -
      format -
      Returns:
      Model
    • loadAsModel

      @Deprecated public static org.apache.jena.rdf.model.Model loadAsModel(org.apache.jena.rdf.model.Model model, String filenameOrURI, ResultsFormat format)
      Deprecated.
      This function will become be internal.
      Load a result set (or any other model) from file or URL. Does not have to be a result set (e.g. CONSTRUCt results) but it does interpret the ResultSetFormat possibilities.
      Parameters:
      model - Load into this model (returned)
      filenameOrURI -
      format -
      Returns:
      Model
    • result

      public static SPARQLResult result(String filenameOrURI)
      Read in any kind of result kind (result set, boolean, graph) Guess the syntax based on filename/URL extension.
    • fromXML

      public static ResultSet fromXML(InputStream in)
      Read XML which is the format of the SPARQL result set format.
      Parameters:
      in - InputStream
      Returns:
      ResultSet
    • fromJSON

      public static ResultSet fromJSON(InputStream in)
      Read from an input stream which is the format of the SPARQL result set format in JSON.
      Parameters:
      in - InputStream
      Returns:
      ResultSet
    • makeResults

      public static ResultSet makeResults(org.apache.jena.rdf.model.Model model)
      Turns an RDF model, with properties and classes from the result set vocabulary, into a SPARQL result set. The result set formed is a copy in memory.
      Parameters:
      model -
      Returns:
      ResultSet
    • makeRewindable

      public static ResultSetRewindable makeRewindable(org.apache.jena.rdf.model.Model model)
      Turns an RDF model, with properties and classes from the result set vocabulary, into a SPARQL result set which is rewindable (has a .reset()operation). The result set formed is a copy in memory.
      Parameters:
      model -
      Returns:
      ResultSetRewindable
    • makeRewindable

      public static ResultSetRewindable makeRewindable(ResultSet resultSet)
      Turn an existing result set into a rewindable one. May take a copy but this is not guaranteed Uses up the result set passed in which is no longer valid as a ResultSet.
      Parameters:
      resultSet -
      Returns:
      ResultSetRewindable
    • makeRewindable

      public static ResultSetRewindable makeRewindable(RowSet rowSet)
      Turn a row set into a rewindable ResultSet. Uses up the result set passed in which is no longer valid as a RowSet.
      Parameters:
      rowSet -
      Returns:
      ResultSetRewindable
    • makePeekable

      public static ResultSetPeekable makePeekable(ResultSet resultSet)
      Turns an existing result set into one with peeking capabilities

      Using the returned result set consumes the result set passed in, the underlying result set must be at the start in order to be made peeking. If you create such a result set you should avoid accessing the underlying result set directly as this may cause results to be missed or put the returned peekable result set into an invalid state.

      Note that rewindable results may typically also be peekable so may be more broadly applicable if you can afford the cost of loading all the results into memory.

      Parameters:
      resultSet - Result set to wrap
      Returns:
      Peekable results
    • closeableResultSet

      public static ResultSetCloseable closeableResultSet(QueryExecution queryExecution)
      Return a closable resultset for a QueryExecution. The QueryExecution must be for a SELECT query.

      Example:

         QueryExecution qExec = QueryExecutionFactory.create(...);
         try (ResultSetCloseable rs = ResultSetFactory.closableResultSet(qExec) ) {
             ...
       }
       
      Parameters:
      queryExecution - QueryExecution must be for a SELECT query.
      Returns:
      ResultSetCloseable
    • copyResults

      public static ResultSetRewindable copyResults(ResultSet results)
      Take a copy of a result set - the result set returns is an in-memory copy. It is not attached to the original query execution object which can be closed.
      Parameters:
      results -
      Returns:
      ResultSet
    • create

      public static ResultSet create(QueryIterator queryIterator, List<String> vars)
      Build a result set from one of ARQ's lower level query iterator.
      Parameters:
      queryIterator -
      vars - List of variables, by name, for the result set
      Returns:
      ResultSet