be.SIRAPRISE.ra

Class INTERSECT

java.lang.Object

be.SIRAPRISE.ra.RelationalOperator

be.SIRAPRISE.ra.INTERSECT

public abstract class INTERSECT
extends RelationalOperator

INTERSECT

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
INTERSECT()

Method Summary

Modifier and Type	Method and Description
static RelationBuffer	computeIntersect(RelationBuffer relationBuffer, RelationBuffer relationBuffer2)
static Relation	computeIntersect(Relation relation, Relation intersectWith)
static RelationBuffer	computeIntersectUsing(RelationBuffer relationBuffer, RelationBuffer relationBuffer2, java.util.Set<NameIdentifier> partitioningKeys, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations)
static IRelation	computeIntersectUsing(Relation relation, Relation intersectWith, 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 INTERSECTInvocationResultDetails	validateExpressionDetails(Heading heading1, Heading heading2, java.util.LinkedHashSet<NameIdentifier> usingAttributes, java.lang.String predicate1, java.lang.String predicate2, java.util.Collection<? extends KeyDef> arg1KeySpecifications, java.util.Collection<? extends KeyDef> arg2KeySpecifications)

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

INTERSECT

public INTERSECT()

Method Detail

computeIntersect

public static Relation computeIntersect(Relation relation,
                                        Relation intersectWith)
                                 throws EvaluationException

Parameters:

relation - a relation the intersection of which with another is to be computed

intersectWith - the other relation with which relation is to be intersected

Returns:

the result of intersecting both relations

Throws:

EvaluationException - If the evaluation fails for any reason. See the contained getCause() exception for more detail.

computeIntersect

public static RelationBuffer computeIntersect(RelationBuffer relationBuffer,
                                              RelationBuffer relationBuffer2)

Parameters:

relationBuffer - a relation buffer the intersection of which with another is to be computed

relationBuffer2 - the other relation buffer to be intersected with the former one

Returns:

a relation buffer holding all and exactly those tuples that appear in both relationbuffers given

computeIntersectUsing

public static IRelation computeIntersectUsing(Relation relation,
                                              Relation intersectWith,
                                              java.util.LinkedHashSet<NameIdentifier> usingAttributes)
                                       throws EvaluationException

Parameters:

relation - a relation the 'USING'-intersection of which with another is to be computed

intersectWith - the other relation with which relation is to be 'USING'-intersected

usingAttributes - The interval-typed attributes to be used in 'unpack'/'pointwise' modus.

Returns:

the result of 'USING'-intersecting both relations using the interval-typed attributes mentioned in usingAttributes in 'unpack'/'pointwise' modus.

Throws:

EvaluationException - If the evaluation fails for any reason. See the contained getCause() exception for more detail.

computeIntersectUsing

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

Parameters:

relationBuffer - a relation the 'USING'-intersection of which with another is to be computed

relationBuffer2 - the other relation with which relation is to be 'USING'-intersected

partitioningKeys - The set of attributes in the Heading that are not to be used in 'USING' modus

intervalTypedAttributesIntervalOperatorImplementations - the map of applicable interval-type operators for each of the attributes that are to be treated in 'USING' mode.

Returns:

the result of 'USING'-intersecting both relations using the interval-typed attributes mentioned in usingAttributes in 'unpack'/'pointwise' modus.

validateExpressionDetails

public static INTERSECTInvocationResultDetails validateExpressionDetails(Heading heading1,
                                                                         Heading heading2,
                                                                         java.util.LinkedHashSet<NameIdentifier> usingAttributes,
                                                                         java.lang.String predicate1,
                                                                         java.lang.String predicate2,
                                                                         java.util.Collection<? extends KeyDef> arg1KeySpecifications,
                                                                         java.util.Collection<? extends KeyDef> arg2KeySpecifications)
                                                                  throws IncompatibleJoinHeadingsException,
                                                                         AttributeNotIntervalTypedException,
                                                                         JoinUsingAttributeNotCommonBetweenArgumentsException

Parameters:

heading1 - The heading of the first argument

heading2 - The heading of the second argument

usingAttributes - The in-order set of names of attributes that are to be treated in 'using' mode during the intersection

predicate1 - The predicate of which the first argument is the extension

predicate2 - The predicate of which the second argument is the extension

arg1KeySpecifications - The key specifications known to be satisfied by the first argument

arg2KeySpecifications - The key specifications known to be satisfied by the second argument

Returns:

The technical details of the invocation

Throws:

IncompatibleJoinHeadingsException - If the headings are not intersection compatible

AttributeNotIntervalTypedException - If an attribute mentioned in usingAttributes is not interval-typed

JoinUsingAttributeNotCommonBetweenArgumentsException - If an attribute mentioned in the usingAttributes is not an attribute in both arguments

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