Oracle Application Server TopLink API Reference
10g Release 2 (10.1.2)

B15903-01


oracle.toplink.expressions
Class ExpressionBuilder

java.lang.Object
  extended byoracle.toplink.expressions.Expression
      extended byoracle.toplink.internal.expressions.DataExpression
          extended byoracle.toplink.internal.expressions.ObjectExpression
              extended byoracle.toplink.expressions.ExpressionBuilder

All Implemented Interfaces:
java.lang.Cloneable, java.io.Serializable

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()
PUBLIC: Create a new ExpressionBuilder.
ExpressionBuilder(java.lang.Class queryClass)
ADVANCED: Create a new ExpressionBuilder representing instances of the argument class.

Methods inherited from class oracle.toplink.internal.expressions.ObjectExpression
addDerivedExpression, additionalExpressionCriteria, anyOf, derivedExpressionNamed, derivedManualExpressionNamed, existingDerivedExpressionNamed, get, getAllowingNull, getFields, getManualQueryKey, isObjectExpression, newDerivedExpressionNamed, newManualDerivedExpressionNamed, postCopyIn, shouldUseOuterJoin

Methods inherited from class oracle.toplink.internal.expressions.DataExpression
addDerivedField, addDerivedTable, clearAliases, copyCollection, existingDerivedField, existingDerivedTable, getAliasedField, getBaseExpression, getField, getField, getField, getMapping, getOwnedTables, getQueryKeyOrNull, getTable, getTable, getTableAliases, hasAddedMappingCriteria, hasBeenAliased, isAttribute, isDataExpression, iterateOn, mappingCriteria, newDerivedField, newDerivedTable, printSQL, setHasAddedMappingCriteria, setTableAliases, tableAliasesDescription, writeSubexpressionsTo

Methods inherited from class oracle.toplink.expressions.Expression
addDate, addDate, addMonths, addMonths, and, anyOfAllowingNone, appendSQL, ascending, asciiValue, average, between, between, between, between, between, between, between, between, between, caseStatement, concat, containsAllKeyWords, containsAnyKeyWords, containsSubstring, containsSubstring, containsSubstringIgnoringCase, containsSubstringIgnoringCase, count, currentDate, dateDifference, dateDifference, dateName, datePart, dateToString, decode, descending, difference, distinct, equal, equal, equal, equal, equal, equal, equal, equal, equal, equal, equalsIgnoreCase, equalsIgnoreCase, exists, get, getAllowingNull, getFunction, getFunction, getFunction, getFunction, getFunctionWithArguments, getParameter, getParameter, 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, isNull, lastDay, leftPad, leftPad, 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, likeIgnoreCase, likeIgnoreCase, maximum, minimum, monthsBetween, newTime, nextDay, not, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notBetween, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notExists, 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, standardDeviation, subQuery, substring, substring, sum, toCharacter, toDate, toLowerCase, toNumber, toString, toUpperCase, toUppercaseCasedWords, translate, trim, truncateDate, value, value, value, value, value, value, value, value, value, value, variance

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ExpressionBuilder

public ExpressionBuilder()
PUBLIC: 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.

Copyright © 1998, 2005 Oracle Corporation. All Rights Reserved.