be.SIRAPRISE.typeimplementations

Class UNGROUP

java.lang.Object

be.SIRAPRISE.typeimplementations.RelationalOperator

be.SIRAPRISE.typeimplementations.UNGROUP

All Implemented Interfaces:

OperatorGenerator

@OperatorGeneratorCharacteristics(maximumArgumentCount=2,
                                  minimumArgumentCount=2,
                                  name="UNGROUP",
                                  signature={EXPRESSION,STRING})
 @MonoRelationOperator
public abstract class UNGROUP
extends RelationalOperator

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
UNGROUP()

Method Summary

Modifier and Type	Method and Description
static Relation	computeUngroup(Relation relation, NameIdentifier... ungroupAttributes)
static UNGROUP_RELATION	getInstance(Heading heading, java.util.Set<NameIdentifier> ungroupAttributes) Gets The operator implementation for the UNGROUP operation
OperatorImplementation_V0105	getOperatorImplementation(OperatorGeneratorArgument[] args) Gets an implementation instance of the operator.

Methods inherited from class be.SIRAPRISE.typeimplementations.RelationalOperator

getInvocationName, getMaximumArgumentCount, getMinimumArgumentCount, getName, getOperatorGeneratorSignature, isMonoRelationOperator, 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

getInstance

public static UNGROUP_RELATION getInstance(Heading heading,
                                           java.util.Set<NameIdentifier> ungroupAttributes)
                                    throws UnGroupAttributeIsNotRelationTypedException,
                                           UnGroupCausesDuplicateAttributeException,
                                           MultipleUngroupNotSupportedException,
                                           NonExistingAttributeException

Gets The operator implementation for the UNGROUP operation

Parameters:

heading - the heading of the input type

ungroupAttributes - The RVA attributes of the input to be ungrouped

Returns:

The operator implementation for the UNGROUP operation

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

NonExistingAttributeException - If an attribute is specified in ingroupAttributes that is not part of the heading

getOperatorImplementation

public final OperatorImplementation_V0105 getOperatorImplementation(OperatorGeneratorArgument[] args)
                                                             throws NotFoundException

Description copied from interface: OperatorGenerator

Gets an implementation instance of the operator.

Parameters:

args - The arguments from which the instance is to be created. There must be exactly as many arguments as there are elements in the list returned from OperatorGenerator.getOperatorGeneratorSignature(). The correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types is given in the table below :

correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types

OperatorGeneratorArgumentType value	OperatorGeneratorArgument type
EXPRESSION	NonScalarOperatorGeneratorExpressionArgument
EXPRESSIONWITHSCOPE	NonScalarOperatorGeneratorExpressionArgument
STRING	NonScalarOperatorGeneratorTextArgument

Returns:

an instance of the operator

Throws:

NotFoundException - If the given OperatorGeneratorArguments do not satisfy all of the rules of the OperatorGenerator. These rules are specific to each OperatorGenerator.