org.openrdf.query

Class QueryResults

java.lang.Object

info.aduna.iteration.Iterations

org.openrdf.query.QueryResults

Direct Known Subclasses:

QueryResultUtil

public class QueryResults
extends Iterations

Utility methods related to query results.

Since:

2.7.0

Author:

Jeen Broekstra

Constructor Summary

Constructors

Constructor and Description
QueryResults()

Method Summary

Methods

Modifier and Type	Method and Description
static Graph	asGraph(GraphQueryResult gqr) Get a Graph containing all elements obtained from the specified query result.
static Model	asModel(GraphQueryResult gqr) Get a Model containing all elements obtained from the specified query result.
static boolean	bindingSetsCompatible(BindingSet bs1, BindingSet bs2) Check whether two BindingSets are compatible.
static boolean	equals(GraphQueryResult result1, GraphQueryResult result2)
static boolean	equals(TupleQueryResult tqr1, TupleQueryResult tqr2) Compares the two query results by converting them to graphs and returns true if they are equal.
static boolean	isSubset(TupleQueryResult tqr1, TupleQueryResult tqr2)
static void	report(GraphQueryResult gqr, RDFHandler rdfHandler) Reports a graph query result to an RDFHandler.
static void	report(TupleQueryResult tqr, TupleQueryResultHandler handler) Reports a tuple query result to a TupleQueryResultHandler.
static Statement	singleResult(GraphQueryResult result) Returns a single element from the query result.
BindingSet	singleResult(TupleQueryResult result) Returns a single element from the query result.

Methods inherited from class info.aduna.iteration.Iterations

addAll, asList, asSet, closeCloseable, toString, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QueryResults

public QueryResults()

Method Detail

asGraph

public static Graph asGraph(GraphQueryResult gqr)
                     throws QueryEvaluationException

Get a Graph containing all elements obtained from the specified query result.

Parameters:

gqr - the GraphQueryResult to get the statements from

Returns:

a Graph containing all statements obtained from the specified query result.

Throws:

QueryEvaluationException

Since:

2.7.0

asModel

public static Model asModel(GraphQueryResult gqr)
                     throws QueryEvaluationException

Get a Model containing all elements obtained from the specified query result.

Parameters:

gqr - the GraphQueryResult to get the statements from

Returns:

a Model containing all statements obtained from the specified query result.

Throws:

QueryEvaluationException

Since:

2.7.0

singleResult

public static Statement singleResult(GraphQueryResult result)
                              throws QueryEvaluationException

Returns a single element from the query result. The QueryResult is automatically closed by this method.

Returns:

a single query result element.

Throws:

QueryEvaluationException

Since:

2.7.0

singleResult

public BindingSet singleResult(TupleQueryResult result)
                        throws QueryEvaluationException

Returns a single element from the query result. The QueryResult is automatically closed by this method.

Returns:

a single query result element.

Throws:

QueryEvaluationException

Since:

2.7.0

report

public static void report(TupleQueryResult tqr,
          TupleQueryResultHandler handler)
                   throws TupleQueryResultHandlerException,
                          QueryEvaluationException

Reports a tuple query result to a TupleQueryResultHandler.

Parameters:

tqr - The query result to report.

handler - The handler to report the query result to.

Throws:

TupleQueryResultHandlerException - If such an exception is thrown by the used query result writer.

QueryEvaluationException

report

public static void report(GraphQueryResult gqr,
          RDFHandler rdfHandler)
                   throws RDFHandlerException,
                          QueryEvaluationException

Reports a graph query result to an RDFHandler.

Parameters:

gqr - The query result to report.

rdfHandler - The handler to report the query result to.

Throws:

RDFHandlerException - If such an exception is thrown by the used RDF writer.

QueryEvaluationException

equals

public static boolean equals(TupleQueryResult tqr1,
             TupleQueryResult tqr2)
                      throws QueryEvaluationException

Compares the two query results by converting them to graphs and returns true if they are equal. QueryResults are equal if they contain the same set of BindingSet and have the headers. Blank nodes identifiers are not relevant for equality, they are mapped from one model to the other by using the attached properties. Note that the method consumes both query results fully.

Throws:

QueryEvaluationException

isSubset

public static boolean isSubset(TupleQueryResult tqr1,
               TupleQueryResult tqr2)
                        throws QueryEvaluationException

Throws:

QueryEvaluationException

equals

public static boolean equals(GraphQueryResult result1,
             GraphQueryResult result2)
                      throws QueryEvaluationException

Throws:

QueryEvaluationException

bindingSetsCompatible

public static boolean bindingSetsCompatible(BindingSet bs1,
                            BindingSet bs2)

Check whether two BindingSets are compatible. Two binding sets are compatible if they have equal values for each binding name that occurs in both binding sets.