be.SIRAPRISE.typeimplementations

Class UNIONUSING_RELATION_RELATION

java.lang.Object

be.SIRAPRISE.typeimplementations.UNIONUSING_RELATION_RELATION

All Implemented Interfaces:

AggregationOperatorImplementation, OperatorImplementation_V0104, OperatorImplementation_V0105, java.io.Externalizable, java.io.Serializable

public final class UNIONUSING_RELATION_RELATION
extends java.lang.Object
implements AggregationOperatorImplementation

The relation UNION operator takes two arguments, both of a relation type. Both relation types must be the same. A third argument specifies the set of attributes that are to be treated in "range" mode when computing.

Some examples of "temporal" UNION invocations and their result

r1	r2	i	result
REL { TUP {IV:[1-7]} }	REL { TUP {IV:[5-9]} }		REL { TUP {IV:[1-7]} TUP {IV:[5-9]} }
REL { TUP {IV:[1-7]} }	REL { TUP {IV:[5-9]} }	IV	REL { TUP {IV:[1-9]} }

Author:

Erwin

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description

UNIONUSING_RELATION_RELATION(Heading heading, java.util.LinkedList<NameIdentifier> treatAsRange, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations) Creates the UNION_RELATION_RELATION_STRING

Method Summary

Modifier and Type	Method and Description
static java.util.Collection<TupleBuffer>	computeRangeUnionAndPack(java.util.Collection<TupleBuffer> r1, java.util.Collection<TupleBuffer> r2, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations, java.util.Set<NameIdentifier> partitioningKeys) Computes the interval union of the given tuple sets.
static java.util.Collection<TupleBuffer>	computeRangeUnionAndPack(java.util.Collection<TupleBuffer> r1, java.util.Collection<TupleBuffer> r2, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations, java.util.Set<NameIdentifier> partitioningKeys, java.util.LinkedList<ValueBuffer> wrkArgList) Computes the interval union of the given tuple sets.
static java.util.Set<TupleBuffer>	computeRangeUnionForSamePartitionRelationsAndPack(java.util.Collection<? extends TupleBuffer> r1, java.util.Collection<? extends TupleBuffer> r2, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations) Computes the interval union of the given tuple sets.
static java.util.Set<TupleBuffer>	computeRangeUnionForSamePartitionRelationsAndPack(java.util.Collection<? extends TupleBuffer> r1, java.util.Collection<? extends TupleBuffer> r2, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementations, java.util.LinkedList<ValueBuffer> wrkArgList) Computes the interval union of the given tuple sets.
ValueBuffer	executeOperator(java.util.LinkedList<ValueBuffer> args) Performs the actual logic of the operator.
java.lang.String[]	getArgumentTypeNames() Gets the list of names of types of the needed argument values
ValueBuffer	getIdentityElement() Gets the identity element of the operator in its domain.
TypeDeclaration	getReturnTypeDeclaration() Gets the full type declaration of the type of the return value.
java.lang.String	getReturnTypeName() Gets the name of the type of the return value
java.lang.String	getSignature() Gets the name of the operator implemented by this implementation object
boolean	isDeterministic() Tells whether the operator is deterministic with respect to the arguments of its invocations.
void	readExternal(java.io.ObjectInput in)
void	writeExternal(java.io.ObjectOutput out)

Methods inherited from class java.lang.Object

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

Constructor Detail

UNIONUSING_RELATION_RELATION

public UNIONUSING_RELATION_RELATION(Heading heading,
                                    java.util.LinkedList<NameIdentifier> treatAsRange,
                                    MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                    java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations)

Creates the UNION_RELATION_RELATION_STRING

Parameters:

heading - the heading that the arguments of the UNIONUSING conform to

treatAsRange - The in-order list of attributes to be treated in 'USING' mode by the UNION

intervalTypedAttributesIntervalOperatorImplementations - A map mapping the attribute names to a corresponding collection of interval operators (this collection takes itself the form of a mapping from operator names to interval operator implementations). The map is required to hold at least the OPERATORNAMES.SPLITBY, OPERATORNAMES.IMINUS, OPERATORNAMES.IINTERSECT and OPERATORNAMES.ISEMPTYINTERVAL implementations for each attribute.

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.

Method Detail

computeRangeUnionAndPack

public static java.util.Collection<TupleBuffer> computeRangeUnionAndPack(java.util.Collection<TupleBuffer> r1,
                                                                         java.util.Collection<TupleBuffer> r2,
                                                                         MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                                         java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations,
                                                                         java.util.Set<NameIdentifier> partitioningKeys)

Computes the interval union of the given tuple sets.

Parameters:

r1 - The first argument

r2 - The second argument

intervalTypedAttributesIntervalOperatorImplementations - A map mapping the attribute names to a corresponding collection of interval operators (this collection takes itself the form of a mapping from operator names to interval operator implementations). The map is required to hold at least the OPERATORNAMES.SPLITBY, OPERATORNAMES.IMINUS, OPERATORNAMES.IINTERSECT and OPERATORNAMES.ISEMPTYINTERVAL implementations for each attribute.

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.

partitioningKeys - The partitioning keys

Returns:

the canonicalized union of the tuples in the arguments

computeRangeUnionAndPack

public static java.util.Collection<TupleBuffer> computeRangeUnionAndPack(java.util.Collection<TupleBuffer> r1,
                                                                         java.util.Collection<TupleBuffer> r2,
                                                                         MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                                         java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations,
                                                                         java.util.Set<NameIdentifier> partitioningKeys,
                                                                         java.util.LinkedList<ValueBuffer> wrkArgList)

Computes the interval union of the given tuple sets.

Parameters:

r1 - The first argument

