be.SIRAPRISE.ra

Class UNION

java.lang.Object

be.SIRAPRISE.ra.RelationalOperator

be.SIRAPRISE.ra.UNION

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)
static Relation	computeUsingUnion(Relation relation, Relation unionWith, java.util.LinkedHashSet<NameIdentifier> usingAttributes)
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 UNIONInvocationResultDetails	validateExpressionDetails(Heading heading1, Heading heading2, java.lang.String relationPredicate1, java.lang.String relationPredicate2, java.util.LinkedHashSet<NameIdentifier> usingAttributes)

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

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)

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.

Returns:

the result of unioning the two relations

validateExpressionDetails

public static UNIONInvocationResultDetails validateExpressionDetails(Heading heading1,
                                                                     Heading heading2,
                                                                     java.lang.String relationPredicate1,
                                                                     java.lang.String relationPredicate2,
                                                                     java.util.LinkedHashSet<NameIdentifier> usingAttributes)
                                                              throws UnionHeadingsIncompatibleException,
                                                                     AttributeNotIntervalTypedException,
                                                                     NonExistingAttributeException

Parameters:

heading1 - the heading of the first argument in a union

heading2 - the heading of the second argument in a union

relationPredicate2 - The relation predicate of the second argument in a union

relationPredicate1 - The relation predicate of the first argument in a union

usingAttributes - The names of the interval-typed attributes in the union to be treated in 'USING' mode (empty set for 'plain' unions)

Returns:

Info about the result of a union invocation

Throws:

UnionHeadingsIncompatibleException - if the given headings are not union compatible

AttributeNotIntervalTypedException - If an attribute named in the usingAttributes list is not interval-typed

NonExistingAttributeException - If usingAttributes contains an attribute name that does not appear in the heading

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