be.SIRAPRISE.typeimplementations

Class PACK_RELATION_STRING

java.lang.Object

be.SIRAPRISE.typeimplementations.PACK_RELATION_STRING

public abstract class PACK_RELATION_STRING
extends java.lang.Object

Class providing a utility method to perform PACK()ing on relations. Some future versions will hold a full-blown implementation of the "temporal" PACK operator.

Author:

Erwin

Constructor Summary

Constructors

Constructor and Description
PACK_RELATION_STRING()

Method Summary

Modifier and Type	Method and Description
static RelationBuffer	computePack(RelationBuffer relationBuffer, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> attributeIntervalOperatorImplementationsMap, java.util.Set<NameIdentifier> partitioningKeys, java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementationsMap) Gets A relationBuffer holding the result of the packing
static java.util.Set<TupleBuffer>	packPartition(java.util.Collection<TupleBuffer> in, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementations) Packs the given collection of tuplebuffers by merging the mergeable tuples.
static java.util.Set<TupleBuffer>	packPartitionOld(java.util.Collection<TupleBuffer> in, MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations, java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations) Packs the given collection of tuplebuffers by merging the mergeable tuples.
static PACKInvocationResultDetails	validateExpressionDetails(Heading inputHeading, java.util.LinkedHashSet<NameIdentifier> packAttributeNames, java.lang.String inputPredicate, java.util.Collection<? extends KeyDef> inputKeySpecifications)

Methods inherited from class java.lang.Object

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

Constructor Detail

PACK_RELATION_STRING

public PACK_RELATION_STRING()

Method Detail

packPartition

public static java.util.Set<TupleBuffer> packPartition(java.util.Collection<TupleBuffer> in,
                                                       MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                       java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementations)

Packs the given collection of tuplebuffers by merging the mergeable tuples.

Parameters:

in - The collection of tuplebuffers to be canonicalized over the given set of interval-typed attributes. The precondition for this argument is that all tuplebuffers held in the collection hold equal attribute values for all the attributes not mentioned in (as a key in) intervalTypedAttributesIntervalOperatorImplementations. This precondition is not checked.

intervalTypedAttributesIntervalOperatorImplementations - The map holding the OperatorImplementation objects for all of the interval-typed attributes, through which the needed interval operators can be accessed

attributeIntervalTypeImplementations - The map holding the IntervalTypeImplementation objects for all of the interval-typed attributes, through which the needed interval operators can be accessed

Returns:

The canonicalized relation partition

packPartitionOld

public static java.util.Set<TupleBuffer> packPartitionOld(java.util.Collection<TupleBuffer> in,
                                                          MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> intervalTypedAttributesIntervalOperatorImplementations,
                                                          java.util.Map<NameIdentifier,IntervalTypeImplementation> intervalTypedAttributesIntervalTypeImplementations)

Packs the given collection of tuplebuffers by merging the mergeable tuples.

Parameters:

in - The collection of tuplebuffers to be canonicalized over the given set of interval-typed attributes. The precondition for this argument is that all tuplebuffers held in the collection hold equal attribute values for all the attributes not mentioned in (as a key in) intervalTypedAttributesIntervalOperatorImplementations. This precondition is not checked.

intervalTypedAttributesIntervalOperatorImplementations - The map holding the Interval Type objects for all of the interval-typed attributes, through which the needed interval operators can be accessed

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 relation partition

computePack

public static RelationBuffer computePack(RelationBuffer relationBuffer,
                                         MyReadOnlyLinkedHashMap<NameIdentifier,java.util.Map<java.lang.String,OperatorImplementation_V0104>> attributeIntervalOperatorImplementationsMap,
                                         java.util.Set<NameIdentifier> partitioningKeys,
                                         java.util.Map<NameIdentifier,IntervalTypeImplementation> attributeIntervalTypeImplementationsMap)

Gets A relationBuffer holding the result of the packing

Parameters:

relationBuffer - The buffer holding the relation to be packed

attributeIntervalOperatorImplementationsMap - The pack attributes' interval operator implementations map. The map's keySet() reflects the ordering of the pack attributes

partitioningKeys - The partitioning keys, i.e. all the attributes of the relation that do not appear in the pack() specification

attributeIntervalTypeImplementationsMap - The map holding the IntervalTypeImplementation objects for all of the interval-typed attributes, through which the needed interval operators can be accessed

Returns:

A relationBuffer holding the result of the packing

validateExpressionDetails

public static PACKInvocationResultDetails validateExpressionDetails(Heading inputHeading,
                                                                    java.util.LinkedHashSet<NameIdentifier> packAttributeNames,
                                                                    java.lang.String inputPredicate,
                                                                    java.util.Collection<? extends KeyDef> inputKeySpecifications)
                                                             throws AttributeNotIntervalTypedException,
                                                                    NonExistingAttributeException

Parameters:

inputHeading - the heading of a relation subjected to a PACK operation

packAttributeNames - the attributes using which to PACK the given relation

inputPredicate - the predicate of which the relation subjected to PACK is the extension

inputKeySpecifications - the key specifications known to be satisfied by the relation subjected to PACK

Returns:

The technical details about the invocation

Throws:

AttributeNotIntervalTypedException - If an attribute mentioned in the pack list is not interval-typed in the given heading

NonExistingAttributeException - If an attribute name is mentioned in the pack list that does not appear in the heading