Class QueryDefinitionImpl
- java.lang.Object
-
- org.apache.openjpa.persistence.query.QueryDefinitionImpl
-
- All Implemented Interfaces:
java.io.Serializable
,Expression
,OrderByItem
,PredicateOperand
,QueryDefinition
,SelectItem
,Subquery
,Visitable
public class QueryDefinitionImpl extends java.lang.Object implements QueryDefinition, Expression
Implements QueryDefinition.- Author:
- Pinaki Poddar
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected static Localizer
_loc
static java.lang.String
CLOSE_BRACE
static java.lang.String
COMMA
static java.lang.String
EMPTY
static java.lang.String
OPEN_BRACE
static java.lang.String
SPACE
-
Constructor Summary
Constructors Modifier Constructor Description protected
QueryDefinitionImpl(QueryBuilderImpl builder)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Expression
abs()
Absolute value.protected <T extends AbstractDomainObject>
TaddDomain(T path)
DomainObject
addRoot(java.lang.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.java.lang.String
asExpression(org.apache.openjpa.persistence.query.AliasContext ctx)
Get a JPQL fragment as used in WHERE clause.java.lang.String
asJoinable(org.apache.openjpa.persistence.query.AliasContext ctx)
Gets the string representation in FROM clause.java.lang.String
asProjection(org.apache.openjpa.persistence.query.AliasContext ctx)
Gets the string representation in SELECT projection.Predicate
between(java.lang.Number arg1, java.lang.Number arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.lang.Number arg1, PredicateOperand arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.lang.String arg1, java.lang.String arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.lang.String arg1, PredicateOperand arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.util.Calendar arg1, java.util.Calendar arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.util.Calendar arg1, PredicateOperand arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.util.Date arg1, java.util.Date arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(java.util.Date arg1, PredicateOperand arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(PredicateOperand arg1, java.lang.Number arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(PredicateOperand arg1, java.lang.String arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(PredicateOperand arg1, java.util.Calendar arg2)
Create a predicate for testing whether the PredicateOperand lies between (inclusive) the two arguments.Predicate
between(PredicateOperand arg1, java.util.Date 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.Expression
coalesce(java.lang.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
coalesce(java.util.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(java.util.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
concat(java.lang.String... str)
Concatenate a string with other string(s).Expression
concat(Expression... exprs)
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(java.lang.Number num)
Division.Expression
dividedBy(Expression expr)
Division.Predicate
equal(boolean arg)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.lang.Class cls)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.lang.Enum<?> e)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.lang.Number arg)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.lang.String arg)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.util.Calendar arg)
Create a predicate for testing equality with the specified argument.Predicate
equal(java.util.Date 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
exists()
Use the query definition instance as a subquery in an exists predicate.void
fillBuffer(java.lang.String header, java.lang.StringBuilder buffer, org.apache.openjpa.persistence.query.AliasContext ctx, java.util.List list, org.apache.openjpa.persistence.query.QueryDefinitionImpl.Visit visit)
void
fillBuffer(java.lang.String header, java.lang.StringBuilder buffer, org.apache.openjpa.persistence.query.AliasContext ctx, Predicate p)
CaseExpression
generalCase()
Create an empty general case expression.java.lang.String
getAliasHint(org.apache.openjpa.persistence.query.AliasContext ctx)
Gets the hint to be used while creating alias.Predicate
greaterEqual(java.lang.Number arg)
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.Predicate
greaterEqual(java.lang.String arg)
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.Predicate
greaterEqual(java.util.Calendar arg)
Create a predicate for testing whether the PredicateOperand is greater than or equal to the argument.Predicate
greaterEqual(java.util.Date 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
greaterThan(java.lang.Number arg)
Create a predicate for testing whether the PredicateOperand is greater than the argument.Predicate
greaterThan(java.lang.String arg)
Create a predicate for testing whether the PredicateOperand is greater than the argument.Predicate
greaterThan(java.util.Calendar arg)
Create a predicate for testing whether the PredicateOperand is greater than the argument.Predicate
greaterThan(java.util.Date 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.QueryDefinition
groupBy(java.util.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(java.lang.Class... classes)
Create a predicate for testing whether the expression value is a member of the argument list.Predicate
in(java.lang.Enum<?>... enums)
Create a predicate for testing whether the expression value is a member of the argument list.Predicate
in(java.lang.Number... nums)
Create a predicate for testing whether the expression value is a member of the argument list.Predicate
in(java.lang.String... strings)
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(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(java.lang.Number arg)
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.Predicate
lessEqual(java.lang.String arg)
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.Predicate
lessEqual(java.util.Calendar arg)
Create a predicate for testing whether the PredicateOperand is less than or equal to the argument.Predicate
lessEqual(java.util.Date 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
lessThan(java.lang.Number arg)
Create a predicate for testing whether the PredicateOperand is less than the argument.Predicate
lessThan(java.lang.String arg)
Create a predicate for testing whether the PredicateOperand is less than the argument.Predicate
lessThan(java.util.Calendar arg)
Create a predicate for testing whether the PredicateOperand is less than the argument.Predicate
lessThan(java.util.Date 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
like(java.lang.String pattern)
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.Predicate
like(java.lang.String pattern, char escChar)
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.Predicate
like(java.lang.String pattern, PredicateOperand escapeChar)
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.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.Expression
literal(boolean b)
Create an Expression corresponding to a boolean value.Expression
literal(char c)
Create an Expression corresponding to a character value.Expression
literal(java.lang.Class cls)
Create an Expression corresponding to an entity class.Expression
literal(java.lang.Enum<?> e)
Create an Expression corresponding to an enum.Expression
literal(java.lang.Number n)
Create an Expression corresponding to a numeric value.Expression
literal(java.lang.String s)
Create an Expression corresponding to a String value.Expression
literal(java.util.Calendar c)
Create an Expression corresponding to a Calendar value.Expression
literal(java.util.Date d)
Create an Expression corresponding to a Date value.Expression
locate(java.lang.String str)
Locate a string contained within the string corresponding to the expression on which the method was invoked.Expression
locate(java.lang.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
locate(java.lang.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(Expression expr)
Locate a string contained within the string corresponding to the expression on which the method was invoked.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(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
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(java.lang.Number num)
Subtraction.Expression
minus(Expression expr)
Subtraction.Expression
mod(int num)
Modulo operation.Expression
mod(Expression expr)
Modulo operation.SelectItem
newInstance(java.lang.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(java.lang.Class cls)
Create a predicate for testing inequality with the specified argument.Predicate
notEqual(java.lang.Enum<?> e)
Create a predicate for testing inequality with the specified argument.Predicate
notEqual(java.lang.Number arg)
Create a predicate for testing inequality with the specified argument.Predicate
notEqual(java.lang.String arg)
Create a predicate for testing inequality with the specified argument.Predicate
notEqual(java.util.Calendar arg)
Create a predicate for testing inequality with the specified argument.Predicate
notEqual(java.util.Date 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.Expression
nullif(java.lang.Class arg1, java.lang.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(java.lang.Enum<?> arg1, java.lang.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(java.lang.Number arg1, java.lang.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(java.lang.String arg1, java.lang.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
nullif(java.util.Calendar arg1, java.util.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(java.util.Date arg1, java.util.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(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
nullLiteral()
Create an Expression corresponding to a null value.QueryDefinition
orderBy(java.util.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(java.lang.String name)
Specify use of a parameter of the given name.Expression
plus(java.lang.Number num)
Addition.Expression
plus(Expression expr)
Addition.Predicate
predicate(boolean b)
Create a predicate value from the given boolean.QueryDefinition
select(java.util.List<SelectItem> items)
Specify the objects / values to be returned.QueryDefinition
select(SelectItem... items)
Specify the objects / values to be returned.QueryDefinition
selectDistinct(java.util.List<SelectItem> items)
Specify the objects / values to be returned.QueryDefinition
selectDistinct(SelectItem... items)
Specify the objects / values to be returned.CaseExpression
simpleCase(java.lang.Class caseOperand)
Create a simple case expression with the given case operand.CaseExpression
simpleCase(java.lang.Enum<?> caseOperand)
Create a simple case expression with the given case operand.CaseExpression
simpleCase(java.lang.Number caseOperand)
Create a simple case expression with the given case operand.CaseExpression
simpleCase(java.lang.String caseOperand)
Create a simple case expression with the given case operand.CaseExpression
simpleCase(java.util.Calendar caseOperand)
Create a simple case expression with the given case operand.CaseExpression
simpleCase(java.util.Date 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.Subquery
some()
Use the query definition object in a subquery in a some expression.Expression
sqrt()
Square root.Expression
substring(int start)
Extract a substring starting at specified position through to the end of the string.Expression
substring(int start, int len)
Extract a substring.Expression
substring(int start, Expression len)
Extract a substring.Expression
substring(Expression start)
Extract a substring starting at specified position through to the end of the string.Expression
substring(Expression start, int len)
Extract a substring.Expression
substring(Expression start, Expression len)
Extract a substring.Expression
times(java.lang.Number num)
Multiplication.Expression
times(Expression expr)
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.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.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.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 java.lang.String SPACE
- See Also:
- Constant Field Values
-
OPEN_BRACE
public static final java.lang.String OPEN_BRACE
- See Also:
- Constant Field Values
-
CLOSE_BRACE
public static final java.lang.String CLOSE_BRACE
- See Also:
- Constant Field Values
-
COMMA
public static final java.lang.String COMMA
- See Also:
- Constant Field Values
-
EMPTY
public static final java.lang.String EMPTY
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
QueryDefinitionImpl
protected QueryDefinitionImpl(QueryBuilderImpl builder)
- Parameters:
builder
-
-
-
Method Detail
-
addRoot
public DomainObject addRoot(java.lang.Class cls)
Root domain object has no parent, no path but a non-null Class.- Specified by:
addRoot
in interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
exp
- - expressions to be used for testing against null- Returns:
- Expression corresponding to the given coalesce expression
-
coalesce
public Expression coalesce(java.lang.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 interfaceQueryDefinition
- Parameters:
exp
- - expressions to be used for testing against null- Returns:
- Expression corresponding to the given coalesce expression
-
coalesce
public Expression coalesce(java.util.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 interfaceQueryDefinition
- Parameters:
exp
- - expressions to be used for testing against null- Returns:
- Expression corresponding to the given coalesce expression
-
coalesce
public Expression coalesce(java.util.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Returns:
- the modified QueryDefinition instance
-
groupBy
public QueryDefinition groupBy(java.util.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Returns:
- the modified QueryDefinition Instance
-
literal
public Expression literal(java.lang.String s)
Description copied from interface:QueryDefinition
Create an Expression corresponding to a String value.- Specified by:
literal
in interfaceQueryDefinition
- Parameters:
s
- - string value- Returns:
- the corresponding Expression literal
-
literal
public Expression literal(java.lang.Number n)
Description copied from interface:QueryDefinition
Create an Expression corresponding to a numeric value.- Specified by:
literal
in interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
b
- - boolean value- Returns:
- the corresponding Expression literal
-
literal
public Expression literal(java.util.Calendar c)
Description copied from interface:QueryDefinition
Create an Expression corresponding to a Calendar value.- Specified by:
literal
in interfaceQueryDefinition
- Parameters:
c
- - Calendar value- Returns:
- the corresponding Expression literal
-
literal
public Expression literal(java.util.Date d)
Description copied from interface:QueryDefinition
Create an Expression corresponding to a Date value.- Specified by:
literal
in interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Returns:
- the corresponding Expression literal
-
literal
public Expression literal(java.lang.Class cls)
Description copied from interface:QueryDefinition
Create an Expression corresponding to an entity class.- Specified by:
literal
in interfaceQueryDefinition
- Parameters:
cls
- - entity class- Returns:
- the corresponding Expression literal
-
literal
public Expression literal(java.lang.Enum<?> e)
Description copied from interface:QueryDefinition
Create an Expression corresponding to an enum.- Specified by:
literal
in interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Returns:
- the corresponding Expression literal
-
newInstance
public SelectItem newInstance(java.lang.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 interfaceQueryDefinition
- Parameters:
cls
- - a class with the correponding constructorargs
- - 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 interfaceQueryDefinition
- Returns:
- Expression corresponding to the given nullif expression
-
nullif
public Expression nullif(java.lang.Number arg1, java.lang.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 interfaceQueryDefinition
- Returns:
- Expression corresponding to the given nullif expression
-
nullif
public Expression nullif(java.lang.String arg1, java.lang.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 interfaceQueryDefinition
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(java.util.Date arg1, java.util.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 interfaceQueryDefinition
- Returns:
- Expression corresponding to the given nullif expression
-
nullif
public Expression nullif(java.util.Calendar arg1, java.util.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 interfaceQueryDefinition
- Returns:
- Expression corresponding to the given nullif expression
-
nullif
public Expression nullif(java.lang.Class arg1, java.lang.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 interfaceQueryDefinition
- Returns:
- Expression corresponding to the given nullif expression
-
nullif
public Expression nullif(java.lang.Enum<?> arg1, java.lang.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
orderByItems
- - one or more OrderByItem instances- Returns:
- the modified QueryDefinition instance
-
orderBy
public QueryDefinition orderBy(java.util.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 interfaceQueryDefinition
- Parameters:
orderByItemList
- - a list containing one or more OrderByItem instances- Returns:
- the modified QueryDefinition instance
-
param
public Expression param(java.lang.String name)
Description copied from interface:QueryDefinition
Specify use of a parameter of the given name.- Specified by:
param
in interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
items
- - one or more SelectItem instances- Returns:
- the modified query definition instance
-
select
public QueryDefinition select(java.util.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
items
- - one or more SelectItem instances- Returns:
- the modified query definition instance
-
selectDistinct
public QueryDefinition selectDistinct(java.util.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
caseOperand
- - expression used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.lang.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 interfaceQueryDefinition
- Parameters:
caseOperand
- - numeric value used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.lang.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 interfaceQueryDefinition
- Parameters:
caseOperand
- - value used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.util.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 interfaceQueryDefinition
- Parameters:
caseOperand
- - value used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.util.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 interfaceQueryDefinition
- Parameters:
caseOperand
- - value used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.lang.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 interfaceQueryDefinition
- Parameters:
caseOperand
- - value used for testing against the when scalar expressions- Returns:
- case expression with the given case operand
-
simpleCase
public CaseExpression simpleCase(java.lang.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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- 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 interfaceQueryDefinition
- Parameters:
predicate
- - a simple or compound conditional predicate- Returns:
- the modified QueryDefinition instance
-
asExpression
public java.lang.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 interfaceVisitable
-
asProjection
public java.lang.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 interfaceVisitable
-
fillBuffer
public void fillBuffer(java.lang.String header, java.lang.StringBuilder buffer, org.apache.openjpa.persistence.query.AliasContext ctx, java.util.List list, org.apache.openjpa.persistence.query.QueryDefinitionImpl.Visit visit)
-
fillBuffer
public void fillBuffer(java.lang.String header, java.lang.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 interfaceExpression
- Returns:
- expression corresponding to the absolute value
-
concat
public Expression concat(java.lang.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 interfaceExpression
- 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 interfaceExpression
- 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(java.lang.Number num)
Description copied from interface:Expression
Division. This method must be invoked on an expression corresponding to a number.- Specified by:
dividedBy
in interfaceExpression
- 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 interfaceExpression
- 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(java.lang.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 interfaceExpression
- Returns:
- conditional predicate
-
in
public Predicate in(java.lang.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 interfaceExpression
- Returns:
- conditional predicate
-
in
public Predicate in(java.lang.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 interfaceExpression
- Returns:
- conditional predicate
-
in
public Predicate in(java.lang.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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- Returns:
- expression denoting the length of the string.
-
locate
public Expression locate(java.lang.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 interfaceExpression
- 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 interfaceExpression
- 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(java.lang.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 interfaceExpression
- Parameters:
str
- - string to be locatedposition
- - 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(java.lang.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 interfaceExpression
- Parameters:
str
- - string to be locatedposition
- - 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 interfaceExpression
- Parameters:
str
- - expression corresponding to the string to be locatedposition
- - 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 interfaceExpression
- Parameters:
str
- - expression corresponding to the string to be locatedposition
- - 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- Returns:
- expression denoting the unary minus of the expression
-
minus
public Expression minus(java.lang.Number num)
Description copied from interface:Expression
Subtraction. This method must be invoked on an expression corresponding to a number.- Specified by:
minus
in interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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(java.lang.Number num)
Description copied from interface:Expression
Addition. This method must be invoked on an expression corresponding to a number.- Specified by:
plus
in interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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(java.lang.Number num)
Description copied from interface:Expression
Multiplication. This method must be invoked on an expression corresponding to a number.- Specified by:
times
in interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- 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 interfaceExpression
- Parameters:
c
- - character to be trimmedspec
- - 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 interfaceExpression
- 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 interfaceExpression
- Parameters:
expr
- - expression corresponding to the character to be trimmedspec
- - 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 interfaceExpression
- 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 interfaceSelectItem
- 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 interfaceSelectItem
- 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 interfacePredicateOperand
- Parameters:
arg1
- - PredicateOperand instance or parameterarg2
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
between
public Predicate between(PredicateOperand arg1, java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - PredicateOperand instance or parameterarg2
- - numeric- Returns:
- conditional predicate
-
between
public Predicate between(java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - numericarg2
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
between
public Predicate between(java.lang.Number arg1, java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - numericarg2
- - numeric- Returns:
- conditional predicate
-
between
public Predicate between(PredicateOperand arg1, java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - PredicateOperand instance or parameterarg2
- - string- Returns:
- conditional predicate
-
between
public Predicate between(java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - stringarg2
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
between
public Predicate between(java.lang.String arg1, java.lang.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 interfacePredicateOperand
- Parameters:
arg1
- - stringarg2
- - string- Returns:
- conditional predicate
-
between
public Predicate between(PredicateOperand arg1, java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - PredicateOperand instance or parameterarg2
- - date- Returns:
- conditional predicate
-
between
public Predicate between(java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - datearg2
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
between
public Predicate between(java.util.Date arg1, java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - datearg2
- - date- Returns:
- conditional predicate
-
between
public Predicate between(PredicateOperand arg1, java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - PredicateOperand instance or parameterarg2
- - calendar- Returns:
- conditional predicate
-
between
public Predicate between(java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - calendararg2
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
between
public Predicate between(java.util.Calendar arg1, java.util.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 interfacePredicateOperand
- Parameters:
arg1
- - calendararg2
- - 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
equal
public Predicate equal(java.lang.Class cls)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- Parameters:
cls
- - entity class- Returns:
- conditional predicate
-
equal
public Predicate equal(java.lang.Number arg)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- Parameters:
arg
- - numeric- Returns:
- conditional predicate
-
equal
public Predicate equal(java.lang.String arg)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - boolean value- Returns:
- conditional predicate
-
equal
public Predicate equal(java.util.Date arg)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
equal
public Predicate equal(java.util.Calendar arg)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- Parameters:
arg
- - calendar- Returns:
- conditional predicate
-
equal
public Predicate equal(java.lang.Enum<?> e)
Description copied from interface:PredicateOperand
Create a predicate for testing equality with the specified argument.- Specified by:
equal
in interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
greaterEqual
public Predicate greaterEqual(java.lang.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 interfacePredicateOperand
- Parameters:
arg
- - numeric- Returns:
- conditional predicate
-
greaterEqual
public Predicate greaterEqual(java.lang.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 interfacePredicateOperand
- Parameters:
arg
- - string- Returns:
- conditional predicate
-
greaterEqual
public Predicate greaterEqual(java.util.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 interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
greaterEqual
public Predicate greaterEqual(java.util.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 interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
greaterThan
public Predicate greaterThan(java.lang.Number arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.- Specified by:
greaterThan
in interfacePredicateOperand
- Parameters:
arg
- - numeric- Returns:
- conditional predicate
-
greaterThan
public Predicate greaterThan(java.lang.String arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.- Specified by:
greaterThan
in interfacePredicateOperand
- Parameters:
arg
- - string- Returns:
- conditional predicate
-
greaterThan
public Predicate greaterThan(java.util.Date arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.- Specified by:
greaterThan
in interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
greaterThan
public Predicate greaterThan(java.util.Calendar arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is greater than the argument.- Specified by:
greaterThan
in interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
lessEqual
public Predicate lessEqual(java.lang.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 interfacePredicateOperand
- Parameters:
arg
- - numeric- Returns:
- conditional predicate
-
lessEqual
public Predicate lessEqual(java.lang.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 interfacePredicateOperand
- Parameters:
arg
- - string- Returns:
- conditional predicate
-
lessEqual
public Predicate lessEqual(java.util.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 interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
lessEqual
public Predicate lessEqual(java.util.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 interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
lessThan
public Predicate lessThan(java.lang.Number arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.- Specified by:
lessThan
in interfacePredicateOperand
- Parameters:
arg
- - numeric- Returns:
- conditional predicate
-
lessThan
public Predicate lessThan(java.lang.String arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.- Specified by:
lessThan
in interfacePredicateOperand
- Parameters:
arg
- - string- Returns:
- conditional predicate
-
lessThan
public Predicate lessThan(java.util.Date arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.- Specified by:
lessThan
in interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
lessThan
public Predicate lessThan(java.util.Calendar arg)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand is less than the argument.- Specified by:
lessThan
in interfacePredicateOperand
- 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 interfacePredicateOperand
- 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 interfacePredicateOperand
- 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 interfacePredicateOperand
- Returns:
- conditional predicate
-
like
public Predicate like(java.lang.String pattern)
Description copied from interface:PredicateOperand
Create a predicate for testing whether the PredicateOperand satisfies the given pattern.- Specified by:
like
in interfacePredicateOperand
- Returns:
- conditional predicate
-
like
public Predicate like(java.lang.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 interfacePredicateOperand
- Returns:
- conditional predicate
-
like
public Predicate like(java.lang.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 interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - PredicateOperand instance or parameter- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.lang.Class cls)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- Parameters:
cls
- - entity class- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.lang.Number arg)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- Parameters:
arg
- - numberic value- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.lang.String arg)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- 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 interfacePredicateOperand
- Parameters:
arg
- - boolean value- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.util.Date arg)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- Parameters:
arg
- - date- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.util.Calendar arg)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- Parameters:
arg
- - calendar- Returns:
- conditional predicate
-
notEqual
public Predicate notEqual(java.lang.Enum<?> e)
Description copied from interface:PredicateOperand
Create a predicate for testing inequality with the specified argument.- Specified by:
notEqual
in interfacePredicateOperand
- Parameters:
e
- - enum- Returns:
- conditional predicate
-
getAliasHint
public java.lang.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 interfaceVisitable
-
asJoinable
public java.lang.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 interfaceVisitable
-
-