be.SIRAPRISE.typeimplementations

Class TCLOSE

java.lang.Object

be.SIRAPRISE.typeimplementations.RelationalOperator

be.SIRAPRISE.typeimplementations.TCLOSE

All Implemented Interfaces:

OperatorGenerator

@OperatorGeneratorCharacteristics(maximumArgumentCount=2,
                                  minimumArgumentCount=2,
                                  name="TCLOSE",
                                  signature={EXPRESSION,STRING})
 @MonoRelationOperator
public abstract class TCLOSE
extends RelationalOperator

Author:

erwin

Constructor Summary

Constructors

Constructor and Description
TCLOSE()

Method Summary

Modifier and Type	Method and Description
static Relation	computeTClose(Relation relation, java.util.Map<NameIdentifier,NameIdentifier> matchby) Computes the closure.
static TCLOSE_RELATION	getInstance(Heading heading1, java.util.LinkedList<NameIdentifier> nameIdentifiersInEntryOrder) Gets an instance of the TCLOSE operator implementation for the given parameters
static TCLOSE_RELATION	getInstance(Heading heading, java.util.Map<NameIdentifier,NameIdentifier> mappingFromAttributeNameIdentifierList) Gets an instance of the TCLOSE operator implementation for the given parameters
static java.util.Map<NameIdentifier,NameIdentifier>	getMappingFromAttributeNameIdentifierList(java.util.LinkedList<NameIdentifier> nameIdentifiersInEntryOrder) Gets a "from-to" mapping built from the given list which is constructed as from1,to1,from2,to2, ...
TCLOSE_RELATION	getOperatorImplementation(OperatorGeneratorArgument[] args) Gets an implementation instance of the operator.

Methods inherited from class be.SIRAPRISE.typeimplementations.RelationalOperator

getInvocationName, getMaximumArgumentCount, getMinimumArgumentCount, getName, getOperatorGeneratorSignature, isMonoRelationOperator, 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 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.

getInstance

public static TCLOSE_RELATION getInstance(Heading heading1,
                                          java.util.LinkedList<NameIdentifier> nameIdentifiersInEntryOrder)
                                   throws AttributeListNotEvenSizedException,
                                          DuplicateNameException,
                                          DuplicateClosureAttributeException,
                                          ClosureAttributesOmittedException,
                                          NonExistingAttributeException,
                                          IncompatibleClosureTypesException

Gets an instance of the TCLOSE operator implementation for the given parameters

Parameters:

heading1 - The heading of the input relation to be TCLOSEd

nameIdentifiersInEntryOrder - The in-order spec of the TCLOSE operation : pa1,ca1,pa2,ca2, ... where each pa is a "parent" attribute such that (pa1,pa2,...) is an identifier for a "parent" entity occurrence and each ca is a "child" attribute such that (ca1,ca2,...) is an identifier for a "child" entity occurrence.

Returns:

An instance of the TCLOSE operator implementation for the given parameters

Throws:

AttributeListNotEvenSizedException - If the list is not even-sized, such that it cannot possibly represent a list of name pairs

DuplicateNameException - If any of the first elements of a name pair are mentioned twice

IncompatibleClosureTypesException - If an attribute is mapped for comparison with a non-compatible one

NonExistingAttributeException - If an attribute named in the closure spec is not part of the heading

ClosureAttributesOmittedException - If not all attributes of the heading have been specified either as a "from" or as a "to" attribute in the closure spec

DuplicateClosureAttributeException - If an attribute is mentioned twice in the closure spec

getInstance

public static TCLOSE_RELATION getInstance(Heading heading,
                                          java.util.Map<NameIdentifier,NameIdentifier> mappingFromAttributeNameIdentifierList)
                                   throws DuplicateClosureAttributeException,
                                          ClosureAttributesOmittedException,
                                          NonExistingAttributeException,
                                          IncompatibleClosureTypesException

Gets an instance of the TCLOSE operator implementation for the given parameters

Parameters:

heading - the heading of the relation to be TCLOSEd

mappingFromAttributeNameIdentifierList - the specification of the parent/child attribute matching used by the closure

Returns:

An instance of the TCLOSE operator implementation for the given parameters

Throws:

IncompatibleClosureTypesException - If an attribute is mapped for comparison with a non-compatible one

NonExistingAttributeException - If an attribute named in the closure spec is not part of the heading

ClosureAttributesOmittedException - If not all attributes of the heading have been specified either as a "from" or as a "to" attribute in the closure spec

DuplicateClosureAttributeException - If an attribute is mentioned twice in the closure spec

getMappingFromAttributeNameIdentifierList

public static java.util.Map<NameIdentifier,NameIdentifier> getMappingFromAttributeNameIdentifierList(java.util.LinkedList<NameIdentifier> nameIdentifiersInEntryOrder)
                                                                                              throws AttributeListNotEvenSizedException,
                                                                                                     DuplicateNameException

Gets a "from-to" mapping built from the given list which is constructed as from1,to1,from2,to2, ...

Parameters:

nameIdentifiersInEntryOrder - The given list from which a "from-to" mapping is to be built. The list is in from1,to1,from2,to2,... order

Returns:

a "from-to" mapping built from the given list

Throws:

AttributeListNotEvenSizedException - If the list is not even-sized, such that it cannot possibly represent a list of name pairs

DuplicateNameException - If any of the first elements of a name pair are mentioned twice

getOperatorImplementation

public final TCLOSE_RELATION getOperatorImplementation(OperatorGeneratorArgument[] args)
                                                throws NotFoundException

Description copied from interface: OperatorGenerator

Gets an implementation instance of the operator.

Parameters:

args - The arguments from which the instance is to be created. There must be exactly as many arguments as there are elements in the list returned from OperatorGenerator.getOperatorGeneratorSignature(). The correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types is given in the table below :

correspondence between OperatorGeneratorArgumentType values and OperatorGeneratorArgument types

OperatorGeneratorArgumentType value	OperatorGeneratorArgument type
EXPRESSION	NonScalarOperatorGeneratorExpressionArgument
EXPRESSIONWITHSCOPE	NonScalarOperatorGeneratorExpressionArgument
STRING	NonScalarOperatorGeneratorTextArgument

Returns:

an instance of the operator

Throws:

NotFoundException - If the given OperatorGeneratorArguments do not satisfy all of the rules of the OperatorGenerator. These rules are specific to each OperatorGenerator.