oracle.odi.mapping.generation

Class ArrayExpression

java.lang.Object

oracle.odi.mapping.generation.AbstractSyntaxTree

oracle.odi.mapping.generation.Expression

oracle.odi.mapping.generation.ArrayExpression

All Implemented Interfaces:

IConditionItem, ISelectItem, ITableFunctionParameter

public class ArrayExpression
extends Expression
implements IConditionItem, ITableFunctionParameter

A class representing complex expressions generated by the mapping code generator. An ArrayExpression contains a template and an array of child objects that are used as template substitution values in the template. The child objects can be referenced attributes, expressions, or topology objects. It can generate a fully expanded expression for a mapping expression that has other expressions as referenced source attributes.

Nested Class Summary

Nested classes/interfaces inherited from class oracle.odi.mapping.generation.AbstractSyntaxTree

AbstractSyntaxTree.LogCounter

Field Summary

Fields inherited from class oracle.odi.mapping.generation.Expression

JAVA_LOGGER

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.lang.String	getAlias() Gets the alias for this expression.
MapConnectorPoint	getAssociatedPathPoint() Get the associated path point for this expression.
java.util.HashMap	getAttributesWithPath() Get a hash map whose keys are the referenced attribute names of this expression, and whose values are the MapAttributeWithPath object representing the referenced attributes and the mapping path that is being referenced.
java.util.Map	getChildMap() Get the hash map whose keys are the template substitution strings in this expression's template (e.g.
java.util.List	getChildren() Get the list of child objects owned by this substitution API object.
CorrelatedQuery	getCorrelatedQuery() Convenience method to cast this object to a CorrelatedQuery object, if it is an instance of CorrelatedQuery.
java.util.List	getExpressions() Get a list of all substitution API expression objects that are referenced by this expression.
int	getMaxColumnLength() Gets the maximum length of the column of this expression.
java.util.List	getNonOrderedComponents() Gets the list of components which are participating in a non-ANSI join.
SqlQuery	getQuery() Get the SqlQuery object that owns this ArrayExpression, if any, else return null.
java.lang.Object	getSimpleReferenceObject() If this expression is a reference to a single object, return the object.
java.util.List	getSourceAttributes() Get a list of attributes that act as sources for this expression.
java.util.List	getSourceExpressions() Get a list of expression objects that act as sources for this expression.
StringExpression	getStringExpression() Convenience method to cast this object to a StringExpression object, if it is an instance of StringExpression.
java.util.Map	getTemplateSubstitutionMap() Get a hash map containing built-in template substitution variable names as the hash key, and the substitution variable value as values.
java.lang.String	getText() Get the text for this expression.
boolean	hasCorrelatedSubquery() Checks if the expression contains any correlated subqueries.
boolean	hasNonOrderOuterJoin() Return if the expression contains an outer join marker, like (+)
boolean	isANSIJoinGenerate()
boolean	isLookupRowMatchCond() Returns true if this is a lookup row match condition, otherwise false.
boolean	isNonOrderedJoinCondition() Returns true if this expression represents a non-ANSI join condition (using the (+) keyword).
boolean	isSimpleExpression() Return true if the expression is a simple reference to one referenced object, with no function calls or operators.
boolean	isTargetExpression() Get a flag to indicate that this is a target expression.
java.lang.String	toString()

Methods inherited from class oracle.odi.mapping.generation.Expression

getAccompanyingExpressions, getDefaultValueTemplate, getMapAttribute, getMappingObject, getRefAttributeWithPath, getRefObject, getRefPath, getTargetColumnName, getTemplate, getType, hasWindowFunction, isAggregation, isAggregation, isPassive

Methods inherited from class oracle.odi.mapping.generation.AbstractSyntaxTree

getCodeGenerationTemplate, getCodeGenerationTemplateName, getCustomTemplate, getKMName, getLeafLevelChildren, getMapPhysicalNode, getOrder, getParentAST, getParentOfType, getPropertyValue, getSourceLanguage, getSourceLocation, getSourceTechnology, getSourceText, getTargetLanguage, getTargetLocation, getTargetTechnology, getTargetText, hasCustomTemplate, hasSourceAndTargetText, isLeafLevelNode, isPushFromSource

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.odi.mapping.generation.IConditionItem

getParentAST

Methods inherited from interface oracle.odi.mapping.generation.ITableFunctionParameter

getParentAST

Method Detail

isANSIJoinGenerate

public boolean isANSIJoinGenerate()

Returns:

True if this expression will generate an ANSI join condition.

getAlias

public java.lang.String getAlias()

Gets the alias for this expression.

Returns:

The alias

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Returns:

a String representation of this ArrayExpression. In most cases it is the same as the generated text.

getChildMap

public java.util.Map getChildMap()

Get the hash map whose keys are the template substitution strings in this expression's template (e.g. "R0"), and whose values are the referenced objects.

Returns:

isSimpleExpression

public boolean isSimpleExpression()

