com.bigdata.rdf.sparql.ast

Class UpdateRoot

java.lang.Object

com.bigdata.bop.CoreBaseBOp

com.bigdata.bop.ModifiableBOpBase

com.bigdata.rdf.sparql.ast.ASTBase

com.bigdata.rdf.sparql.ast.QueryNodeBase

com.bigdata.rdf.sparql.ast.GroupMemberNodeBase<E>

com.bigdata.rdf.sparql.ast.GroupNodeBase<Update>

com.bigdata.rdf.sparql.ast.UpdateRoot

All Implemented Interfaces:

BOp, IGroupMemberNode, IGroupNode<Update>, IPrefixDecls, IQueryNode, IVariableBindingRequirements, IPropertySet, Serializable, Cloneable, Iterable<Update>

public class UpdateRoot
extends GroupNodeBase<Update>
implements IPrefixDecls

The top level container for a sequence of UPDATE operations.

Version:

$Id$

Author:

Bryan Thompson

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	UpdateRoot.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
UpdateRoot()
UpdateRoot(BOp[] args, Map<String,Object> anns)
UpdateRoot(UpdateRoot op)

Method Summary

Methods

Modifier and Type	Method and Description
Set<IVariable<?>>	getDesiredBound(StaticAnalysis sa) Get variables that are not required to be bound, but desired in the sense that we want them to be bound when evaluating the construct.
Map<String,String>	getPrefixDecls() The namespace prefix declarations map.
Set<IVariable<?>>	getRequiredBound(StaticAnalysis sa) Return the variables used in the node that *must* be bound prior to evaluating the node.
void	setPrefixDecls(Map<String,String> prefixDecls) Set the namespace prefix declarations map.
String	toString(int indent) Simple but robust version of to-String

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

addArg, addArg, addChild, clone, getAttachedJoinFilters, getChildren, isEmpty, iterator, removeArg, removeChild, replaceWith, setArg, setAttachedJoinFilters, size

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

getContext, getParent, getParentGraphPatternGroup, getParentJoinGroup, setParent

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

getQueryHints, toString

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

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

Methods inherited from class com.bigdata.bop.ModifiableBOpBase

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

Methods inherited from class com.bigdata.bop.CoreBaseBOp

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.bigdata.rdf.sparql.ast.IGroupMemberNode

getContext, getParent, getParentGraphPatternGroup, getParentJoinGroup, setParent

Methods inherited from interface com.bigdata.bop.BOp

annotations, argIterator, args, arity, get, getEvaluationContext, getId, getProperty, getRequiredProperty, isController, setProperty, toArray, toArray, toShortString, toString

Methods inherited from interface cutthecrap.utils.striterators.IPropertySet

getProperty

Constructor Detail

UpdateRoot

public UpdateRoot()

UpdateRoot

public UpdateRoot(UpdateRoot op)

Parameters:

op -

UpdateRoot

public UpdateRoot(BOp[] args,
          Map<String,Object> anns)

Parameters:

args -

anns -

Method Detail

getPrefixDecls

public Map<String,String> getPrefixDecls()

Description copied from interface: IPrefixDecls

The namespace prefix declarations map. This is a Map with String keys (prefix) and String values (the uri associated with that prefix).

Specified by:

getPrefixDecls in interface IPrefixDecls

Returns:

The namespace prefix declarations map. If this annotation was not set, then an empty map will be returned. The returned map is immutable to preserve the general contract for notification on mutation.

setPrefixDecls

public void setPrefixDecls(Map<String,String> prefixDecls)

Description copied from interface: IPrefixDecls

Set the namespace prefix declarations map. This is a Map with String keys (prefix) and String values (the uri associated with that prefix).

Specified by:

setPrefixDecls in interface IPrefixDecls

toString

public String toString(int indent)

Description copied from class: GroupNodeBase

Simple but robust version of to-String

Specified by:

toString in interface BOp

Specified by:

toString in interface IQueryNode

Overrides:

toString in class GroupNodeBase<Update>

Returns:

getRequiredBound

public Set<IVariable<?>> getRequiredBound(StaticAnalysis sa)

Description copied from interface: IVariableBindingRequirements

Return the variables used in the node that *must* be bound prior to evaluating the node. For instance, when evaluation a SPARQL 1.1 service and the endpoint is specified through a variable, then this variable must be bound in order to identify the endpoint to which the query is to be sent. By *must* be bound we mean that, if it is possible to bring the variables in a join group in order such that they are bound when executing the construct (e.g., think of a FILTER), then we *must* consider that. However, when the IVariableBindingRequirements#getRequiredBound() interface cannot be satisified, the query may still be valid and return results (for the SPARQL 1.1 service example mentioned above, it may not, for the FILTER it may). The set of these variables must be disjoint from IVariableBindingRequirements#getRequiredUnound().

Specified by:

getRequiredBound in interface IVariableBindingRequirements

Returns:

the set of variables that must be bound prior to evaluation

getDesiredBound

public Set<IVariable<?>> getDesiredBound(StaticAnalysis sa)

Description copied from interface: IVariableBindingRequirements

Get variables that are not required to be bound, but desired in the sense that we want them to be bound when evaluating the construct. In general, the more variables are bound, the better, but this might differ for certain constructs. Should only report variables that are *not* reported through method IVariableBindingRequirements.getRequiredBound(StaticAnalysis).

Specified by:

getDesiredBound in interface IVariableBindingRequirements

Returns:

the set of variables that are desires to be bound, but not required