public final class QueryResults extends Object
Utilities for working with QueryResults
Modifier and Type | Method and Description |
---|---|
static void |
closeQuietly(QueryResult<?> theResult)
"Quietly"
close the QueryResult ; any exception throw while closing will simply
be logged. |
static void |
consume(QueryResult<?> theResult)
Iterate over all of the results and close the result set.
|
static boolean |
equals(SelectQueryResult tqr1,
SelectQueryResult tqr2)
Compares two tuple query results and returns
true if they are equal. |
static boolean |
equalsWithOrder(SelectQueryResult tqr1,
SelectQueryResult tqr2)
Similar to
equals(SelectQueryResult, SelectQueryResult) but also checks the order of binding sets. |
static boolean |
isSubset(SelectQueryResult tqr1,
SelectQueryResult tqr2)
Compares two tuple query results and returns
true if the the first is a subset of the other. |
static void |
report(SelectQueryResult theResult,
SelectQueryResultHandler theHandler)
Iterate over the query result and send the results to the given handler
|
static <T> Optional<T> |
singleResult(QueryResult<T> theResult)
Return the next result from the results and close the results.
|
static long |
size(QueryResult<?> theResult)
Return the number of results present in this result set
|
static <T> List<T> |
toList(QueryResult<T> theResult)
|
public static <T> List<T> toList(QueryResult<T> theResult)
theResult
- the query resultclosed
.public static void report(@Nonnull SelectQueryResult theResult, @Nonnull SelectQueryResultHandler theHandler)
theResult
- the resulttheHandler
- the result handlerQueryExecutionFailure
- if the next result could not be computedclosed
.@Nonnull public static <T> Optional<T> singleResult(@Nonnull QueryResult<T> theResult)
theResult
- the resultQueryExecutionFailure
- if the next result could not be computedclosed
.public static long size(@Nonnull QueryResult<?> theResult)
theResult
- the resultsQueryExecutionFailure
- if the results count not be computedclosed
.public static void consume(@Nonnull QueryResult<?> theResult)
theResult
- the resultsQueryExecutionFailure
- if the execution failed in any waypublic static void closeQuietly(@Nonnull QueryResult<?> theResult)
close
the QueryResult
; any exception throw while closing will simply
be logged.theResult
- the result to closepublic static boolean equals(@Nonnull SelectQueryResult tqr1, @Nonnull SelectQueryResult tqr2) throws QueryExecutionFailure
true
if they are equal. Tuple query results are
equal if they contain the same set of BindingSet
s and have the same headers. Blank nodes
identifiers are not relevant for equality, they are matched by trying to find compatible mappings
between BindingSets. Note that the method consumes both query results fully.tqr1
- the first SelectQueryResult
to compare.tqr2
- the second SelectQueryResult
to compare.QueryExecutionFailure
public static boolean equalsWithOrder(@Nonnull SelectQueryResult tqr1, @Nonnull SelectQueryResult tqr2)
equals(SelectQueryResult, SelectQueryResult)
but also checks the order of binding sets.public static boolean isSubset(@Nonnull SelectQueryResult tqr1, @Nonnull SelectQueryResult tqr2) throws QueryExecutionFailure
true
if the the first is a subset of the other.
Uses the same notion of BindingSet
equality as equals(SelectQueryResult, SelectQueryResult)
.tqr1
- the first SelectQueryResult
to compare.tqr2
- the second SelectQueryResult
to compare.QueryExecutionFailure
Copyright © 2010-2016 Stardog Union. All Rights Reserved.