com.bigdata.rdf.sparql.ast

Class GroupNodeBase<E extends IGroupMemberNode>

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

All Implemented Interfaces:

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

Direct Known Subclasses:

AbstractStatementContainer, GraphPatternGroup, UpdateRoot

public abstract class GroupNodeBase<E extends IGroupMemberNode>
extends GroupMemberNodeBase<E>
implements IGroupNode<E>

Base class for AST group nodes.

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

Modifier	Constructor and Description
protected	GroupNodeBase()
	GroupNodeBase(BOp[] args, Map<String,Object> anns) Required shallow copy constructor.
	GroupNodeBase(GroupNodeBase<E> op) Constructor required for com.bigdata.bop.BOpUtility#deepCopy(FilterNode).

Method Summary

Methods

Modifier and Type	Method and Description
void	addArg(BOp newArg) Add a new argument (core mutation method).
void	addArg(int index, BOp newArg) Add a new argument (core mutation method) at the specified index.
IGroupNode<E>	addChild(E child) Add a child to this group.
GroupNodeBase<E>	clone() Deep copy clone semantics.
List<FilterNode>	getAttachedJoinFilters()
List<E>	getChildren()
boolean	isEmpty() Return true iff the group is empty.
Iterator<E>	iterator()
boolean	removeArg(BOp child) Remove the 1st occurrence of the argument (core mutation method).
IGroupNode<E>	removeChild(E child) Remove a child from this group.
int	replaceWith(BOp oldChild, BOp newChild) Replace a child of a node with another reference (destructive modification).
ModifiableBOpBase	setArg(int index, BOp newArg) Replace the value of the argument at the specified index (core mutation method).
void	setAttachedJoinFilters(List<FilterNode> filters)
int	size() Return the #of children which are direct members of the group.
String	toString(int indent) Simple but robust version of to-String

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

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

getDesiredBound, getRequiredBound

Constructor Detail

GroupNodeBase

public GroupNodeBase(GroupNodeBase<E> op)

Constructor required for com.bigdata.bop.BOpUtility#deepCopy(FilterNode).

GroupNodeBase

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

Required shallow copy constructor.

GroupNodeBase

protected GroupNodeBase()

Method Detail

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Iterable<E extends IGroupMemberNode>

getChildren

public List<E> getChildren()

setArg

public ModifiableBOpBase setArg(int index,
                       BOp newArg)

Replace the value of the argument at the specified index (core mutation method).

Overridden to set the parent reference on the child.

Overrides:

setArg in class ModifiableBOpBase

Parameters:

index - The index of the child expression to be replaced.

newArg - The new child expression.

Returns:

This ModifiableBOpBase.

addArg

public void addArg(BOp newArg)

Add a new argument (core mutation method).

Overridden to set the parent reference on the child

Overrides:

addArg in class ModifiableBOpBase

Parameters:

newArg - The argument.

addArg

public void addArg(int index,
          BOp newArg)

Add a new argument (core mutation method) at the specified index.

Overridden to set the parent reference on the child

Overrides:

addArg in class ModifiableBOpBase

Parameters:

index - The index at which the child expression is to be inserted.

newArg - The argument.

removeArg

public boolean removeArg(BOp child)

Remove the 1st occurrence of the argument (core mutation method).

Overridden to clear the parent reference on the child.

Overrides:

removeArg in class ModifiableBOpBase

Parameters:

child - The argument.

Returns:

true iff the argument was removed.

addChild

public IGroupNode<E> addChild(E child)

Description copied from interface: IGroupNode

Add a child to this group. Child can be a statement pattern, a filter, or another group.

Specified by:

addChild in interface IGroupNode<E extends IGroupMemberNode>

Returns:

this

removeChild

public IGroupNode<E> removeChild(E child)

Description copied from interface: IGroupNode

Remove a child from this group.

Specified by:

removeChild in interface IGroupNode<E extends IGroupMemberNode>

Returns:

this

isEmpty

public boolean isEmpty()

Description copied from interface: IGroupNode

Return true iff the group is empty.

Specified by:

isEmpty in interface IGroupNode<E extends IGroupMemberNode>

size

public int size()

Description copied from interface: IGroupNode

Return the #of children which are direct members of the group.

Specified by:

size in interface IGroupNode<E extends IGroupMemberNode>

getAttachedJoinFilters

public final List<FilterNode> getAttachedJoinFilters()

setAttachedJoinFilters

public final void setAttachedJoinFilters(List<FilterNode> filters)

clone

public GroupNodeBase<E> clone()

Deep copy clone semantics.

Deep copy clone of the operator.

Overridden to also clone the children and then set the parent reference on the cloned children.

Specified by:

clone in interface BOp

Overrides:

clone in class CoreBaseBOp

toString

public String toString(int indent)

Simple but robust version of to-String

Specified by:

toString in interface BOp

Specified by:

toString in interface IQueryNode

Overrides:

toString in class CoreBaseBOp

Returns:

replaceWith

public int replaceWith(BOp oldChild,
              BOp newChild)

Replace a child of a node with another reference (destructive modification). All arguments which point to the oldChild will be replaced by references to the newChild.

Overridden to set the parent reference on the new child and clear the parent reference on the old child.

Overrides:

replaceWith in class ModifiableBOpBase

Returns:

The #of references which were replaced.