Class QueryDefinitionImpl

    • 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  
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      Expression abs()
      Absolute value.
      protected <T extends AbstractDomainObject>
      T
      addDomain​(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.SelectItem

        asc, desc
    • 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 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
      • 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​(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 interface QueryDefinition
        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 interface QueryDefinition
        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 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​(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 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​(java.lang.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​(java.lang.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​(java.util.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​(java.util.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​(java.lang.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​(java.lang.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
      • 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 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​(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 interface QueryDefinition
        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 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​(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 interface QueryDefinition
        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 interface QueryDefinition
        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 interface QueryDefinition
        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 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​(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 interface QueryDefinition
        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 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​(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 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​(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 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​(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 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​(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 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​(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 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​(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 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​(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 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​(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 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 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 interface Visitable
      • 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 interface Visitable
      • 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 interface Expression
        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 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​(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 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​(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 interface Expression
        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 interface Expression
        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 interface Expression
        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 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​(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 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​(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 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​(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 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​(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 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​(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 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​(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 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,
                                 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 interface PredicateOperand
        Parameters:
        arg1 - - PredicateOperand instance or parameter
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - numeric
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - numeric
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - PredicateOperand instance or parameter
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - string
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - string
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - PredicateOperand instance or parameter
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - date
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - date
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - PredicateOperand instance or parameter
        arg2 - - 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 interface PredicateOperand
        Parameters:
        arg1 - - calendar
        arg2 - - 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 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​(java.lang.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​(java.lang.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​(java.lang.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​(java.util.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​(java.util.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​(java.lang.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​(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 interface PredicateOperand
        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 interface PredicateOperand
        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 interface PredicateOperand
        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 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​(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 interface PredicateOperand
        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 interface PredicateOperand
        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 interface PredicateOperand
        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 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​(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 interface PredicateOperand
        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 interface PredicateOperand
        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 interface PredicateOperand
        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 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​(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 interface PredicateOperand
        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 interface PredicateOperand
        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 interface PredicateOperand
        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 interface PredicateOperand
        Parameters:
        arg - - calendar
        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 interface PredicateOperand
        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 interface PredicateOperand
        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 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​(java.lang.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​(java.lang.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​(java.lang.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​(java.util.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​(java.util.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​(java.lang.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 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 interface Visitable
      • 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 interface Visitable