XMINUSUSING_RELATION

java.lang.Object
- be.SIRAPRISE.typeimplementations.XMINUSUSING_RELATION_RELATION

All Implemented Interfaces:: AggregationOperatorImplementation, OperatorImplementation_V0104, OperatorImplementation_V0105, java.io.Externalizable, java.io.Serializable

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

An invocation XMINUSUSING(r1,r2,i) is equivalent to UNIONUSING(MINUSUSING(r1,r2,i),MINUSUSING(r2,r1,i),i).

Some examples of XMINUSUSING 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-4]} TUP {IV:[8-9]} }
REL { TUP {IV1:[1-7] IV2:[1-7]} }	REL { TUP {IV1:[1-3] IV2:[1-3]} }	IV1,IV2	REL { TUP {IV1:[1-7] IV2:[4-7]} TUP {IV1:[4-7] IV2:[1-3]} }
REL { TUP {IV1:[1-7] IV2:[1-7]} }	REL { TUP {IV1:[1-3] IV2:[1-3]} }	IV2,IV1	REL { TUP {IV1:[4-7] IV2:[1-7]} TUP {IV1:[1-3] IV2:[4-7]} }

Author:: Erwin
See Also:: Serialized Form

Constructor Summary

Constructors
Constructor and Description
`XMINUSUSING_RELATION_RELATION(Heading heading, java.util.LinkedList<NameIdentifier> treatAsRange)` Creates the XMINUSUSING_RELATION_RELATION
`XMINUSUSING_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 XMINUSUSING_RELATION_RELATION

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ValueBuffer`	`executeOperator(java.util.LinkedList<ValueBuffer> args)` Performs the actual logic of the operator.
`java.lang.String[]`	`getArgumentTypeNames()` The relation XMINUSUSING operator takes two arguments, both of a relation type.
`ValueBuffer`	`getIdentityElement()` The identity value for XMINUSUSING is the empty relation of the concerned relation type.
`TypeDeclaration`	`getReturnTypeDeclaration()` XMINUSUSING returns a relation of the type that is the most specific common supertype between the relation types of the arguments
`java.lang.String`	`getReturnTypeName()` XMINUSUSING returns a relation of the type that is the most specific common supertype between the relation types of the arguments
`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
  - XMINUSUSING_RELATION_RELATION
```
public XMINUSUSING_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 XMINUSUSING_RELATION_RELATION
    
    Parameters:
    
    heading - The heading defining the relation type of both arguments
    
    treatAsRange - The names of the attributes to be treated as a range. The result returned from invocations of the operator instance will be packed on these attributes.
    
    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.
  - XMINUSUSING_RELATION_RELATION
```
public XMINUSUSING_RELATION_RELATION(Heading heading,
                                     java.util.LinkedList<NameIdentifier> treatAsRange)
```
    Creates the XMINUSUSING_RELATION_RELATION
    
    Parameters:
    
    heading - The heading defining the relation type of both arguments
    
    treatAsRange - The names of the attributes to be treated as a range. The result returned from invocations of the operator instance will be packed on these attributes.
- Method Detail
  - 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()
```
    The relation XMINUSUSING operator takes two arguments, both of a relation type. Both relation types must have a common supertype. A third argument addresses the OperatorGenerator and specifies the set of attributes that are to be treated in "range" mode when computing. This third argument must consist exclusively of attributes of the relations that are interval-typed. These attributes also determine how the result of the invocation will be PACKed, so they must be specified in the order as desired.
    
    Specified by:
    
    getArgumentTypeNames in interface OperatorImplementation_V0104
    
    Returns:
    
    The names of the argument types
  - getIdentityElement
```
public ValueBuffer getIdentityElement()
```
    The identity value for XMINUSUSING is the empty relation of the concerned relation type.
    
    Specified by:
    
    getIdentityElement in interface AggregationOperatorImplementation
    
    Returns:
    
    The identity element.
  - getReturnTypeDeclaration
```
public TypeDeclaration getReturnTypeDeclaration()
```
    XMINUSUSING returns a relation of the type that is the most specific common supertype between the relation types of the arguments
    
    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()
```
    XMINUSUSING returns a relation of the type that is the most specific common supertype between the relation types of the arguments
    
    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

Class XMINUSUSING_RELATION_RELATION

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

XMINUSUSING_RELATION_RELATION

XMINUSUSING_RELATION_RELATION

Method Detail

executeOperator

getArgumentTypeNames

getIdentityElement

getReturnTypeDeclaration

getReturnTypeName

getSignature

isDeterministic

readExternal

writeExternal