Oracle Application Server TopLink API Reference
10g (9.0.4)

B10491-01

oracle.toplink.expressions
Class ExpressionBuilder

java.lang.Object
  |
  +--oracle.toplink.expressions.Expression
        |
        +--oracle.toplink.internal.expressions.DataExpression
              |
              +--oracle.toplink.internal.expressions.ObjectExpression
                    |
                    +--oracle.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:

<blockquote>
                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')
</blockquote>
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, 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 © 2003 Oracle Corporation. All Rights Reserved.