oracle.toplink.essentials.internal.expressions

Class RelationExpression

java.lang.Object

oracle.toplink.essentials.expressions.Expression

oracle.toplink.essentials.internal.expressions.CompoundExpression

oracle.toplink.essentials.internal.expressions.RelationExpression

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class RelationExpression
extends CompoundExpression

Purpose:Used for all relation operators except for between.

See Also:

Serialized Form

Field Summary

Fields inherited from class oracle.toplink.essentials.internal.expressions.CompoundExpression

firstChild, operator, platformOperator, secondChild

Fields inherited from class oracle.toplink.essentials.expressions.Expression

currentAlias, lastTable, selectIfOrderedBy

Constructor Summary

Constructors

Constructor and Description
RelationExpression() RelationExpression constructor comment.

Method Summary

Modifier and Type	Method and Description
protected boolean	allChildrenAreFields() Test that both of our children are field nodes
protected void	convertNodeToUseOuterJoin() INTERNAL: Modify this individual expression node to use outer joins wherever there are equality operations between two field nodes.
java.lang.String	descriptionOfNodeType() INTERNAL: Used for debug printing.
protected boolean	doesAnyOfLeftValuesConform(java.util.Vector leftValues, java.lang.Object rightValue, AbstractSession session) Conform in-memory the collection of left values with the right value for this expression.
boolean	doesConform(java.lang.Object object, AbstractSession session, AbstractRecord translationRow, InMemoryQueryIndirectionPolicy valueHolderPolicy, boolean isObjectUnregistered) INTERNAL: Check if the object conforms to the expression in memory.
boolean	doesObjectConform(java.lang.Object leftValue, java.lang.Object rightValue, AbstractSession session) INTERNAL: Check if the object conforms to the expression in memory.
protected boolean	doValuesConform(java.lang.Object leftValue, java.lang.Object rightValue, AbstractSession session) Conform in-memory the two values.
boolean	extractPrimaryKeyValues(boolean requireExactMatch, ClassDescriptor descriptor, AbstractRecord primaryKeyRow, AbstractRecord translationRow) INTERNAL: Extract the primary key from the expression into the row.
boolean	isEqualNull(ExpressionSQLPrinter printer) Check if the expression is an equal null expression, these must be handle in a special way in SQL.
boolean	isNotEqualNull(ExpressionSQLPrinter printer) Check if the expression is an equal null expression, these must be handle in a special way in SQL.
protected boolean	isObjectComparison() INTERNAL: Return if the represents an object comparison.
boolean	isRelationExpression() INTERNAL:
Expression	normalize(ExpressionNormalizer normalizer) INTERNAL: Check for object comparison as this requires for the expression to be replaced by the object comparison.
boolean	performSelector(boolean areValuesEqual) INTERNAL: Check if the object conforms to the expression in memory.
void	printJava(ExpressionJavaPrinter printer) INTERNAL: Print java for project class generation
void	printSQL(ExpressionSQLPrinter printer) INTERNAL: Print SQL
void	printSQLNoParens(ExpressionSQLPrinter printer) INTERNAL: Print SQL without adding parentheses (for DB2 outer joins).
void	validateNode() Do any required validation for this node.

Methods inherited from class oracle.toplink.essentials.internal.expressions.CompoundExpression

aliasForTable, create, create, getBuilder, getFirstChild, getOperator, getPlatformOperator, getSecondChild, initializePlatformOperator, isCompoundExpression, iterateOn, postCopyIn, rebuildOn, setFirstChild, setOperator, setSecondChild, twistedForBaseAndContext, writeDescriptionOn, writeSubexpressionsTo

Methods inherited from class oracle.toplink.essentials.expressions.Expression

addDate, addDate, addMonths, addMonths, all, all, all, all, all, all, all, all, all, all, all, all, allOf, and, any, any, any, any, any, any, any, any, any, any, any, any, anyOf, anyOfAllowingNone, ascending, asciiValue, assignAlias, assignTableAliasesStartingAt, average, between, between, between, between, between, between, between, between, between, caseStatement, clone, cloneUsing, concat, containsAllKeyWords, containsAnyKeyWords, containsSubstring, containsSubstring, containsSubstringIgnoringCase, containsSubstringIgnoringCase, convertToUseOuterJoin, copiedVersionFrom, count, createWithBaseLast, currentDate, currentDateDate, currentTime, currentTimeStamp, dateDifference, dateDifference, dateName, datePart, dateToString, decode, descending, detectExpression, difference, distinct, doesConform, equal, equal, equal, equal, equal, equal, equal, equal, equal, equal, equalOuterJoin, equalOuterJoin, equalsIgnoreCase, equalsIgnoreCase, exists, existsNode, extract, extractValue, from, fromConstant, fromLiteral, get, get, getAllowingNull, getAllowingNull, getClonedField, getField, getField, getFields, getFieldValue, getFunction, getFunction, getFunction, getFunction, getFunctionWithArguments, getName, getNumberVal, getOperator, getOwnedTables, getParameter, getParameter, getParameter, getSession, getStringVal, getTable, getTable, getTableAliases, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, hasAsOfClause, hasBeenAliased, hexToRaw, ifNull, in, in, in, in, in, in, in, in, in, in, in, in, indexOf, isConstantExpression, isDataExpression, isEmpty, isExpressionBuilder, isFieldExpression, isFragment, isFunctionExpression, isLiteralExpression, isLogicalExpression, isNull, isObjectExpression, isParameterExpression, isQueryKeyExpression, isTableExpression, isValueExpression, lastDay, leftPad, leftPad, leftTrim, leftTrim, length, lessThan, lessThan, lessThan, lessThan, lessThan, lessThan, lessThan, lessThan, lessThan, lessThan, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, lessThanEqual, like, like, like, like, likeIgnoreCase, likeIgnoreCase, literal, locate, locate, locate, maximum, minimum, monthsBetween, newTime, nextDay, noneOf, not, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notEmpty, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notExists, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notIn, notLike, notLike, notNull, or, performOperator, postfixSQL, prefixSQL, printSQLWithoutConversion, ref, registerIn, replace, replicate, replicate, resetCache, reverse, right, right, rightPad, rightPad, rightTrim, rightTrim, roundDate, selectIfOrderedBy, setLocalBase, setSelectIfOrderedBy, shallowClone, size, some, some, some, some, some, some, some, some, some, some, some, some, standardDeviation, subQuery, substring, substring, sum, toChar, toChar, toCharacter, toDate, toLowerCase, toNumber, toString, toString, toUpperCase, toUppercaseCasedWords, translate, trim, trim, truncateDate, twist, value, value, value, value, value, value, value, value, value, value, valueFromObject, valueFromObject, variance, writeField, writeFields

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RelationExpression

