be.SIRAPRISE.typeimplementations

Class UNION

java.lang.Object

be.SIRAPRISE.typeimplementations.RelationalOperator

be.SIRAPRISE.typeimplementations.UNION

All Implemented Interfaces:

OperatorGenerator

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

UNION

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
UNION()

Method Summary

Modifier and Type	Method and Description
static RelationBuffer	computePlainUnion(RelationBuffer relationBuffer, RelationBuffer relationBuffer2)
static Relation	computePlainUnion(Relation relation, Relation unionWith)
static RelationBuffer	computeUsingUnion(RelationBuffer relationBuffer, RelationBuffer relationBuffer2, java.util.Set<NameIdentifier> partitioningKeys, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations)
static Relation	computeUsingUnion(Relation relation, Relation unionWith, java.util.LinkedHashSet<NameIdentifier> usingAttributes)
static AggregationOperatorImplementation	getInstance(Heading heading) Gets an instance of the relation UNION operator for the particular given heading
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

UNION

public UNION()

Method Detail

computePlainUnion

public static Relation computePlainUnion(Relation relation,
                                         Relation unionWith)
                                  throws EvaluationException

Parameters:

relation - the relation to be unioned with the other one

unionWith - the relation to be unioned with the foregoing one

Returns:

the result of unioning the two relations

Throws:

EvaluationException - if the evaluation fails for any reason, e.g. the relations are not union-compatible

computePlainUnion

public static RelationBuffer computePlainUnion(RelationBuffer relationBuffer,
                                               RelationBuffer relationBuffer2)

Parameters:

relationBuffer - the relation to be unioned with the other one

relationBuffer2 - the relation to be unioned with the foregoing one

Returns:

the result of unioning the two relations

computeUsingUnion

public static Relation computeUsingUnion(Relation relation,
                                         Relation unionWith,
                                         java.util.LinkedHashSet<NameIdentifier> usingAttributes)
                                  throws EvaluationException

Parameters:

relation - the relation to be unioned with the other one

unionWith - the relation to be unioned with the foregoing one

usingAttributes - the in-order set of attributes to be treated in 'USING' mode by the union

Returns:

the result of unioning the two relations

Throws:

EvaluationException - if the evaluation fails for any reason, e.g. the relations are not union-compatible

computeUsingUnion

public static RelationBuffer computeUsingUnion(RelationBuffer relationBuffer,
                                               RelationBuffer relationBuffer2,
                                               java.util.Set<NameIdentifier> partitioningKeys,
                                               MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                               java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations)

Parameters:

relationBuffer - the relation to be unioned with the other one

relationBuffer2 - the relation to be unioned with the foregoing one

partitioningKeys - the set of attributes not to be used in 'USING' mode by the union

intervalTypedAttributesIntervalOperatorImplementations - the mapping of the names of attributes to be treated in 'USING' mode by the union, mapped to the sets of applicable interval operators for those attributes' types.

intervalTypedAttributesIntervalTypeImplementations - A map mapping the interval-typed attribute names to their type implementations. The keySet() of this map must be equal to the keySet() of the intervalTypedAttributesIntervalOperatorImplementations Map.

Returns:

the result of unioning the two relations

getInstance

public static AggregationOperatorImplementation getInstance(Heading heading)

Gets an instance of the relation UNION operator for the particular given heading

Parameters:

heading - The heading defining the relation type of both arguments

Returns:

An instance of the relation UNION operator for the particular given 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.