psdi.app.recontask.engine

Class ReconExpression

java.lang.Object

psdi.app.recontask.engine.ReconExpression

Direct Known Subclasses:

ReconCompAttributesEqualityExpression, ReconCompFilterExpression, ReconCompMatchesFoundExpression, ReconLinkExpression

public abstract class ReconExpression
extends java.lang.Object

Author:

Petko_Popov, Srini_Badari (enhancements) This is an abstract class that represents a Reconciliation expression. It is currently extended by the following classes to represent different types of expressions used during reconciliation: ReconCompAttributesEqualityExpression (An attributes comparison expression) ReconCompFilterExpression (A comparison rule filter expression) ReconCompMatchesFoundExpression (A matches found expression) ReconLinkExpression (A link expression)

Field Summary

Fields

Modifier and Type	Field and Description
static int	TOKEN_CONSTANT
static int	TOKEN_DATASET1_FIELD
static int	TOKEN_DATASET2_FIELD
static int	TOKEN_HIGHEST_VALUE the highest numerical value of the tag that a valid expression token can have
static int	TOKEN_INVALID
static int	TOKEN_LEFT_PARENTHESIS
static int	TOKEN_LOWEST_VALUE the lowest numerical value the tag that a valid expression token can have
static int	TOKEN_OPERATOR
static int	TOKEN_RIGHT_PARENTHESIS
static int	TOKEN_VALUE a value to compare against in an expression
java.util.List<ReconOperator>	validOperators the allowed operators

Constructor Summary

Constructors

Constructor and Description
ReconExpression(ReconInfo reconInfo)

Method Summary

Modifier and Type	Method and Description
void	addExpressionToken(int tokenType, java.lang.String tokenValue) Append a token at the end of the expresion.
void	addExpressionToken(int tokenType, java.lang.String tokenValue, java.lang.String tokenUnit) Append a token at the end of the expresion.
java.util.Set	getAttributeSet(boolean getLeftSide, boolean stripPrefixes)
java.util.Map	getAttributeToUnitMap(boolean getLeftSide, boolean stripPrefixes)
java.lang.String	getCompiledExpressionAsString()
java.lang.String	getExpressionTag()
void	prepareAttributeIndexes(ReconValueSet leadingSet, ReconValueSet subordinateSet) Modifies the comparison operators to use indexes into the attribute arrays instead of attribute names - done for performance reasons
static void	processInfixExpression(java.util.Stack operatorStack, java.util.Stack nodeStack, ReconExpressionToken currentToken)
static void	processOperatorToken(java.util.Stack operatorStack, java.util.Stack nodeStack, ReconExpressionToken currentToken)
static void	processRightParenthesisToken(java.util.Stack operatorStack, java.util.Stack nodeStack)
void	readExpression(MboSetRemote reconLinkSet) The reason why this method exisits: It is not possible to sort the MBO set itself, because this code is called to validate the rule.
void	reset() Start over
void	setExpressionTag(java.lang.String expressionTag)

Methods inherited from class java.lang.Object

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

Field Detail

TOKEN_INVALID

public static final int TOKEN_INVALID

See Also:

Constant Field Values

TOKEN_LEFT_PARENTHESIS

public static final int TOKEN_LEFT_PARENTHESIS

See Also:

Constant Field Values

TOKEN_RIGHT_PARENTHESIS

public static final int TOKEN_RIGHT_PARENTHESIS

See Also:

Constant Field Values

TOKEN_OPERATOR

public static final int TOKEN_OPERATOR

See Also:

Constant Field Values

TOKEN_CONSTANT

public static final int TOKEN_CONSTANT

See Also:

Constant Field Values

TOKEN_DATASET1_FIELD

public static final int TOKEN_DATASET1_FIELD

See Also:

Constant Field Values

TOKEN_DATASET2_FIELD

public static final int TOKEN_DATASET2_FIELD

See Also:

Constant Field Values

