be.SIRAPRISE.ra

Class TCLOSE

java.lang.Object

be.SIRAPRISE.ra.RelationalOperator

be.SIRAPRISE.ra.TCLOSE

public abstract class TCLOSE
extends RelationalOperator

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
TCLOSE()

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.
static Relation	computeTClose(Relation relation, java.util.Map<NameIdentifier,NameIdentifier> matchby) Computes the closure.
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 TCLOSEInvocationResultDetails	validateExpressionDetails(Heading inputHeading, java.util.Map<NameIdentifier,NameIdentifier> matchby, java.lang.String inputPredicate)

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

TCLOSE

public TCLOSE()

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 Relation computeTClose(Relation relation,
                                     java.util.Map<NameIdentifier,NameIdentifier> matchby)
                              throws EvaluationException

Computes the closure.

Parameters:

relation - a relation to be subjected to a transitive closure operation

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

Returns:

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

Throws:

EvaluationException - If an invalid invocation was attempted. The getCause() exception will reveal more detail about the nature of the problem.

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

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