com.bigdata.rdf.sparql.ast

Class ASTContainer

java.lang.Object

com.bigdata.bop.CoreBaseBOp

com.bigdata.bop.ModifiableBOpBase

com.bigdata.rdf.sparql.ast.ASTBase

com.bigdata.rdf.sparql.ast.ASTContainer

All Implemented Interfaces:

BOp, IPropertySet, Serializable, Cloneable

public class ASTContainer
extends ASTBase

A super container for the AST.

Version:

$Id$

Author:

Bryan Thompson

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ASTContainer.Annotations

Field Summary

Fields inherited from class com.bigdata.bop.CoreBaseBOp

DEFAULT_INITIAL_CAPACITY

Fields inherited from interface com.bigdata.bop.BOp

NOANNS, NOARGS

Constructor Summary

Constructors

Constructor and Description
ASTContainer(ASTContainer op) Deep copy constructor.
ASTContainer(BOp[] args, Map<String,Object> annotations) Shallow copy constructor.
ASTContainer(QueryRoot queryRoot)
ASTContainer(UpdateRoot updateRoot)

Method Summary

Methods

Modifier and Type	Method and Description
void	clearOptimizedAST() Clears the optimized AST model (necessary when something on which it depends has been changed in the original AST model, for example, if you replace the DatasetNode).
QueryRoot	getOptimizedAST() Return the optimized AST model.
IBindingSet[]	getOptimizedASTBindingSets() Return the incoming binding sets associated with the optimized AST.
QueryRoot	getOriginalAST() Return the original AST model (before any optimization).
UpdateRoot	getOriginalUpdateAST() Return the original AST model (before any optimization).
Object	getParseTree() Return the parse tree generated from the query string.
Long	getQueryParseTime() Get the query parse time in nanoseconds.
PipelineOp	getQueryPlan() Return the physical query plan (pipeline bops).
String	getQueryString() Return the original SPARQL QUERY -or- UPDATE from which this AST model was generated.
Long	getResolveValuesTime() Get the resolve values time in nanoseconds.
boolean	isQuery() Return true iff this ASTContainer models a SPARQL QUERY operation.
boolean	isUpdate() Return true iff this ASTContainer models a SPARQL UPDATE operation.
void	setOptimizedAST(QueryRoot queryRoot) Set the optimized AST model.
void	setOptimizedASTBindingSets(IBindingSet[] bindingSets) Set the incoming binding sets associated with the optimized AST.
void	setOriginalAST(QueryRoot queryRoot) Set the original AST model (before any optimizations).
void	setOriginalUpdateAST(UpdateRoot updateRoot) Set the original AST model (before any optimizations).
void	setParseTree(Object parseTree) Set the parse tree generated from the query string.
void	setQueryParseTime(Long parseTime) Set the query parse time in nanoseconds.
void	setQueryPlan(PipelineOp queryPlan) Set the physical plan for query or update (pipeline bops).
void	setQueryString(String queryString) Set the SPARQL QUERY -or- UPDATE string used to generate the AST model.
void	setResolveValuesTime(Long nanos) Set the RDF value resolution time in nanoseconds.
String	toString() Return a non-recursive representation of the arguments and annotations for this BOp.

Methods inherited from class com.bigdata.rdf.sparql.ast.ASTBase

addExplainHint, getExplainHints, getQueryHint, getQueryHint, getQueryHintAsBoolean, getQueryHintAsBoolean, getQueryHintAsInteger, getQueryHints, replaceAllWith, setQueryHint, setQueryHints

Methods inherited from class com.bigdata.bop.ModifiableBOpBase

addArg, addArg, addArgIfAbsent, annotations, annotationsEqual, argIterator, args, arity, clearProperty, copyAll, get, getProperty, indexOf, removeArg, replaceWith, setArg, setArgs, setId, setProperty, setUnboundProperty, toArray, toArray

Methods inherited from class com.bigdata.bop.CoreBaseBOp

annotationsEqual, annotationsToString, annotationsToString, annotationValueToString, checkArgs, clone, equals, getEvaluationContext, getId, getProperty, getRequiredProperty, hashCode, indent, isController, mutation, shortenName, toShortString, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ASTContainer

public ASTContainer(ASTContainer op)

Deep copy constructor.

ASTContainer

public ASTContainer(BOp[] args,
            Map<String,Object> annotations)

Shallow copy constructor.

ASTContainer

public ASTContainer(QueryRoot queryRoot)

ASTContainer

public ASTContainer(UpdateRoot updateRoot)

Method Detail

getQueryString

public String getQueryString()

Return the original SPARQL QUERY -or- UPDATE from which this AST model was generated.

Returns:

The original Query or Update -or- null if the AST was not generated by the parser.

setQueryString

public void setQueryString(String queryString)

Set the SPARQL QUERY -or- UPDATE string used to generate the AST model.

Parameters:

queryString - The query string.

getParseTree

public Object getParseTree()

Return the parse tree generated from the query string.

setParseTree

public void setParseTree(Object parseTree)

Set the parse tree generated from the query string.

Parameters:

parseTree - The parse tree (may be null).

isUpdate

public boolean isUpdate()

Return true iff this ASTContainer models a SPARQL UPDATE operation.

isQuery

public boolean isQuery()

Return true iff this ASTContainer models a SPARQL QUERY operation.

getOriginalUpdateAST

public UpdateRoot getOriginalUpdateAST()

Return the original AST model (before any optimization).

setOriginalUpdateAST

public void setOriginalUpdateAST(UpdateRoot updateRoot)

Set the original AST model (before any optimizations).

getOriginalAST

public QueryRoot getOriginalAST()

Return the original AST model (before any optimization).

setOptimizedASTBindingSets

public void setOptimizedASTBindingSets(IBindingSet[] bindingSets)

Set the incoming binding sets associated with the optimized AST.

getOptimizedASTBindingSets

public IBindingSet[] getOptimizedASTBindingSets()

Return the incoming binding sets associated with the optimized AST.

setOriginalAST

public void setOriginalAST(QueryRoot queryRoot)

Set the original AST model (before any optimizations).

getOptimizedAST

public QueryRoot getOptimizedAST()

Return the optimized AST model.

setQueryParseTime

public void setQueryParseTime(Long parseTime)

Set the query parse time in nanoseconds.

getQueryParseTime

public Long getQueryParseTime()

Get the query parse time in nanoseconds.

setResolveValuesTime

public void setResolveValuesTime(Long nanos)

Set the RDF value resolution time in nanoseconds.

getResolveValuesTime

public Long getResolveValuesTime()

Get the resolve values time in nanoseconds.

setOptimizedAST

public void setOptimizedAST(QueryRoot queryRoot)

Set the optimized AST model.

Note: You MUST deep copy the original AST to avoid destructive side effects when the IASTOptimizers are run.

clearOptimizedAST

public void clearOptimizedAST()

Clears the optimized AST model (necessary when something on which it depends has been changed in the original AST model, for example, if you replace the DatasetNode).

getQueryPlan

public PipelineOp getQueryPlan()

Return the physical query plan (pipeline bops).

setQueryPlan

public void setQueryPlan(PipelineOp queryPlan)

Set the physical plan for query or update (pipeline bops).

toString

public String toString()

Description copied from class: CoreBaseBOp

Return a non-recursive representation of the arguments and annotations for this BOp.

Specified by:

toString in interface BOp

Overrides:

toString in class CoreBaseBOp