com.bigdata.rdf.sparql.ast

Class AbstractFromToGraphManagement

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<IGroupMemberNode>

com.bigdata.rdf.sparql.ast.Update

com.bigdata.rdf.sparql.ast.GraphManagement

com.bigdata.rdf.sparql.ast.AbstractFromToGraphManagement

All Implemented Interfaces:

BOp, IGroupMemberNode, IQueryNode, IVariableBindingRequirements, IPropertySet, Serializable, Cloneable

Direct Known Subclasses:

AddGraph, CopyGraph, MoveGraph

public abstract class AbstractFromToGraphManagement
extends GraphManagement

Any of the operations which has a FROM and/or TO graph.

Version:

$Id$

Author:

Bryan Thompson

See Also:

Serialized Form

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
AbstractFromToGraphManagement(AbstractFromToGraphManagement op)
AbstractFromToGraphManagement(BOp[] args, Map<String,Object> anns)
AbstractFromToGraphManagement(UpdateType updateType)

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.
Set<IVariable<?>>	getRequiredBound(StaticAnalysis sa) Return the variables used in the node that *must* be bound prior to evaluating the node.
ConstantNode	getSourceGraph() The ConstantNode for the source graph (for operations which have this concept).
ConstantNode	getTargetGraph() The ConstantNode for the target graph (for operations which have this concept).
boolean	isSourceDefault() Return true iff the source is the "default graph".
boolean	isTargetDefault() Return true iff the target is the "default graph".
void	setSourceGraph(ConstantNode sourceGraph)
void	setTargetGraph(ConstantNode targetGraph)
String	toString(int indent) The contract of this method at this level is under-specified.

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

isSilent, setSilent

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

getDatasetClauses, getUpdateType, setDatasetClauses

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.bigdata.bop.BOp

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

Methods inherited from interface cutthecrap.utils.striterators.IPropertySet

getProperty

Constructor Detail

AbstractFromToGraphManagement

public AbstractFromToGraphManagement(UpdateType updateType)

AbstractFromToGraphManagement

public AbstractFromToGraphManagement(AbstractFromToGraphManagement op)

Parameters:

op -

AbstractFromToGraphManagement

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

Parameters:

args -

anns -

Method Detail

getSourceGraph

public ConstantNode getSourceGraph()

The ConstantNode for the source graph (for operations which have this concept).

Overrides:

getSourceGraph in class Update

Returns:

The source graph -or- null if the source is the "default" graph.

setSourceGraph

public void setSourceGraph(ConstantNode sourceGraph)

Overrides:

setSourceGraph in class Update

getTargetGraph

public final ConstantNode getTargetGraph()

The ConstantNode for the target graph (for operations which have this concept). If there is only one graph on which the operation will have an effect, then it is modeled by this annotation.

Overrides:

getTargetGraph in class Update

Returns:

The target graph -or- null if the target is the "default" graph.

setTargetGraph

public final void setTargetGraph(ConstantNode targetGraph)

Overrides:

setTargetGraph in class Update

isTargetDefault

public final boolean isTargetDefault()

Return true iff the target is the "default graph".

isSourceDefault

public final boolean isSourceDefault()

Return true iff the source is the "default graph".

toString

public final String toString(int indent)

Description copied from class: CoreBaseBOp

The contract of this method at this level is under-specified. Sub-classes may choose between: - return a string representation of the object, similar to the use of CoreBaseBOp.toString() Or: - return a pretty-print representation of the object with indent Note that the former contract may or may not include recursive descent through a tree-like object, whereas the latter almost certainly does.

Specified by:

toString in interface BOp

Specified by:

toString in interface IQueryNode

Overrides:

toString in class CoreBaseBOp

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

Overrides:

getRequiredBound in class GraphManagement

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

Overrides:

getDesiredBound in class GraphManagement

Returns:

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