TOKEN_VALUE

public static final int TOKEN_VALUE

a value to compare against in an expression

See Also:

Constant Field Values

TOKEN_LOWEST_VALUE

public static final int TOKEN_LOWEST_VALUE

the lowest numerical value the tag that a valid expression token can have

See Also:

Constant Field Values

TOKEN_HIGHEST_VALUE

public static final int TOKEN_HIGHEST_VALUE

the highest numerical value of the tag that a valid expression token can have

See Also:

Constant Field Values

validOperators

public java.util.List<ReconOperator> validOperators

the allowed operators

Constructor Detail

ReconExpression

public ReconExpression(ReconInfo reconInfo)

Method Detail

setExpressionTag

public void setExpressionTag(java.lang.String expressionTag)

getExpressionTag

public java.lang.String getExpressionTag()

getCompiledExpressionAsString

public java.lang.String getCompiledExpressionAsString()

addExpressionToken

public void addExpressionToken(int tokenType,
                               java.lang.String tokenValue)
                        throws MXException

Append a token at the end of the expresion. Will invalidate the expression

Throws:

MXException

addExpressionToken

public void addExpressionToken(int tokenType,
                               java.lang.String tokenValue,
                               java.lang.String tokenUnit)
                        throws MXException

Append a token at the end of the expresion. Will invalidate the expression

Throws:

MXException

prepareAttributeIndexes

public void prepareAttributeIndexes(ReconValueSet leadingSet,
                                    ReconValueSet subordinateSet)
                             throws MXException

Modifies the comparison operators to use indexes into the attribute arrays instead of attribute names - done for performance reasons

Parameters:

leadingSet -

subordinateSet -

Throws:

MXException

readExpression

public void readExpression(MboSetRemote reconLinkSet)
                    throws MXException,
                           java.rmi.RemoteException

The reason why this method exisits: It is not possible to sort the MBO set itself, because this code is called to validate the rule. At that point it is not allowed to sort the MBO set, because sort is always carried out by the database

Throws:

MXException

java.rmi.RemoteException

reset

public void reset()

Start over

processOperatorToken

public static void processOperatorToken(java.util.Stack operatorStack,
                                        java.util.Stack nodeStack,
                                        ReconExpressionToken currentToken)
                                 throws MXException

Parameters:

operatorStack - stack containing operators found so far

nodeStack - resulting stack where each object is a BinaryTreeNode

currentToken - the current token expression being processed

Throws:

MXException

See Also:

for processing step #'s. 2) Token is an operator: a) pop all operators that have equal or higher precedence from the operator stack b) push operators onto result stack c) push current operator onto the operator stack

processRightParenthesisToken

public static void processRightParenthesisToken(java.util.Stack operatorStack,
                                                java.util.Stack nodeStack)

Parameters:

operatorStack - stack containing operators found so far

nodeStack - resulting stack where each object is a BinaryTreeNode

See Also:

for processing step #'s. 4) Token is right parenthesis: a) Pop all operators from operator stack. b) Push onto resulting stack, until a matching left parenthesis found - do not include the pair of matching parentheses

processInfixExpression

public static void processInfixExpression(java.util.Stack operatorStack,
                                          java.util.Stack nodeStack,
                                          ReconExpressionToken currentToken)
                                   throws MXException

Parameters:

operatorStack - stack containing operators found so far

nodeStack - resulting stack where each object is a BinaryTreeNode

currentToken - the current token expression being processed

Throws:

MXException

See Also:

for processing step #'s.

getAttributeSet

public java.util.Set getAttributeSet(boolean getLeftSide,
                                     boolean stripPrefixes)

Parameters:

getLeftSide -

stripPrefixes -

Returns:

getAttributeToUnitMap

public java.util.Map getAttributeToUnitMap(boolean getLeftSide,
                                           boolean stripPrefixes)

Parameters:

getLeftSide -

stripPrefixes -

Returns: