com.bigdata.rdf.sparql.ast.eval

Class ASTEvalHelper

java.lang.Object

com.bigdata.rdf.sparql.ast.eval.ASTEvalHelper

public class ASTEvalHelper
extends Object

Helper class for evaluating SPARQL queries.

Version:

$Id$

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
ASTEvalHelper()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	evaluateBooleanQuery(AbstractTripleStore store, ASTContainer astContainer, org.openrdf.query.BindingSet globallyScopedBS, org.openrdf.query.Dataset dataset) Evaluate a boolean query.
static org.openrdf.query.GraphQueryResult	evaluateGraphQuery(AbstractTripleStore store, ASTContainer astContainer, org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS, org.openrdf.query.Dataset dataset) Evaluate a CONSTRUCT/DESCRIBE query.
static org.openrdf.query.TupleQueryResult	evaluateTupleQuery(AbstractTripleStore store, ASTContainer astContainer, org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS, org.openrdf.query.Dataset dataset) Evaluate a SELECT query.
static ICloseableIterator<IBindingSet[]>	evaluateTupleQuery2(AbstractTripleStore store, ASTContainer astContainer, org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS, boolean materialize) Evaluate a SELECT query without converting the results into openrdf solutions.
static long	executeUpdate(BigdataSailRepositoryConnection conn, ASTContainer astContainer, org.openrdf.query.Dataset dataset, boolean includeInferred, org.openrdf.query.algebra.evaluation.QueryBindingSet bs) Evaluate a SPARQL UPDATE request (core method).
static QueryRoot	optimizeQuery(ASTContainer astContainer, AST2BOpContext context, org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS, org.openrdf.query.Dataset dataset) Optimize a SELECT query.

Methods inherited from class java.lang.Object

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

Constructor Detail

ASTEvalHelper

public ASTEvalHelper()

Method Detail

evaluateBooleanQuery

public static boolean evaluateBooleanQuery(AbstractTripleStore store,
                           ASTContainer astContainer,
                           org.openrdf.query.BindingSet globallyScopedBS,
                           org.openrdf.query.Dataset dataset)
                                    throws org.openrdf.query.QueryEvaluationException

Evaluate a boolean query.

Parameters:

store - The AbstractTripleStore having the data.

astContainer - The ASTContainer.

globallyScopedBS - The initial solution to kick things off.

Returns:

true if there are any solutions to the query.

Throws:

org.openrdf.query.QueryEvaluationException

evaluateTupleQuery

public static org.openrdf.query.TupleQueryResult evaluateTupleQuery(AbstractTripleStore store,
                                                    ASTContainer astContainer,
                                                    org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS,
                                                    org.openrdf.query.Dataset dataset)
                                                             throws org.openrdf.query.QueryEvaluationException

Evaluate a SELECT query.

Parameters:

store - The AbstractTripleStore having the data.

queryPlan - The ASTContainer.

globallyScopedBS - The initial solution to kick things off.

Returns:

An object from which the solutions may be drained.

Throws:

org.openrdf.query.QueryEvaluationException

evaluateTupleQuery2

public static ICloseableIterator<IBindingSet[]> evaluateTupleQuery2(AbstractTripleStore store,
                                                    ASTContainer astContainer,
                                                    org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS,
                                                    boolean materialize)
                                                             throws org.openrdf.query.QueryEvaluationException

Evaluate a SELECT query without converting the results into openrdf solutions.

Parameters:

store - The AbstractTripleStore having the data.

queryPlan - The ASTContainer.

globallyScopedBS - The initial solution to kick things off.

materialize - When true, IVs will be materialized (their IVCache association will be set to the corresponding RDF Value). When false, this materialization step will be skipped. However, it is possible that IVs in the query plan will be materialized anyway (for example, materialization might be required to support FILTERs in the query).

Returns:

An object from which the solutions may be drained.

Throws:

org.openrdf.query.QueryEvaluationException

optimizeQuery

public static QueryRoot optimizeQuery(ASTContainer astContainer,
                      AST2BOpContext context,
                      org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS,
                      org.openrdf.query.Dataset dataset)
                               throws org.openrdf.query.QueryEvaluationException

Optimize a SELECT query.

Parameters:

store - The AbstractTripleStore having the data.

queryPlan - The ASTContainer.

globallyScopedBS - The initial solution to kick things off.

Returns:

An optimized AST.

Throws:

org.openrdf.query.QueryEvaluationException

evaluateGraphQuery

public static org.openrdf.query.GraphQueryResult evaluateGraphQuery(AbstractTripleStore store,
                                                    ASTContainer astContainer,
                                                    org.openrdf.query.algebra.evaluation.QueryBindingSet globallyScopedBS,
                                                    org.openrdf.query.Dataset dataset)
                                                             throws org.openrdf.query.QueryEvaluationException

Evaluate a CONSTRUCT/DESCRIBE query.

Note: For a DESCRIBE query, this also updates the DESCRIBE cache.

Parameters:

store - The AbstractTripleStore having the data.

astContainer - The ASTContainer.

globallyScopedBS - The initial solution to kick things off.

Throws:

org.openrdf.query.QueryEvaluationException

See Also:

DESCRIBE CACHE

executeUpdate

public static long executeUpdate(BigdataSailRepositoryConnection conn,
                 ASTContainer astContainer,
                 org.openrdf.query.Dataset dataset,
                 boolean includeInferred,
                 org.openrdf.query.algebra.evaluation.QueryBindingSet bs)
                          throws org.openrdf.query.UpdateExecutionException

Evaluate a SPARQL UPDATE request (core method).

Parameters:

astContainer - The query model.

ctx - The evaluation context.

dataset - A dataset which will override the data set declaration for each DeleteInsertGraph operation in the update sequence (optional).

includeInferred - if inferences should be included in various operations.

Returns:

The timestamp of the commit point.

Throws:

org.openrdf.sail.SailException - TODO timeout for update?

org.openrdf.query.UpdateExecutionException