be.SIRAPRISE.typeimplementations

Class TCLOSE_RELATION

java.lang.Object

be.SIRAPRISE.typeimplementations.TCLOSE_RELATION

All Implemented Interfaces:

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

public final class TCLOSE_RELATION
extends java.lang.Object
implements OperatorImplementation_V0105

The relation UNPACK operator takes a single argument.

Author:

Erwin

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TCLOSE_RELATION(Heading heading, java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes, java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes) Creates the UNPACK_RELATION_RELATION

Method Summary

Modifier and Type	Method and Description
static java.util.Set<TupleBuffer>	computeTclose(MyReadOnlyCollection<TupleBuffer> r, java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes, java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes) Computes the closure in a straightforward way.
static RelationBuffer	computeTClose(RelationBuffer relationBuffer, java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes, java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes) Computes the closure.
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
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)
static TCLOSEInvocationResultDetails	validateExpressionDetails(Heading inputHeading, java.util.Map<NameIdentifier,NameIdentifier> matchby, java.lang.String inputPredicate)
void	writeExternal(java.io.ObjectOutput out)

Methods inherited from class java.lang.Object

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

Constructor Detail

TCLOSE_RELATION

public TCLOSE_RELATION(Heading heading,
                       java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes,
                       java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes)

Creates the UNPACK_RELATION_RELATION

Parameters:

heading - the heading that the UNPACK arguments conform to

closureLeftAttributes - The from-to mapping of the closure operation

closureRightAttributes - The to-from mapping of the closure operation

Method Detail

computeTclose

public static java.util.Set<TupleBuffer> computeTclose(MyReadOnlyCollection<TupleBuffer> r,
                                                       java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes,
                                                       java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes)

Computes the closure in a straightforward way. See inline comments for further details.

Parameters:

r - The relation of which a closure over some set of attributes is to be computed

closureLeftAttributes - The map mapping the 'from' attributes to the 'to' attributes.

closureRightAttributes - The map of attributes to be paired, having as key the 'to' attributename, with as corresponding value the name of the corresponding 'from' attribute.

Returns:

The computed closure

computeTClose

public static RelationBuffer computeTClose(RelationBuffer relationBuffer,
                                           java.util.Map<NameIdentifier,NameIdentifier> closureLeftAttributes,
                                           java.util.Map<NameIdentifier,NameIdentifier> closureRightAttributes)

Computes the closure.

Parameters:

relationBuffer - a buffer holding a relation to be subjected to a transitive closure operation

closureLeftAttributes - the mapping of which attributes match to which in determining pairs of tuples to apply the transitive operation to

closureRightAttributes - The "to-to-from" mapping of attributes to perform the closure over

Returns:

The result of applying the specified transitive closure to the given relation

validateExpressionDetails

public static TCLOSEInvocationResultDetails validateExpressionDetails(Heading inputHeading,
                                                                      java.util.Map<NameIdentifier,NameIdentifier> matchby,
                                                                      java.lang.String inputPredicate)
                                                               throws DuplicateClosureAttributeException,
                                                                      ClosureAttributesOmittedException,
                                                                      NonExistingAttributeException,
                                                                      IncompatibleClosureTypesException

Parameters:

inputHeading - The heading of the relation that is subjected to a transitive closure operation

matchby - The specification of which attributes to compare to which when establishing pairs of tuples that are to be subjected to the transitive operation

inputPredicate - The relation predicate of which the input relation is the extension

Returns:

The details about the result of the invocation

Throws:

DuplicateClosureAttributeException - If an attribute is mentioned more than once in the matchby specification

ClosureAttributesOmittedException - If not all attributes of the input relation have been mentioned for matching in the matchby spec

NonExistingAttributeException - If an attribute is mentioned in the matchby spec that doesn't appear in the heading

IncompatibleClosureTypesException - If two attributes to be compared pairwise in the closure operation have incompatible types

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

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