Return true if the expression is a simple reference to one referenced object, with no function calls or operators. So for example, an expression "EMP.EMPNO" is simple. But expressions like "SUM(EMP.SAL)" or "EMP.SAL + EMP.BONUS" are not simple.

Specified by:

isSimpleExpression in class Expression

Returns:

True if this is a simple expression.

getSimpleReferenceObject

public java.lang.Object getSimpleReferenceObject()

If this expression is a reference to a single object, return the object.

Returns:

The referenced object.

getText

public java.lang.String getText()

Description copied from class: Expression

Get the text for this expression.

Specified by:

getText in interface IConditionItem

Specified by:

getText in interface ITableFunctionParameter

Specified by:

getText in class Expression

Returns:

The generated text.

getMaxColumnLength

public int getMaxColumnLength()

Gets the maximum length of the column of this expression.

Specified by:

getMaxColumnLength in interface ISelectItem

Overrides:

getMaxColumnLength in class Expression

Returns:

Maximum length.

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class Expression

isLookupRowMatchCond

public boolean isLookupRowMatchCond()

Returns true if this is a lookup row match condition, otherwise false.

Returns:

true for lookup row match condition, otherwise false.

isNonOrderedJoinCondition

public boolean isNonOrderedJoinCondition()

Returns true if this expression represents a non-ANSI join condition (using the (+) keyword).

Returns:

True or false

getNonOrderedComponents

public java.util.List getNonOrderedComponents()

Gets the list of components which are participating in a non-ANSI join. This is used for adding the non-ANSI syntax (+) to the columns in those components. e.g. EMP.EMPNO (+)

Returns:

List of non-ANSI join components.

getAttributesWithPath

public java.util.HashMap getAttributesWithPath()

Get a hash map whose keys are the referenced attribute names of this expression, and whose values are the MapAttributeWithPath object representing the referenced attributes and the mapping path that is being referenced.

Returns:

the hash table.

hasCorrelatedSubquery

public boolean hasCorrelatedSubquery()

Checks if the expression contains any correlated subqueries.

Specified by:

hasCorrelatedSubquery in interface ISelectItem

Overrides:

hasCorrelatedSubquery in class Expression

Returns:

True if contain correlated subquery, false otherwise.

getAssociatedPathPoint

public MapConnectorPoint getAssociatedPathPoint()

Get the associated path point for this expression. The associated path point is the output mapping connector point referenced by the mapping physical node that generated this expression.

Returns:

The associated path point.

isTargetExpression

public boolean isTargetExpression()

Get a flag to indicate that this is a target expression. A target expression is used to generate text for a target component. A target expression will not be passed downstream to act as a source expression for another target. If set to true, the target expression flag will change the ArrayExpression comparison algorithm so that the expression source creation components of the 2 objects being compared are not required to be the same for the objects to be considered equal. For source expressions, the source creation components will be required to be the same for the ArrayExpression objects to be considered equal.

getTemplateSubstitutionMap

public java.util.Map getTemplateSubstitutionMap()

Description copied from class: AbstractSyntaxTree

Get a hash map containing built-in template substitution variable names as the hash key, and the substitution variable value as values.

Specified by:

getTemplateSubstitutionMap in class AbstractSyntaxTree

Returns:

The built-in template substitution hash map.

getExpressions

public java.util.List getExpressions()

Get a list of all substitution API expression objects that are referenced by this expression.

Specified by:

getExpressions in class AbstractSyntaxTree

Returns:

The list of expressions.

getChildren

public java.util.List getChildren()

Description copied from class: AbstractSyntaxTree

Get the list of child objects owned by this substitution API object.

Specified by:

getChildren in interface IConditionItem

Specified by:

getChildren in interface ITableFunctionParameter

Specified by:

getChildren in class AbstractSyntaxTree

Returns:

The list of child objects.

getQuery

public SqlQuery getQuery()

Get the SqlQuery object that owns this ArrayExpression, if any, else return null.

Specified by:

getQuery in interface ISelectItem

getSourceAttributes

public java.util.List getSourceAttributes()

Get a list of attributes that act as sources for this expression.

Specified by:

getSourceAttributes in interface ISelectItem

getSourceExpressions

public java.util.List getSourceExpressions()

Get a list of expression objects that act as sources for this expression.

Specified by:

getSourceExpressions in interface ISelectItem

hasNonOrderOuterJoin

public boolean hasNonOrderOuterJoin()

Return if the expression contains an outer join marker, like (+)

Returns:

getCorrelatedQuery

public CorrelatedQuery getCorrelatedQuery()

Description copied from interface: ISelectItem

Convenience method to cast this object to a CorrelatedQuery object, if it is an instance of CorrelatedQuery.

Specified by:

getCorrelatedQuery in interface ISelectItem

Returns:

The CorrelatedQuery object if this is a CorrelatedQuery, else null.

getStringExpression

public StringExpression getStringExpression()

Description copied from interface: ISelectItem

Convenience method to cast this object to a StringExpression object, if it is an instance of StringExpression.

Specified by:

getStringExpression in interface ISelectItem

Returns:

The StringExpression object if this is a StringExpression, else null.