public RelationExpression()

RelationExpression constructor comment.

Method Detail

allChildrenAreFields

protected boolean allChildrenAreFields()

Test that both of our children are field nodes

convertNodeToUseOuterJoin

protected void convertNodeToUseOuterJoin()

INTERNAL: Modify this individual expression node to use outer joins wherever there are equality operations between two field nodes.

Overrides:

convertNodeToUseOuterJoin in class Expression

descriptionOfNodeType

public java.lang.String descriptionOfNodeType()

INTERNAL: Used for debug printing.

Overrides:

descriptionOfNodeType in class CompoundExpression

doesConform

public boolean doesConform(java.lang.Object object,
                           AbstractSession session,
                           AbstractRecord translationRow,
                           InMemoryQueryIndirectionPolicy valueHolderPolicy,
                           boolean isObjectUnregistered)

INTERNAL: Check if the object conforms to the expression in memory. This is used for in-memory querying. If the expression in not able to determine if the object conform throw a not supported exception.

Overrides:

doesConform in class Expression

doesAnyOfLeftValuesConform

protected boolean doesAnyOfLeftValuesConform(java.util.Vector leftValues,
                                             java.lang.Object rightValue,
                                             AbstractSession session)

Conform in-memory the collection of left values with the right value for this expression. This is used for anyOf support when the left side is a collection of values.

doValuesConform

protected boolean doValuesConform(java.lang.Object leftValue,
                                  java.lang.Object rightValue,
                                  AbstractSession session)

Conform in-memory the two values.

doesObjectConform

public boolean doesObjectConform(java.lang.Object leftValue,
                                 java.lang.Object rightValue,
                                 AbstractSession session)

INTERNAL: Check if the object conforms to the expression in memory. This is used for in-memory querying across object relationships.

extractPrimaryKeyValues

public boolean extractPrimaryKeyValues(boolean requireExactMatch,
                                       ClassDescriptor descriptor,
                                       AbstractRecord primaryKeyRow,
                                       AbstractRecord translationRow)

INTERNAL: Extract the primary key from the expression into the row. Ensure that the query is quering the exact primary key.

Overrides:

extractPrimaryKeyValues in class Expression

Parameters:

requireExactMatch - refers to the primary key extracted gaurenteeing the result, if not exact it is a hueristic and the cache hit will be conformed to the expression after the lookup Return false if not on the primary key.

isEqualNull

public boolean isEqualNull(ExpressionSQLPrinter printer)

Check if the expression is an equal null expression, these must be handle in a special way in SQL.

isNotEqualNull

public boolean isNotEqualNull(ExpressionSQLPrinter printer)

Check if the expression is an equal null expression, these must be handle in a special way in SQL.

isObjectComparison

protected boolean isObjectComparison()

INTERNAL: Return if the represents an object comparison.

isRelationExpression

public boolean isRelationExpression()

INTERNAL:

Overrides:

isRelationExpression in class Expression

normalize

public Expression normalize(ExpressionNormalizer normalizer)

INTERNAL: Check for object comparison as this requires for the expression to be replaced by the object comparison.

Overrides:

normalize in class CompoundExpression

performSelector

public boolean performSelector(boolean areValuesEqual)

INTERNAL: Check if the object conforms to the expression in memory. This is used for in-memory querying across object relationships.

printSQL

public void printSQL(ExpressionSQLPrinter printer)

INTERNAL: Print SQL

Overrides:

printSQL in class CompoundExpression

printJava

public void printJava(ExpressionJavaPrinter printer)

INTERNAL: Print java for project class generation

Overrides:

printJava in class CompoundExpression

printSQLNoParens

public void printSQLNoParens(ExpressionSQLPrinter printer)

INTERNAL: Print SQL without adding parentheses (for DB2 outer joins).

validateNode

public void validateNode()

Do any required validation for this node. Throw an exception if it's incorrect.

Overrides:

validateNode in class CompoundExpression