r2 - The second argument

intervalTypedAttributesIntervalOperatorImplementations - A map mapping the attribute names to a corresponding collection of interval operators (this collection takes itself the form of a mapping from operator names to interval operator implementations). The map is required to hold at least the OPERATORNAMES.SPLITBY, OPERATORNAMES.IMINUS, OPERATORNAMES.IINTERSECT and OPERATORNAMES.ISEMPTYINTERVAL implementations for each attribute.

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.

partitioningKeys - The partitioning keys

wrkArgList - A linkedlist that can be used as a working object when invoking the interval operators

Returns:

the canonicalized union of the tuples in the arguments

computeRangeUnionForSamePartitionRelationsAndPack

public static java.util.Set<TupleBuffer> computeRangeUnionForSamePartitionRelationsAndPack(java.util.Collection<? extends TupleBuffer> r1,
                                                                                           java.util.Collection<? extends TupleBuffer> r2,
                                                                                           MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                                                           java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations)

Computes the interval union of the given tuple sets. The precondition for this method is that all non-interval-typed attributes in the tuples must have the same value all over both relations. This condition is not checked.

Parameters:

r1 - The first argument

r2 - The second argument

intervalTypedAttributesIntervalOperatorImplementations - A map mapping the attribute names to a corresponding collection of interval operators (this collection takes itself the form of a mapping from operator names to interval operator implementations). The map is required to hold at least the SPLITBY, IMINUS, IINTERSECT and ISEMPTYINTERVAL implementations for each attribute.

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 canonicalized union of the tuples in the arguments

computeRangeUnionForSamePartitionRelationsAndPack

public static java.util.Set<TupleBuffer> computeRangeUnionForSamePartitionRelationsAndPack(java.util.Collection<? extends TupleBuffer> r1,
                                                                                           java.util.Collection<? extends TupleBuffer> r2,
                                                                                           MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                                                           java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementations,
                                                                                           java.util.LinkedList<ValueBuffer> wrkArgList)

Computes the interval union of the given tuple sets. The precondition for this method is that all non-interval-typed attributes in the tuples must have the same value all over both relations. This condition is not checked.

Parameters:

r1 - The first argument

r2 - The second argument

intervalTypedAttributesIntervalOperatorImplementations - A map mapping the attribute names to a corresponding collection of interval operators (this collection takes itself the form of a mapping from operator names to interval operator implementations). The map is required to hold at least the OPERATORNAMES.SPLITBY, OPERATORNAMES.IMINUS, OPERATORNAMES.IINTERSECT and OPERATORNAMES.ISEMPTYINTERVAL implementations for each attribute.

attributeIntervalTypeImplementations - 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.

wrkArgList - A linkedlist that can be used as a working object when invoking the interval operators

Returns:

the canonicalized union of the tuples in the arguments

executeOperator

public ValueBuffer executeOperator(java.util.LinkedList<ValueBuffer> args)

Description copied from interface: OperatorImplementation_V0104

Performs the actual logic of the operator.

Specified by:

executeOperator in interface OperatorImplementation_V0104

Parameters:

args - the argument list. The list must hold as many ValueBuffer objects as there are arguments to the operator, and each ValueBuffer object holds a value for some argument to the operator. ValueBuffer objects on the list must appear in the same order as the operator argument declarations. Implementations have the option, but are not required, to do a check the conformance of the argument list (the argument count, notably) to the operator signature.

Returns:

A ValueBuffer object holding the result value of the operator execution in internal format.

getArgumentTypeNames

public java.lang.String[] getArgumentTypeNames()

Description copied from interface: OperatorImplementation_V0104

Gets the list of names of types of the needed argument values

Specified by:

getArgumentTypeNames in interface OperatorImplementation_V0104

Returns:

The names of the argument types

getIdentityElement

public ValueBuffer getIdentityElement()

Description copied from interface: AggregationOperatorImplementation

Gets the identity element of the operator in its domain.

Specified by:

getIdentityElement in interface AggregationOperatorImplementation

Returns:

The identity element.

getReturnTypeDeclaration

public TypeDeclaration getReturnTypeDeclaration()

Description copied from interface: OperatorImplementation_V0105

Gets the full type declaration of the type of the return value. Differs from the _V0104 getReturnTypeName() in that for nonscalar return types, this method also returns the heading, not just only the RELATION or TUPLE typename.

Specified by:

getReturnTypeDeclaration in interface OperatorImplementation_V0105

Returns:

the full type declaration of the type of the return value

getReturnTypeName

public java.lang.String getReturnTypeName()

Description copied from interface: OperatorImplementation_V0104

Gets the name of the type of the return value

Specified by:

getReturnTypeName in interface OperatorImplementation_V0104

Returns:

the name of the type of the return value

getSignature

public java.lang.String getSignature()

Description copied from interface: OperatorImplementation_V0104

Gets the name of the operator implemented by this implementation object

Specified by:

getSignature in interface OperatorImplementation_V0104

Returns:

the name of the operator implemented by this implementation object

isDeterministic

public boolean isDeterministic()

Description copied from interface: OperatorImplementation_V0104

Tells whether the operator is deterministic with respect to the arguments of its invocations. An operator is deterministic if and only if for any two distinct invocations, if all the argument values are the same, then the result value returned will also be the same. An example of a nondeterministic operators is RANDOM().

Specified by:

isDeterministic in interface OperatorImplementation_V0104

Returns:

true if the operator is deterministic.

readExternal

public void readExternal(java.io.ObjectInput in)

Specified by:

readExternal in interface java.io.Externalizable

writeExternal

public void writeExternal(java.io.ObjectOutput out)

Specified by:

writeExternal in interface java.io.Externalizable