org.apache.openjpa.persistence.query
Class QueryDefinitionImpl

java.lang.Object
  extended by org.apache.openjpa.persistence.query.QueryDefinitionImpl
All Implemented Interfaces:
Serializable, Expression, OrderByItem, PredicateOperand, QueryDefinition, SelectItem, Subquery, Visitable

public class QueryDefinitionImpl
extends Object
implements QueryDefinition, Expression

Implements QueryDefinition.

Author:
Pinaki Poddar
See Also:
Serialized Form

Field Summary
protected static Localizer _loc
           
static String CLOSE_BRACE
           
static String COMMA
           
static String EMPTY
           
static String OPEN_BRACE
           
static String SPACE
           
 
Constructor Summary
protected QueryDefinitionImpl(QueryBuilderImpl builder)
           
 
Method Summary
 Expression abs()
          Absolute value.
protected
<T extends AbstractDomainObject>
T
addDomain(T path)
           
 DomainObject addRoot(Class cls)
          Root domain object has no parent, no path but a non-null Class.
 DomainObject addSubqueryRoot(PathExpression path)
          Add a root derived from a domain object of the containing query definition to a query definition used as a subquery.
 Subquery all()
          Use the query definition object in a subquery in an all expression.
 Subquery any()
          Use the query definition object in a subquery in an any expression.
 OrderByItem asc()
          Return an OrderByItem referencing the SelectItem and specifying ascending ordering.
 String asExpression(org.apache.openjpa.persistence.query.AliasContext ctx)
          Get a JPQL fragment as used in WHERE clause.
 String asJoinable(org.apache.openjpa.persistence.query.AliasContext ctx)
          Gets the string representation in FROM clause.
 String asProjection(org.apache.openjpa.persistence.query.AliasContext ctx)
          Gets the string representation in SELECT projection.
 Predicate between(Calendar arg1, Calendar arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(Calendar arg1, PredicateOperand arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(Date arg1, Date arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(Date arg1, PredicateOperand arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(Number arg1, Number arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(Number arg1, PredicateOperand arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(PredicateOperand arg1, Calendar arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(PredicateOperand arg1, Date arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(PredicateOperand arg1, Number arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(PredicateOperand arg1, PredicateOperand arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(PredicateOperand arg1, String arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(String arg1, PredicateOperand arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Predicate between(String arg1, String arg2)
          Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.
 Expression coalesce(Calendar... exp)
          coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.
 Expression coalesce(Date... exp)
          coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.
 Expression coalesce(Expression... exp)
          coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.
 Expression coalesce(String... exp)
          coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.
 Expression concat(Expression... exprs)
          Concatenate a string with other string(s).
 Expression concat(String... str)
          Concatenate a string with other string(s).
 Expression currentDate()
          Create an Expression corresponding to the current date on the database server at the time of query execution.
 Expression currentTime()
          Create an Expression corresponding to the current time on the database server at the time of query execution.
 Expression currentTimestamp()
          Create an Expression corresponding to the current timestamp on the database server at the time of query execution.
 OrderByItem desc()
          Return an OrderByItem referencing the SelectItem and specifying descending ordering.
 Expression dividedBy(Expression expr)
          Division.
 Expression dividedBy(Number num)
          Division.
 Predicate equal(boolean arg)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(Calendar arg)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(Class cls)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(Date arg)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(Enum<?> e)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(Number arg)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(PredicateOperand arg)
          Create a predicate for testing equality with the specified argument.
 Predicate equal(String arg)
          Create a predicate for testing equality with the specified argument.
 Predicate exists()
          Use the query definition instance as a subquery in an exists predicate.
 void fillBuffer(String header, StringBuilder buffer, org.apache.openjpa.persistence.query.AliasContext ctx, List list, org.apache.openjpa.persistence.query.QueryDefinitionImpl.Visit visit)
           
 void fillBuffer(String header, StringBuilder buffer, org.apache.openjpa.persistence.query.AliasContext ctx, Predicate p)
           
 CaseExpression generalCase()
          Create an empty general case expression.
 String getAliasHint(org.apache.openjpa.persistence.query.AliasContext ctx)
          Gets the hint to be used while creating alias.
 Predicate greaterEqual(Calendar arg)
          Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.
 Predicate greaterEqual(Date arg)
          Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.
 Predicate greaterEqual(Number arg)
          Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.
 Predicate greaterEqual(PredicateOperand arg)
          Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.
 Predicate greaterEqual(String arg)
          Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.
 Predicate greaterThan(Calendar arg)
          Create a predicate for testing whether the PredicateOperand is greater than the argument.
 Predicate greaterThan(Date arg)
          Create a predicate for testing whether the PredicateOperand is greater than the argument.
 Predicate greaterThan(Number arg)
          Create a predicate for testing whether the PredicateOperand is greater than the argument.
 Predicate greaterThan(PredicateOperand arg)
          Create a predicate for testing whether the PredicateOperand is greater than the argument.
 Predicate greaterThan(String arg)
          Create a predicate for testing whether the PredicateOperand is greater than the argument.
 QueryDefinition groupBy(List<PathExpression> pathExprList)
          Specify the items that are used to form groups over the query results.
 QueryDefinition groupBy(PathExpression... pathExprs)
          Specify the items that are used to form groups over the query results.
 QueryDefinition having(Predicate predicate)
          Specify the restrictions over the groups of a query.
 Predicate in(Class... classes)
          Create a predicate for testing whether the expression value is a member of the argument list.
 Predicate in(Enum<?>... enums)
          Create a predicate for testing whether the expression value is a member of the argument list.
 Predicate in(Expression... params)
          Create a predicate for testing whether the expression value is a member of the argument list.
 Predicate in(Number... nums)
          Create a predicate for testing whether the expression value is a member of the argument list.
 Predicate in(String... strings)
          Create a predicate for testing whether the expression value is a member of the argument list.
 Predicate in(Subquery subquery)
          Create a predicate for testing whether the expression value is a member of a subquery result.
 Predicate isNull()
          Create a predicate for testing whether the value of the expression is null.
 Expression length()
          String length This method must be invoked on an expression corresponding to a string.
 Predicate lessEqual(Calendar arg)
          Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.
 Predicate lessEqual(Date arg)
          Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.
 Predicate lessEqual(Number arg)
          Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.
 Predicate lessEqual(PredicateOperand arg)
          Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.
 Predicate lessEqual(String arg)
          Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.
 Predicate lessThan(Calendar arg)
          Create a predicate for testing whether the PredicateOperand is less than the argument.
 Predicate lessThan(Date arg)
          Create a predicate for testing whether the PredicateOperand is less than the argument.
 Predicate lessThan(Number arg)
          Create a predicate for testing whether the PredicateOperand is less than the argument.
 Predicate lessThan(PredicateOperand arg)
          Create a predicate for testing whether the PredicateOperand is less than the argument.
 Predicate lessThan(String arg)
          Create a predicate for testing whether the PredicateOperand is less than the argument.
 Predicate like(PredicateOperand pattern)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Predicate like(PredicateOperand pattern, char escapeChar)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Predicate like(PredicateOperand pattern, PredicateOperand escChar)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Predicate like(String pattern)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Predicate like(String pattern, char escChar)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Predicate like(String pattern, PredicateOperand escapeChar)
          Create a predicate for testing whether the PredicateOperand satisfies the given pattern.
 Expression literal(boolean b)
          Create an Expression corresponding to a boolean value.
 Expression literal(Calendar c)
          Create an Expression corresponding to a Calendar value.
 Expression literal(char c)
          Create an Expression corresponding to a character value.
 Expression literal(Class cls)
          Create an Expression corresponding to an entity class.
 Expression literal(Date d)
          Create an Expression corresponding to a Date value.
 Expression literal(Enum<?> e)
          Create an Expression corresponding to an enum.
 Expression literal(Number n)
          Create an Expression corresponding to a numeric value.
 Expression literal(String s)
          Create an Expression corresponding to a String value.
 Expression locate(Expression expr)
          Locate a string contained within the string corresponding to the expression on which the method was invoked.
 Expression locate(Expression str, Expression position)
          Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position.
 Expression locate(Expression str, int position)
          Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position.
 Expression locate(String str)
          Locate a string contained within the string corresponding to the expression on which the method was invoked.
 Expression locate(String str, Expression position)
          Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position.
 Expression locate(String str, int position)
          Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position.
 Expression lower()
          Convert string to lowercase.
 Predicate member(PathExpression arg)
          Create a predicate for testing whether the expression is a member of the association or element collection denoted by the path expression.
 Expression minus()
          Unary minus.
 Expression minus(Expression expr)
          Subtraction.
 Expression minus(Number num)
          Subtraction.
 Expression mod(Expression expr)
          Modulo operation.
 Expression mod(int num)
          Modulo operation.
 SelectItem newInstance(Class cls, SelectItem... args)
          Specify that a constructor for the given class is to be applied to the corresponding query results after the query is executed.
 Predicate notEqual(boolean arg)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(Calendar arg)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(Class cls)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(Date arg)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(Enum<?> e)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(Number arg)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(PredicateOperand arg)
          Create a predicate for testing inequality with the specified argument.
 Predicate notEqual(String arg)
          Create a predicate for testing inequality with the specified argument.
 Expression nullif(Calendar arg1, Calendar arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(Class arg1, Class arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(Date arg1, Date arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(Enum<?> arg1, Enum<?> arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(Expression exp1, Expression exp2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(Number arg1, Number arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullif(String arg1, String arg2)
          nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.
 Expression nullLiteral()
          Create an Expression corresponding to a null value.
 QueryDefinition orderBy(List<OrderByItem> orderByItemList)
          Specify the items of the select list that are used in ordering the query results.
 QueryDefinition orderBy(OrderByItem... orderByItems)
          Specify the items of the select list that are used in ordering the query results.
 Expression param(String name)
          Specify use of a parameter of the given name.
 Expression plus(Expression expr)
          Addition.
 Expression plus(Number num)
          Addition.
 Predicate predicate(boolean b)
          Create a predicate value from the given boolean.
 QueryDefinition select(List<SelectItem> items)
          Specify the objects / values to be returned.
 QueryDefinition select(SelectItem... items)
          Specify the objects / values to be returned.
 QueryDefinition selectDistinct(List<SelectItem> items)
          Specify the objects / values to be returned.
 QueryDefinition selectDistinct(SelectItem... items)
          Specify the objects / values to be returned.
 CaseExpression simpleCase(Calendar caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(Class caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(Date caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(Enum<?> caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(Expression caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(Number caseOperand)
          Create a simple case expression with the given case operand.
 CaseExpression simpleCase(String caseOperand)
          Create a simple case expression with the given case operand.
 Subquery some()
          Use the query definition object in a subquery in a some expression.
 Expression sqrt()
          Square root.
 Expression substring(Expression start)
          Extract a substring starting at specified position through to the end of the string.
 Expression substring(Expression start, Expression len)
          Extract a substring.
 Expression substring(Expression start, int len)
          Extract a substring.
 Expression substring(int start)
          Extract a substring starting at specified position through to the end of the string.
 Expression substring(int start, Expression len)
          Extract a substring.
 Expression substring(int start, int len)
          Extract a substring.
 Expression times(Expression expr)
          Multiplication.
 Expression times(Number num)
          Multiplication.
 Expression trim()
          Trim leading and trailing blanks.
 Expression trim(char c)
          Trim leading and trailing occurrences of character from the string.
 Expression trim(char c, TrimSpec spec)
          Trim occurrences of the character from leading or trailing (or both) positions of the string, as specified by trim spec.
 Expression trim(Expression expr)
          Trim leading and trailing occurrences of character specified by the expression argument from the string.
 Expression trim(Expression expr, TrimSpec spec)
          Trim occurrences of the character specified by the expression argument from leading or trailing (or both) positions of the string, as specified by trim spec.
 Expression trim(TrimSpec spec)
          Trim leading, trailing blanks (or both) as specified by trim spec.
 Expression upper()
          Convert string to uppercase.
 QueryDefinition where(Predicate predicate)
          Modifies the query definition to restrict the result of the query according to the specified predicate.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.apache.openjpa.persistence.query.PredicateOperand
between, between, between, between, between, between, between, between, between, between, between, between, between, equal, equal, equal, equal, equal, equal, equal, equal, greaterEqual, greaterEqual, greaterEqual, greaterEqual, greaterEqual, greaterThan, greaterThan, greaterThan, greaterThan, greaterThan, lessEqual, lessEqual, lessEqual, lessEqual, lessEqual, lessThan, lessThan, lessThan, lessThan, lessThan, like, like, like, like, like, like, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual, notEqual
 
Methods inherited from interface org.apache.openjpa.persistence.query.Expression
abs, concat, concat, dividedBy, dividedBy, in, in, in, in, in, in, isNull, length, locate, locate, locate, locate, locate, locate, lower, member, minus, minus, minus, mod, mod, plus, plus, sqrt, substring, substring, substring, substring, substring, substring, times, times, trim, trim, trim, trim, trim, trim, upper
 
Methods inherited from interface org.apache.openjpa.persistence.query.SelectItem
asc, desc
 
Methods inherited from interface org.apache.openjpa.persistence.query.Visitable
asJoinable
 

Field Detail

_loc

protected static Localizer _loc

SPACE

public static final String SPACE
See Also:
Constant Field Values

OPEN_BRACE

public static final String OPEN_BRACE
See Also:
Constant Field Values

CLOSE_BRACE

public static final String CLOSE_BRACE
See Also:
Constant Field Values

COMMA

public static final String COMMA
See Also:
Constant Field Values

EMPTY

public static final String EMPTY
See Also:
Constant Field Values
Constructor Detail

QueryDefinitionImpl

protected QueryDefinitionImpl(QueryBuilderImpl builder)
Parameters:
builder -
Method Detail

addRoot

public DomainObject addRoot(Class cls)
Root domain object has no parent, no path but a non-null Class.

Specified by:
addRoot in interface QueryDefinition
Parameters:
cls - - an entity class
Returns:
DomainObject corresponding to the specified entity class.

addSubqueryRoot

public DomainObject addSubqueryRoot(PathExpression path)
Description copied from interface: QueryDefinition
Add a root derived from a domain object of the containing query definition to a query definition used as a subquery. Provides support for correlated subqueries. Joins against the resulting domain object do not affect the query domain of the containing query. The path expression must correspond to an entity class. The path expression must not be a domain object of the containing query.

Specified by:
addSubqueryRoot in interface QueryDefinition
Parameters:
path - - path expression corresponding to the domain object used to derive the subquery root.
Returns:
the subquery DomainObject

addDomain

protected <T extends AbstractDomainObject> T addDomain(T path)

all

public Subquery all()
Description copied from interface: QueryDefinition
Use the query definition object in a subquery in an all expression.

Specified by:
all in interface QueryDefinition
Returns:
the resulting Subquery

any

public Subquery any()
Description copied from interface: QueryDefinition
Use the query definition object in a subquery in an any expression.

Specified by:
any in interface QueryDefinition
Returns:
the resulting Subquery

coalesce

public Expression coalesce(Expression... exp)
Description copied from interface: QueryDefinition
coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.

Specified by:
coalesce in interface QueryDefinition
Parameters:
exp - - expressions to be used for testing against null
Returns:
Expression corresponding to the given coalesce expression

coalesce

public Expression coalesce(String... exp)
Description copied from interface: QueryDefinition
coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.

Specified by:
coalesce in interface QueryDefinition
Parameters:
exp - - expressions to be used for testing against null
Returns:
Expression corresponding to the given coalesce expression

coalesce

public Expression coalesce(Date... exp)
Description copied from interface: QueryDefinition
coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.

Specified by:
coalesce in interface QueryDefinition
Parameters:
exp - - expressions to be used for testing against null
Returns:
Expression corresponding to the given coalesce expression

coalesce

public Expression coalesce(Calendar... exp)
Description copied from interface: QueryDefinition
coalesce This is equivalent to a case expression that returns null if all its arguments evaluate to null, and the value of its first non-null argument otherwise.

Specified by:
coalesce in interface QueryDefinition
Parameters:
exp - - expressions to be used for testing against null
Returns:
Expression corresponding to the given coalesce expression

currentDate

public Expression currentDate()
Description copied from interface: QueryDefinition
Create an Expression corresponding to the current date on the database server at the time of query execution.

Specified by:
currentDate in interface QueryDefinition
Returns:
the corresponding Expression

currentTime

public Expression currentTime()
Description copied from interface: QueryDefinition
Create an Expression corresponding to the current time on the database server at the time of query execution.

Specified by:
currentTime in interface QueryDefinition
Returns:
the corresponding Expression

currentTimestamp

public Expression currentTimestamp()
Description copied from interface: QueryDefinition
Create an Expression corresponding to the current timestamp on the database server at the time of query execution.

Specified by:
currentTimestamp in interface QueryDefinition
Returns:
the corresponding Expression

exists

public Predicate exists()
Description copied from interface: QueryDefinition
Use the query definition instance as a subquery in an exists predicate.

Specified by:
exists in interface QueryDefinition
Returns:
the resulting predicate

generalCase

public CaseExpression generalCase()
Description copied from interface: QueryDefinition
Create an empty general case expression. A general case expression is of the form:

generalCase() .when(conditional-predicate).then(scalar-expression) .when(conditional-predicate).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
generalCase in interface QueryDefinition
Returns:
empty general case expression

groupBy

public QueryDefinition groupBy(PathExpression... pathExprs)
Description copied from interface: QueryDefinition
Specify the items that are used to form groups over the query results. Replaces the previous group-by list, if any.

Specified by:
groupBy in interface QueryDefinition
Returns:
the modified QueryDefinition instance

groupBy

public QueryDefinition groupBy(List<PathExpression> pathExprList)
Description copied from interface: QueryDefinition
Specify the items that are used to form groups over the query results. Replaces the previous group-by list, if any.

Specified by:
groupBy in interface QueryDefinition
Returns:
the modified QueryDefinition instance

having

public QueryDefinition having(Predicate predicate)
Description copied from interface: QueryDefinition
Specify the restrictions over the groups of a query. Replaces the previous having restriction(s), if any.

Specified by:
having in interface QueryDefinition
Returns:
the modified QueryDefinition Instance

literal

public Expression literal(String s)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a String value.

Specified by:
literal in interface QueryDefinition
Parameters:
s - - string value
Returns:
the corresponding Expression literal

literal

public Expression literal(Number n)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a numeric value.

Specified by:
literal in interface QueryDefinition
Parameters:
n - - numeric value
Returns:
the corresponding Expression literal

literal

public Expression literal(boolean b)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a boolean value.

Specified by:
literal in interface QueryDefinition
Parameters:
b - - boolean value
Returns:
the corresponding Expression literal

literal

public Expression literal(Calendar c)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a Calendar value.

Specified by:
literal in interface QueryDefinition
Parameters:
c - - Calendar value
Returns:
the corresponding Expression literal

literal

public Expression literal(Date d)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a Date value.

Specified by:
literal in interface QueryDefinition
Parameters:
d - - Date value
Returns:
the corresponding Expression literal

literal

public Expression literal(char c)
Description copied from interface: QueryDefinition
Create an Expression corresponding to a character value.

Specified by:
literal in interface QueryDefinition
Returns:
the corresponding Expression literal

literal

public Expression literal(Class cls)
Description copied from interface: QueryDefinition
Create an Expression corresponding to an entity class.

Specified by:
literal in interface QueryDefinition
Parameters:
cls - - entity class
Returns:
the corresponding Expression literal

literal

public Expression literal(Enum<?> e)
Description copied from interface: QueryDefinition
Create an Expression corresponding to an enum.

Specified by:
literal in interface QueryDefinition
Parameters:
e - - enum
Returns:
the corresponding Expression literal

nullLiteral

public Expression nullLiteral()
Description copied from interface: QueryDefinition
Create an Expression corresponding to a null value.

Specified by:
nullLiteral in interface QueryDefinition
Returns:
the corresponding Expression literal

newInstance

public SelectItem newInstance(Class cls,
                              SelectItem... args)
Description copied from interface: QueryDefinition
Specify that a constructor for the given class is to be applied to the corresponding query results after the query is executed. The class must have a constructor that accepts the Java argument types corresponding to the given select items.

Specified by:
newInstance in interface QueryDefinition
Parameters:
cls - - a class with the correponding constructor
args - - select items that correspond to result types that are valid as arguments to the constructor

nullif

public Expression nullif(Expression exp1,
                         Expression exp2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(Number arg1,
                         Number arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(String arg1,
                         String arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
arg2 - Criteria API Java Persistence 2.0, Public Review Draft Criteria API Interfaces 10/31/08 158 JSR-317 Public Review Draft Sun Microsystems, Inc.
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(Date arg1,
                         Date arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(Calendar arg1,
                         Calendar arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(Class arg1,
                         Class arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

nullif

public Expression nullif(Enum<?> arg1,
                         Enum<?> arg2)
Description copied from interface: QueryDefinition
nullif This is equivalent to a case expression that tests whether its arguments are equal, returning null if they are and the value of the first expression if they are not.

Specified by:
nullif in interface QueryDefinition
Returns:
Expression corresponding to the given nullif expression

orderBy

public QueryDefinition orderBy(OrderByItem... orderByItems)
Description copied from interface: QueryDefinition
Specify the items of the select list that are used in ordering the query results. Replaces the previous order-by list, if any.

Specified by:
orderBy in interface QueryDefinition
Parameters:
orderByItems - - one or more OrderByItem instances
Returns:
the modified QueryDefinition instance

orderBy

public QueryDefinition orderBy(List<OrderByItem> orderByItemList)
Description copied from interface: QueryDefinition
Specify the items of the select list that are used in ordering the query results. Replaces the previous order-by list, if any.

Specified by:
orderBy in interface QueryDefinition
Parameters:
orderByItemList - - a list containing one or more OrderByItem instances
Returns:
the modified QueryDefinition instance

param

public Expression param(String name)
Description copied from interface: QueryDefinition
Specify use of a parameter of the given name.

Specified by:
param in interface QueryDefinition
Returns:
an Expression corresponding to a named parameter

predicate

public Predicate predicate(boolean b)
Description copied from interface: QueryDefinition
Create a predicate value from the given boolean.

Specified by:
predicate in interface QueryDefinition
Parameters:
b - boolean value
Returns:
a true or false predicate

select

public QueryDefinition select(SelectItem... items)
Description copied from interface: QueryDefinition
Specify the objects / values to be returned. Replaces the previous select list, if any. If no select items are specified and there is only one query root, the root entity is assumed to be the result.

Specified by:
select in interface QueryDefinition
Parameters:
items - - one or more SelectItem instances
Returns:
the modified query definition instance

select

public QueryDefinition select(List<SelectItem> items)
Description copied from interface: QueryDefinition
Specify the objects / values to be returned. Replaces the previous select list, if any. If no select items are specified and there is only one query root, the root entity is assumed to be the result.

Specified by:
select in interface QueryDefinition
Parameters:
items - - a list containing one or more SelectItem instances
Returns:
the modified query definition instance

selectDistinct

public QueryDefinition selectDistinct(SelectItem... items)
Description copied from interface: QueryDefinition
Specify the objects / values to be returned. Duplicate results will be eliminated. Replaces the previous select list, if any. If no select items are specified and there is only one query root, the root entity is assumed to be the result.

Specified by:
selectDistinct in interface QueryDefinition
Parameters:
items - - one or more SelectItem instances
Returns:
the modified query definition instance

selectDistinct

public QueryDefinition selectDistinct(List<SelectItem> items)
Description copied from interface: QueryDefinition
Specify the objects / values to be returned. Duplicate results will be eliminated. Replaces the previous select list, if any. If no select items are specified, and there is only one query root, the root entity is assumed to be the result. is assumed to be the result.

Specified by:
selectDistinct in interface QueryDefinition
Parameters:
items - - a list containing one or more SelectItem instances
Returns:
the modified query definition instance

simpleCase

public CaseExpression simpleCase(Expression caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - expression used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(Number caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - numeric value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(String caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(Date caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(Calendar caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(Class caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

simpleCase

public CaseExpression simpleCase(Enum<?> caseOperand)
Description copied from interface: QueryDefinition
Create a simple case expression with the given case operand. A simple case expression is of the form:

simpleCase(case-operand) .when(scalar-expression).then(scalar-expression) .when(scalar-expression).then(scalar-expression) ... .elseCase(scalar-expression)

Specified by:
simpleCase in interface QueryDefinition
Parameters:
caseOperand - - value used for testing against the when scalar expressions
Returns:
case expression with the given case operand

some

public Subquery some()
Description copied from interface: QueryDefinition
Use the query definition object in a subquery in a some expression.

Specified by:
some in interface QueryDefinition
Returns:
the resulting Subquery

where

public QueryDefinition where(Predicate predicate)
Description copied from interface: QueryDefinition
Modifies the query definition to restrict the result of the query according to the specified predicate. Replaces the previously added restriction(s), if any.

Specified by:
where in interface QueryDefinition
Parameters:
predicate - - a simple or compound conditional predicate
Returns:
the modified QueryDefinition instance

asExpression

public String asExpression(org.apache.openjpa.persistence.query.AliasContext ctx)
Description copied from interface: Visitable
Get a JPQL fragment as used in WHERE clause.

Specified by:
asExpression in interface Visitable

asProjection

public String asProjection(org.apache.openjpa.persistence.query.AliasContext ctx)
Description copied from interface: Visitable
Gets the string representation in SELECT projection.

Specified by:
asProjection in interface Visitable

fillBuffer

public void fillBuffer(String header,
                       StringBuilder buffer,
                       org.apache.openjpa.persistence.query.AliasContext ctx,
                       List list,
                       org.apache.openjpa.persistence.query.QueryDefinitionImpl.Visit visit)

fillBuffer

public void fillBuffer(String header,
                       StringBuilder buffer,
                       org.apache.openjpa.persistence.query.AliasContext ctx,
                       Predicate p)

abs

public Expression abs()
Description copied from interface: Expression
Absolute value. This method must be invoked on an expression corresponding to a number.

Specified by:
abs in interface Expression
Returns:
expression corresponding to the absolute value

concat

public Expression concat(String... str)
Description copied from interface: Expression
Concatenate a string with other string(s). This method must be invoked on an expression corresponding to a string.

Specified by:
concat in interface Expression
Parameters:
str - - string(s)
Returns:
expression denoting the concatenation of the strings, starting with the string corresponding to the expression on which the method was invoked.

concat

public Expression concat(Expression... exprs)
Description copied from interface: Expression
Concatenate a string with other string(s). This method must be invoked on an expression corresponding to a string.

Specified by:
concat in interface Expression
Parameters:
exprs - - expression(s) corresponding to string(s)
Returns:
expression denoting the concatenation of the strings, starting with the string corresponding to the expression on which the method was invoked.

dividedBy

public Expression dividedBy(Number num)
Description copied from interface: Expression
Division. This method must be invoked on an expression corresponding to a number.

Specified by:
dividedBy in interface Expression
Parameters:
num - - divisor
Returns:
expression denoting the result of dividing the number corresponding to the expression on which the method was invoked by the argument

dividedBy

public Expression dividedBy(Expression expr)
Description copied from interface: Expression
Division. This method must be invoked on an expression corresponding to a number.

Specified by:
dividedBy in interface Expression
Parameters:
expr - - expression corresponding to the divisor
Returns:
expression denoting the result of dividing the number corresponding to the expression on which the method was invoked by the number denoted by the argument

in

public Predicate in(String... strings)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of the argument list.

Specified by:
in in interface Expression
Returns:
conditional predicate

in

public Predicate in(Number... nums)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of the argument list.

Specified by:
in in interface Expression
Returns:
conditional predicate

in

public Predicate in(Enum<?>... enums)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of the argument list.

Specified by:
in in interface Expression
Returns:
conditional predicate

in

public Predicate in(Class... classes)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of the argument list.

Specified by:
in in interface Expression
Returns:
conditional predicate

in

public Predicate in(Expression... params)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of the argument list.

Specified by:
in in interface Expression
Returns:
conditional predicate

in

public Predicate in(Subquery subquery)
Description copied from interface: Expression
Create a predicate for testing whether the expression value is a member of a subquery result.

Specified by:
in in interface Expression
Returns:
conditional predicate

isNull

public Predicate isNull()
Description copied from interface: Expression
Create a predicate for testing whether the value of the expression is null.

Specified by:
isNull in interface Expression
Returns:
conditional predicate

length

public Expression length()
Description copied from interface: Expression
String length This method must be invoked on an expression corresponding to a string.

Specified by:
length in interface Expression
Returns:
expression denoting the length of the string.

locate

public Expression locate(String str)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked. The search is started at position 1 (first string position). This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
str - - string to be located
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

locate

public Expression locate(Expression expr)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked. The search is started at position 1 (first string position). This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
expr - - expression corresponding to the string to be located
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

locate

public Expression locate(String str,
                         int position)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position. This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
str - - string to be located
position - - position at which to start the search
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

locate

public Expression locate(String str,
                         Expression position)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position. This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
str - - string to be located
position - - expression corresponding to position at which to start the search
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

locate

public Expression locate(Expression str,
                         int position)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position. This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
str - - expression corresponding to the string to be located
position - - position at which to start the search
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

locate

public Expression locate(Expression str,
                         Expression position)
Description copied from interface: Expression
Locate a string contained within the string corresponding to the expression on which the method was invoked, starting at a specified search position. This method must be invoked on an expression corresponding to a string.

Specified by:
locate in interface Expression
Parameters:
str - - expression corresponding to the string to be located
position - - expression corresponding to position at which to start the search
Returns:
expression denoting the first position at which the string was found or expression denoting 0 if the string was not found

lower

public Expression lower()
Description copied from interface: Expression
Convert string to lowercase. This method must be invoked on an expression corresponding to a string.

Specified by:
lower in interface Expression
Returns:
expression denoting the string in lowercase

member

public Predicate member(PathExpression arg)
Description copied from interface: Expression
Create a predicate for testing whether the expression is a member of the association or element collection denoted by the path expression. The argument must correspond to a collection-valued association or element collection of like type.

Specified by:
member in interface Expression
Parameters:
arg - - a path expression that specifies a collection-valued association or an element collection
Returns:
conditional predicate

minus

public Expression minus()
Description copied from interface: Expression
Unary minus. This method must be invoked on an expression corresponding to a number.

Specified by:
minus in interface Expression
Returns:
expression denoting the unary minus of the expression

minus

public Expression minus(Number num)
Description copied from interface: Expression
Subtraction. This method must be invoked on an expression corresponding to a number.

Specified by:
minus in interface Expression
Parameters:
num - - subtrahend
Returns:
expression denoting the result of subtracting the argument from the number corresponding to the expression on which the method was invoked.

minus

public Expression minus(Expression expr)
Description copied from interface: Expression
Subtraction. This method must be invoked on an expression corresponding to a number.

Specified by:
minus in interface Expression
Parameters:
expr - - expression corresponding to subtrahend
Returns:
expression denoting the result of subtracting the number denoted by the argument from the number corresponding to the expression on which the method was invoked.

mod

public Expression mod(int num)
Description copied from interface: Expression
Modulo operation. This must be invoked on an expression corresponding to an integer value

Specified by:
mod in interface Expression
Parameters:
num - - integer divisor
Returns:
expression corresponding to the integer remainder of the division of the integer corresponding to the expression on which the method was invoked by the argument.

mod

public Expression mod(Expression expr)
Description copied from interface: Expression
Modulo operation. This must be invoked on an expression corresponding to an integer value

Specified by:
mod in interface Expression
Parameters:
expr - - expression corresponding to integer divisor
Returns:
expression corresponding to the integer remainder of the division of the integer corresponding to the expression on which the method was invoked by the argument.

plus

public Expression plus(Number num)
Description copied from interface: Expression
Addition. This method must be invoked on an expression corresponding to a number.

Specified by:
plus in interface Expression
Parameters:
num - - number to be added
Returns:
expression denoting the sum

plus

public Expression plus(Expression expr)
Description copied from interface: Expression
Addition. This method must be invoked on an expression corresponding to a number.

Specified by:
plus in interface Expression
Parameters:
expr - - expression corresponding to number to be added
Returns:
expression denoting the sum

sqrt

public Expression sqrt()
Description copied from interface: Expression
Square root. This method must be invoked on an expression corresponding to a number.

Specified by:
sqrt in interface Expression
Returns:
expression corresponding to the square root

substring

public Expression substring(int start)
Description copied from interface: Expression
Extract a substring starting at specified position through to the end of the string. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - start position (1 indicates first position)
Returns:
expression denoting the extracted substring

substring

public Expression substring(Expression start)
Description copied from interface: Expression
Extract a substring starting at specified position through to the end of the string. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - expression denoting start position (1 indicates first position)
Returns:
expression denoting the extracted substring

substring

public Expression substring(int start,
                            int len)
Description copied from interface: Expression
Extract a substring. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - start position (1 indicates first position)
len - - length of the substring to be returned
Returns:
expression denoting the extracted substring

substring

public Expression substring(int start,
                            Expression len)
Description copied from interface: Expression
Extract a substring. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - start position (1 indicates first position)
len - - expression denoting length of the substring to return
Returns:
expression denoting the extracted substring

substring

public Expression substring(Expression start,
                            int len)
Description copied from interface: Expression
Extract a substring. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - expression denoting start position (1 indicates first position)
len - - length of the substring to return
Returns:
expression denoting the extracted substring

substring

public Expression substring(Expression start,
                            Expression len)
Description copied from interface: Expression
Extract a substring. This method must be invoked on an expression corresponding to a string.

Specified by:
substring in interface Expression
Parameters:
start - - expression denoting start position (1 indicates first position)
len - - expression denoting length of the substring to return
Returns:
expression denoting the extracted substring

times

public Expression times(Number num)
Description copied from interface: Expression
Multiplication. This method must be invoked on an expression corresponding to a number.

Specified by:
times in interface Expression
Parameters:
num - - multiplier
Returns:
expression denoting the result of multiplying the argument with the number corresponding to the expression on which the method was invoked.

times

public Expression times(Expression expr)
Description copied from interface: Expression
Multiplication. This method must be invoked on an expression corresponding to a number.

Specified by:
times in interface Expression
Parameters:
expr - - expression corresponding to the multiplier
Returns:
expression denoting the result of multiplying the number denoted by the argument with the number corresponding to the expression on which the method was invoked.

trim

public Expression trim()
Description copied from interface: Expression
Trim leading and trailing blanks. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Returns:
expression denoting trimmed string

trim

public Expression trim(TrimSpec spec)
Description copied from interface: Expression
Trim leading, trailing blanks (or both) as specified by trim spec. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Parameters:
spec - - trim specification
Returns:
expression denoting trimmed string

trim

public Expression trim(char c)
Description copied from interface: Expression
Trim leading and trailing occurrences of character from the string. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Parameters:
c - - character to be trimmed
Returns:
expression denoting trimmed string

trim

public Expression trim(char c,
                       TrimSpec spec)
Description copied from interface: Expression
Trim occurrences of the character from leading or trailing (or both) positions of the string, as specified by trim spec. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Parameters:
c - - character to be trimmed
spec - - trim specification
Returns:
expression denoting trimmed string

trim

public Expression trim(Expression expr)
Description copied from interface: Expression
Trim leading and trailing occurrences of character specified by the expression argument from the string. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Parameters:
expr - - expression corresponding to the character to be trimmed
Returns:
expression denoting trimmed string

trim

public Expression trim(Expression expr,
                       TrimSpec spec)
Description copied from interface: Expression
Trim occurrences of the character specified by the expression argument from leading or trailing (or both) positions of the string, as specified by trim spec. This method must be invoked on an expression corresponding to a string.

Specified by:
trim in interface Expression
Parameters:
expr - - expression corresponding to the character to be trimmed
spec - - trim specification
Returns:
expression denoting trimmed string

upper

public Expression upper()
Description copied from interface: Expression
Convert string to uppercase. This method must be invoked on an expression corresponding to a string.

Specified by:
upper in interface Expression
Returns:
expression denoting the string in uppercase

asc

public OrderByItem asc()
Description copied from interface: SelectItem
Return an OrderByItem referencing the SelectItem and specifying ascending ordering. The SelectItem must correspond to an orderable value.

Specified by:
asc in interface SelectItem
Returns:
order-by item

desc

public OrderByItem desc()
Description copied from interface: SelectItem
Return an OrderByItem referencing the SelectItem and specifying descending ordering. The SelectItem must correspond to an orderable value.

Specified by:
desc in interface SelectItem
Returns:
order-by item

between

public Predicate between(PredicateOperand arg1,
                         PredicateOperand arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - PredicateOperand instance or parameter
arg2 - - PredicateOperand instance or parameter
Returns:
conditional predicate

between

public Predicate between(PredicateOperand arg1,
                         Number arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - PredicateOperand instance or parameter
arg2 - - numeric
Returns:
conditional predicate

between

public Predicate between(Number arg1,
                         PredicateOperand arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - numeric
arg2 - - PredicateOperand instance or parameter
Returns:
conditional predicate

between

public Predicate between(Number arg1,
                         Number arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - numeric
arg2 - - numeric
Returns:
conditional predicate

between

public Predicate between(PredicateOperand arg1,
                         String arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - PredicateOperand instance or parameter
arg2 - - string
Returns:
conditional predicate

between

public Predicate between(String arg1,
                         PredicateOperand arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - string
arg2 - - PredicateOperand instance or parameter
Returns:
conditional predicate

between

public Predicate between(String arg1,
                         String arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - string
arg2 - - string
Returns:
conditional predicate

between

public Predicate between(PredicateOperand arg1,
                         Date arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - PredicateOperand instance or parameter
arg2 - - date
Returns:
conditional predicate

between

public Predicate between(Date arg1,
                         PredicateOperand arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - date
arg2 - - PredicateOperand instance or parameter
Returns:
conditional predicate

between

public Predicate between(Date arg1,
                         Date arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - date
arg2 - - date
Returns:
conditional predicate

between

public Predicate between(PredicateOperand arg1,
                         Calendar arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - PredicateOperand instance or parameter
arg2 - - calendar
Returns:
conditional predicate

between

public Predicate between(Calendar arg1,
                         PredicateOperand arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - calendar
arg2 - - PredicateOperand instance or parameter
Returns:
conditional predicate

between

public Predicate between(Calendar arg1,
                         Calendar arg2)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.

Specified by:
between in interface PredicateOperand
Parameters:
arg1 - - calendar
arg2 - - calendar
Returns:
conditional predicate

equal

public Predicate equal(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

equal

public Predicate equal(Class cls)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
cls - - entity class
Returns:
conditional predicate

equal

public Predicate equal(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - numeric
Returns:
conditional predicate

equal

public Predicate equal(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - string value
Returns:
conditional predicate

equal

public Predicate equal(boolean arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - boolean value
Returns:
conditional predicate

equal

public Predicate equal(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

equal

public Predicate equal(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

equal

public Predicate equal(Enum<?> e)
Description copied from interface: PredicateOperand
Create a predicate for testing equality with the specified argument.

Specified by:
equal in interface PredicateOperand
Parameters:
e - - enum
Returns:
conditional predicate

greaterEqual

public Predicate greaterEqual(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.

Specified by:
greaterEqual in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

greaterEqual

public Predicate greaterEqual(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.

Specified by:
greaterEqual in interface PredicateOperand
Parameters:
arg - - numeric
Returns:
conditional predicate

greaterEqual

public Predicate greaterEqual(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.

Specified by:
greaterEqual in interface PredicateOperand
Parameters:
arg - - string
Returns:
conditional predicate

greaterEqual

public Predicate greaterEqual(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.

Specified by:
greaterEqual in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

greaterEqual

public Predicate greaterEqual(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.

Specified by:
greaterEqual in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

greaterThan

public Predicate greaterThan(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.

Specified by:
greaterThan in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

greaterThan

public Predicate greaterThan(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.

Specified by:
greaterThan in interface PredicateOperand
Parameters:
arg - - numeric
Returns:
conditional predicate

greaterThan

public Predicate greaterThan(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.

Specified by:
greaterThan in interface PredicateOperand
Parameters:
arg - - string
Returns:
conditional predicate

greaterThan

public Predicate greaterThan(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.

Specified by:
greaterThan in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

greaterThan

public Predicate greaterThan(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.

Specified by:
greaterThan in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

lessEqual

public Predicate lessEqual(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.

Specified by:
lessEqual in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

lessEqual

public Predicate lessEqual(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.

Specified by:
lessEqual in interface PredicateOperand
Parameters:
arg - - numeric
Returns:
conditional predicate

lessEqual

public Predicate lessEqual(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.

Specified by:
lessEqual in interface PredicateOperand
Parameters:
arg - - string
Returns:
conditional predicate

lessEqual

public Predicate lessEqual(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.

Specified by:
lessEqual in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

lessEqual

public Predicate lessEqual(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.

Specified by:
lessEqual in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

lessThan

public Predicate lessThan(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.

Specified by:
lessThan in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

lessThan

public Predicate lessThan(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.

Specified by:
lessThan in interface PredicateOperand
Parameters:
arg - - numeric
Returns:
conditional predicate

lessThan

public Predicate lessThan(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.

Specified by:
lessThan in interface PredicateOperand
Parameters:
arg - - string
Returns:
conditional predicate

lessThan

public Predicate lessThan(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.

Specified by:
lessThan in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

lessThan

public Predicate lessThan(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.

Specified by:
lessThan in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

like

public Predicate like(PredicateOperand pattern)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

like

public Predicate like(PredicateOperand pattern,
                      PredicateOperand escChar)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

like

public Predicate like(PredicateOperand pattern,
                      char escapeChar)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

like

public Predicate like(String pattern)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

like

public Predicate like(String pattern,
                      PredicateOperand escapeChar)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

like

public Predicate like(String pattern,
                      char escChar)
Description copied from interface: PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.

Specified by:
like in interface PredicateOperand
Returns:
conditional predicate

notEqual

public Predicate notEqual(PredicateOperand arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - PredicateOperand instance or parameter
Returns:
conditional predicate

notEqual

public Predicate notEqual(Class cls)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
cls - - entity class
Returns:
conditional predicate

notEqual

public Predicate notEqual(Number arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - numberic value
Returns:
conditional predicate

notEqual

public Predicate notEqual(String arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - string value
Returns:
conditional predicate

notEqual

public Predicate notEqual(boolean arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - boolean value
Returns:
conditional predicate

notEqual

public Predicate notEqual(Date arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - date
Returns:
conditional predicate

notEqual

public Predicate notEqual(Calendar arg)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
arg - - calendar
Returns:
conditional predicate

notEqual

public Predicate notEqual(Enum<?> e)
Description copied from interface: PredicateOperand
Create a predicate for testing inequality with the specified argument.

Specified by:
notEqual in interface PredicateOperand
Parameters:
e - - enum
Returns:
conditional predicate

getAliasHint

public String getAliasHint(org.apache.openjpa.persistence.query.AliasContext ctx)
Description copied from interface: Visitable
Gets the hint to be used while creating alias.

Specified by:
getAliasHint in interface Visitable

asJoinable

public String asJoinable(org.apache.openjpa.persistence.query.AliasContext ctx)
Description copied from interface: Visitable
Gets the string representation in FROM clause.

Specified by:
asJoinable in interface Visitable


Copyright © 2006–2013 Apache Software Foundation. All rights reserved.