be.SIRAPRISE.ra

Class UNGROUP

java.lang.Object

be.SIRAPRISE.ra.RelationalOperator

be.SIRAPRISE.ra.UNGROUP

public abstract class UNGROUP
extends RelationalOperator

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
UNGROUP()

Method Summary

Modifier and Type	Method and Description
static RelationBuffer	computeUngroup(RelationBuffer relationBuffer, java.util.Map<NameIdentifier,TypeDeclaration> ungroupAttributes)
static Relation	computeUngroup(Relation relation, NameIdentifier... ungroupAttributes)
int	getMaximumArgumentCount() Gets the maximum argument count for this operator.
int	getMinimumArgumentCount() Gets the minimum argument count for this operator.
java.lang.String	getName() Gets the operator name
boolean	isMonoRelationOperator() Checks if the operator takes only one Relation as input
static UNGROUPInvocationResultDetails	validateExpressionDetails(Heading heading, java.util.Set<NameIdentifier> ungroupAttributes, java.lang.String inputPredicate, java.util.Collection<? extends KeyDef> inputKeySpecifications)

Methods inherited from class be.SIRAPRISE.ra.RelationalOperator

toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UNGROUP

public UNGROUP()

Method Detail

computeUngroup

public static Relation computeUngroup(Relation relation,
                                      NameIdentifier... ungroupAttributes)
                               throws EvaluationException

Parameters:

relation - the relation to be ungrouped according to the specs in ungroupAttributes

ungroupAttributes - the list of relation-typed attributes to be ungrouped in the result

Returns:

the result of ungrouping the given relation over the given relation-typed ungroupAttributes

Throws:

EvaluationException - if the given relation and ungroup specs are incompatible

computeUngroup

public static RelationBuffer computeUngroup(RelationBuffer relationBuffer,
                                            java.util.Map<NameIdentifier,TypeDeclaration> ungroupAttributes)

Parameters:

relationBuffer - the relationBuffer holding the body/tuples to be ungrouped according to the specs in ungroupAttributes

ungroupAttributes - the list of relation-typed attributes to be ungrouped in the result, mapped to their (nonscalar) typedeclaration in the heading of the input relation. This map must contain ONLY the ungroup attributes.

Returns:

the result of ungrouping the given relation over the given relation-typed ungroupAttributes

validateExpressionDetails

public static UNGROUPInvocationResultDetails validateExpressionDetails(Heading heading,
                                                                       java.util.Set<NameIdentifier> ungroupAttributes,
                                                                       java.lang.String inputPredicate,
                                                                       java.util.Collection<? extends KeyDef> inputKeySpecifications)
                                                                throws UnGroupAttributeIsNotRelationTypedException,
                                                                       UnGroupCausesDuplicateAttributeException,
                                                                       MultipleUngroupNotSupportedException

Parameters:

heading - the heading of the relation to be ungrouped according to the specs in ungroupAttributes

ungroupAttributes - the list of relation-typed attributes to be ungrouped in the result

inputPredicate - The predicate of the input expression. If unknown, use the empty string.

inputKeySpecifications - The key specifications of the input expression. If unknown, an empty collection can be passed and the input will then be assumed to be all-key.

Returns:

The heading of the result of doing the specified ungroup

Throws:

UnGroupAttributeIsNotRelationTypedException - if a non-relation-typed attribute is specified among the ungroupAttributes

UnGroupCausesDuplicateAttributeException - if an attribute of a relation-typed attribute to be ungrouped also appears in the heading of the relation to be ungrouped itself

MultipleUngroupNotSupportedException - if the ungroupAttributes contain more than one attribute

getMaximumArgumentCount

public final int getMaximumArgumentCount()

Description copied from class: RelationalOperator

Gets the maximum argument count for this operator. Note that stuff like rename lists are regarded as an argument as far as this count is concerned

Specified by:

getMaximumArgumentCount in class RelationalOperator

Returns:

the maximum argument count for this operator.

getMinimumArgumentCount

public final int getMinimumArgumentCount()

Description copied from class: RelationalOperator

Gets the minimum argument count for this operator. Note that stuff like rename lists are regarded as an argument as far as this count is concerned

Specified by:

getMinimumArgumentCount in class RelationalOperator

Returns:

the minimum argument count for this operator

getName

public final java.lang.String getName()

Description copied from class: RelationalOperator

Gets the operator name

Specified by:

getName in class RelationalOperator

Returns:

the operator name

isMonoRelationOperator

public final boolean isMonoRelationOperator()

Description copied from class: RelationalOperator

Checks if the operator takes only one Relation as input

Specified by:

isMonoRelationOperator in class RelationalOperator

Returns:

true if the operator takes only one Relation as input