oracle.toplink.expressions
Class ExpressionBuilder

java.lang.Object
  oracle.toplink.expressions.Expression
      oracle.toplink.internal.expressions.BaseExpression
          oracle.toplink.internal.expressions.DataExpression
              oracle.toplink.internal.expressions.ObjectExpression
                  oracle.toplink.expressions.ExpressionBuilder

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

public class ExpressionBuilder
extends oracle.toplink.internal.expressions.ObjectExpression

Purpose: Allow for instances of expression to be created. Expressions are Java object-level representations of SQL "where" clauses. The expressions attempt to mirror Java code as closely as possible.

Example:

        ExpressionBuilder employee = new ExpressionBuilder();
        employee.get("firstName").equal("Bob").and(employee.get("lastName").equal("Smith"))

        >> equivalent Java code: (employee.getFirstName().equals("Bob")) && (employee.getLastName().equals("Smith"))

        >> equivalent SQL: (F_NAME = 'Bob') AND (L_NAME = 'Smith')
 

See Also:

Expression, Serialized Form

Field Summary

Fields inherited from class oracle.toplink.internal.expressions.ObjectExpression

derivedExpressions, descriptor

Constructor Summary

ExpressionBuilder()
Create a new ExpressionBuilder.

ExpressionBuilder(java.lang.Class queryClass)
ADVANCED: Create a new ExpressionBuilder representing instances of the argument class.

Method Summary

Methods inherited from class oracle.toplink.internal.expressions.ObjectExpression

addDerivedExpression, anyOf, anyOfAllowingNone, derivedExpressionNamed, derivedManualExpressionNamed, existingDerivedExpressionNamed, get, getAllowingNull, getManualQueryKey, isObjectExpression, newDerivedExpressionNamed, newManualDerivedExpressionNamed, shouldUseOuterJoin, shouldUseOuterJoinForMultitableInheritance

Methods inherited from class oracle.toplink.internal.expressions.DataExpression

addDerivedField, addDerivedTable, asOf, copyCollection, getAsOfClause, getField, getField, getMapping, getQueryKeyOrNull, getTable, getTable, hasAsOfClause, hasBeenAliased, isDataExpression, mappingCriteria, setHasBeenNormalized, tableAliasesDescription, writeSubexpressionsTo

Methods inherited from class oracle.toplink.internal.expressions.BaseExpression

getBaseExpression, setBaseExpression

Methods inherited from class oracle.toplink.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, appendSQL, ascending, asciiValue, average, between, between, between, between, between, between, between, between, between, caseStatement, concat, containsAllKeyWords, containsAnyKeyWords, containsSubstring, containsSubstring, containsSubstringIgnoringCase, containsSubstringIgnoringCase, count, currentDate, currentDateDate, currentTime, currentTimeStamp, dateDifference, dateDifference, dateName, datePart, dateToString, decode, descending, difference, distinct, equal, equal, equal, equal, equal, equal, equal, equal, equal, equal, equalsIgnoreCase, equalsIgnoreCase, exists, existsNode, extract, extractValue, get, getAllowingNull, getFunction, getFunction, getFunction, getFunction, getFunctionWithArguments, getNumberVal, getParameter, getParameter, getStringVal, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, greaterThanEqual, hexToRaw, ifNull, in, in, in, in, in, in, in, in, in, in, in, in, indexOf, isEmpty, isFragment, isNull, 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, postfixSQL, prefixSQL, ref, replace, replicate, replicate, reverse, right, right, rightPad, rightPad, rightTrim, rightTrim, roundDate, selectIfOrderedBy, setSelectIfOrderedBy, 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, toUpperCase, toUppercaseCasedWords, translate, trim, trim, truncateDate, value, value, value, value, value, value, value, value, value, value, variance

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ExpressionBuilder

public ExpressionBuilder()

Create a new ExpressionBuilder.

ExpressionBuilder

public ExpressionBuilder(java.lang.Class queryClass)

ADVANCED: Create a new ExpressionBuilder representing instances of the argument class. This can be used for the purpose of parallel expressions. This is a type of query that searches on the relationship between to un-related objects.