Package org.eclipse.persistence.internal.jpa.querydef

Class CriteriaBuilderImpl

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      class  CriteriaBuilderImpl.CaseImpl<R>
      Implementation of Case interface from Criteria Builder
      class  CriteriaBuilderImpl.CoalesceImpl<X>
      Interface used to build coalesce expressions.
      class  CriteriaBuilderImpl.SimpleCaseImpl<C,​R>
      Implementation of SimpleCase interface from CriteriaBuilder

      • Nested classes/interfaces inherited from interface jakarta.persistence.criteria.CriteriaBuilder

        jakarta.persistence.criteria.CriteriaBuilder.Case<R extends Object>, jakarta.persistence.criteria.CriteriaBuilder.Coalesce<T extends Object>, jakarta.persistence.criteria.CriteriaBuilder.In<T extends Object>, jakarta.persistence.criteria.CriteriaBuilder.SimpleCase<C extends Object,​R extends Object>, jakarta.persistence.criteria.CriteriaBuilder.Trimspec

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static String CONCAT  
      protected jakarta.persistence.metamodel.Metamodel metamodel  
      static String SIZE  

    • Constructor Summary

      Constructors 
      Constructor Description
      CriteriaBuilderImpl​(jakarta.persistence.metamodel.Metamodel metamodel)  

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 abs​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression that returns the absolute value of its argument.
      <Y> jakarta.persistence.criteria.Expression<Y> all​(jakarta.persistence.criteria.Subquery<Y> subquery)
      Create a predicate corresponding to an all expression over the subquery results.
      jakarta.persistence.criteria.Predicate and​(jakarta.persistence.criteria.Expression<Boolean> x, jakarta.persistence.criteria.Expression<Boolean> y)
      Create a conjunction of the given boolean expressions.
      jakarta.persistence.criteria.Predicate and​(jakarta.persistence.criteria.Predicate... restrictions)
      Create a conjunction of the given restriction predicates.
      <Y> jakarta.persistence.criteria.Expression<Y> any​(jakarta.persistence.criteria.Subquery<Y> subquery)
      Create a predicate corresponding to an any expression over the subquery results.
      jakarta.persistence.criteria.CompoundSelection<Object[]> array​(jakarta.persistence.criteria.Selection<?>... selections)
      Create an array-valued selection item
      jakarta.persistence.criteria.Order asc​(jakarta.persistence.criteria.Expression<?> x)
      Create an ordering by the ascending value of the expression.
      <N extends Number>
      jakarta.persistence.criteria.Expression<Double>      		 avg​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression applying the avg operation.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 between​(jakarta.persistence.criteria.Expression<? extends Y> v, jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create a predicate for testing whether the first argument is between the second and third arguments in value.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 between​(jakarta.persistence.criteria.Expression<? extends Y> v, Y x, Y y)
      Create a predicate for testing whether the first argument is between the second and third arguments in value.
      protected List<jakarta.persistence.criteria.Expression<?>> buildList​(jakarta.persistence.criteria.Expression<?>... expressions)  
      <T> jakarta.persistence.criteria.CriteriaBuilder.Coalesce<T> coalesce()
      Create a coalesce expression.
      <Y> jakarta.persistence.criteria.Expression<Y> coalesce​(jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create an expression that returns null if all its arguments evaluate to null, and the value of the first non-null argument otherwise.
      <Y> jakarta.persistence.criteria.Expression<Y> coalesce​(jakarta.persistence.criteria.Expression<? extends Y> x, Y y)
      Create an expression that returns null if all its arguments evaluate to null, and the value of the first non-null argument otherwise.
      jakarta.persistence.criteria.Expression<String> concat​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> y)
      String concatenation operation.
      jakarta.persistence.criteria.Expression<String> concat​(jakarta.persistence.criteria.Expression<String> x, String y)
      String concatenation operation.
      jakarta.persistence.criteria.Expression<String> concat​(String x, jakarta.persistence.criteria.Expression<String> y)
      String concatenation operation.
      jakarta.persistence.criteria.Predicate conjunction()
      Create a conjunction (with zero conjuncts).
      <Y> jakarta.persistence.criteria.CompoundSelection<Y> construct​(Class<Y> result, jakarta.persistence.criteria.Selection<?>... selections)
      Define a select list item corresponding to a constructor.
      jakarta.persistence.criteria.Expression<Long> count​(jakarta.persistence.criteria.Expression<?> x)
      Create an expression applying the count operation.
      jakarta.persistence.criteria.Expression<Long> countDistinct​(jakarta.persistence.criteria.Expression<?> x)
      Create an expression applying the count distinct operation.
      <T> jakarta.persistence.criteria.CriteriaDelete<T> createCriteriaDelete​(Class<T> targetEntity)  
      <T> jakarta.persistence.criteria.CriteriaUpdate<T> createCriteriaUpdate​(Class<T> targetEntity)  
      jakarta.persistence.criteria.CriteriaQuery<Object> createQuery()
      Create a Criteria query object.
      <T> jakarta.persistence.criteria.CriteriaQuery<T> createQuery​(Class<T> resultClass)
      Create a Criteria query object.
      jakarta.persistence.criteria.CriteriaQuery<jakarta.persistence.Tuple> createTupleQuery()
      Create a Criteria query object that returns a tuple of objects as its result.
      jakarta.persistence.criteria.Expression<Date> currentDate()
      Create expression to return current date.
      jakarta.persistence.criteria.Expression<Time> currentTime()
      Create expression to return current time.
      jakarta.persistence.criteria.Expression<Timestamp> currentTimestamp()
      Create expression to return current timestamp.
      jakarta.persistence.criteria.Order desc​(jakarta.persistence.criteria.Expression<?> x)
      Create an ordering by the descending value of the expression.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 diff​(jakarta.persistence.criteria.Expression<? extends N> x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the difference between its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 diff​(jakarta.persistence.criteria.Expression<? extends N> x, N y)
      Create an expression that returns the difference between its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 diff​(N x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the difference between its arguments.
      jakarta.persistence.criteria.Predicate disjunction()
      Create a disjunction (with zero disjuncts).
      jakarta.persistence.criteria.Predicate equal​(jakarta.persistence.criteria.Expression<?> x, jakarta.persistence.criteria.Expression<?> y)
      Create a predicate for testing the arguments for equality.
      jakarta.persistence.criteria.Predicate equal​(jakarta.persistence.criteria.Expression<?> x, Object y)
      Create a predicate for testing the arguments for equality.
      jakarta.persistence.criteria.Predicate exists​(jakarta.persistence.criteria.Subquery<?> subquery)
      Create a predicate testing the existence of a subquery result.
      jakarta.persistence.criteria.Expression fromExpression​(Expression expression)
      ADVANCED: Allow a Criteria Expression to be built from a EclipseLink native API Expression object.
      <T> jakarta.persistence.criteria.Expression<T> fromExpression​(Expression expression, Class<T> type)
      ADVANCED: Allow a Criteria Expression to be built from a EclipseLink native API Expression object.
      <T> jakarta.persistence.criteria.Expression<T> function​(String name, Class<T> type, jakarta.persistence.criteria.Expression<?>... args)
      Create an expression for execution of a database function.
      jakarta.persistence.criteria.Predicate ge​(jakarta.persistence.criteria.Expression<? extends Number> x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create a predicate for testing whether the first argument is greater than or equal to the second.
      jakarta.persistence.criteria.Predicate ge​(jakarta.persistence.criteria.Expression<? extends Number> x, Number y)
      Create a predicate for testing whether the first argument is greater than or equal to the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 greaterThan​(jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create a predicate for testing whether the first argument is greater than the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 greaterThan​(jakarta.persistence.criteria.Expression<? extends Y> x, Y y)
      Create a predicate for testing whether the first argument is greater than the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 greaterThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create a predicate for testing whether the first argument is greater than or equal to the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 greaterThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x, Y y)
      Create a predicate for testing whether the first argument is greater than or equal to the second.
      <X extends Comparable<? super X>>
      jakarta.persistence.criteria.Expression<X>      		 greatest​(jakarta.persistence.criteria.Expression<X> x)
      Create an aggregate expression for finding the greatest of the values (strings, dates, etc).
      jakarta.persistence.criteria.Predicate gt​(jakarta.persistence.criteria.Expression<? extends Number> x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create a predicate for testing whether the first argument is greater than the second.
      jakarta.persistence.criteria.Predicate gt​(jakarta.persistence.criteria.Expression<? extends Number> x, Number y)
      Create a predicate for testing whether the first argument is greater than the second.
      <T> jakarta.persistence.criteria.CriteriaBuilder.In<T> in​(jakarta.persistence.criteria.Expression<? extends T> expression)
      Create predicate to test whether given expression is contained in a list of values.
      protected <T> jakarta.persistence.criteria.Expression<T> internalLiteral​(T value)
      Create an expression literal but without null validation.
      <C extends Collection<?>>
      jakarta.persistence.criteria.Predicate      		 isEmpty​(jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether a collection is empty.
      jakarta.persistence.criteria.Predicate isFalse​(jakarta.persistence.criteria.Expression<Boolean> x)
      Create a predicate testing for a false value.
      <E,​C extends Collection<E>>
      jakarta.persistence.criteria.Predicate      		 isMember​(E elem, jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether an element is a member of a collection.
      <E,​C extends Collection<E>>
      jakarta.persistence.criteria.Predicate      		 isMember​(jakarta.persistence.criteria.Expression<E> elem, jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether an element is a member of a collection.
      <C extends Collection<?>>
      jakarta.persistence.criteria.Predicate      		 isNotEmpty​(jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether a collection is not empty.
      <E,​C extends Collection<E>>
      jakarta.persistence.criteria.Predicate      		 isNotMember​(E elem, jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether an element is not a member of a collection.
      <E,​C extends Collection<E>>
      jakarta.persistence.criteria.Predicate      		 isNotMember​(jakarta.persistence.criteria.Expression<E> elem, jakarta.persistence.criteria.Expression<C> collection)
      Create a predicate that tests whether an element is not a member of a collection.
      jakarta.persistence.criteria.Predicate isNotNull​(jakarta.persistence.criteria.Expression<?> x)
      Create a predicate to test whether the expression is not null.
      jakarta.persistence.criteria.Predicate isNull​(jakarta.persistence.criteria.Expression<?> x)
      Create a predicate to test whether the expression is null.
      jakarta.persistence.criteria.Predicate isTrue​(jakarta.persistence.criteria.Expression<Boolean> x)
      Create a predicate testing for a true value.
      <K,​M extends Map<K,​?>>
      jakarta.persistence.criteria.Expression<Set<K>>      		 keys​(M map)
      Create an expression that returns the keys of a map.
      jakarta.persistence.criteria.Predicate le​(jakarta.persistence.criteria.Expression<? extends Number> x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create a predicate for testing whether the first argument is less than or equal to the second.
      jakarta.persistence.criteria.Predicate le​(jakarta.persistence.criteria.Expression<? extends Number> x, Number y)
      Create a predicate for testing whether the first argument is less than or equal to the second.
      <X extends Comparable<? super X>>
      jakarta.persistence.criteria.Expression<X>      		 least​(jakarta.persistence.criteria.Expression<X> x)
      Create an aggregate expression for finding the least of the values (strings, dates, etc).
      jakarta.persistence.criteria.Expression<Integer> length​(jakarta.persistence.criteria.Expression<String> x)
      Create expression to return length of a string.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 lessThan​(jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create a predicate for testing whether the first argument is less than the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 lessThan​(jakarta.persistence.criteria.Expression<? extends Y> x, Y y)
      Create a predicate for testing whether the first argument is less than the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 lessThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x, jakarta.persistence.criteria.Expression<? extends Y> y)
      Create a predicate for testing whether the first argument is less than or equal to the second.
      <Y extends Comparable<? super Y>>
      jakarta.persistence.criteria.Predicate      		 lessThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x, Y y)
      Create a predicate for testing whether the first argument is less than or equal to the second.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern)
      Create a predicate for testing whether the expression satisfies the given pattern.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern, char escapeChar)
      Create a predicate for testing whether the expression satisfies the given pattern.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern, jakarta.persistence.criteria.Expression<Character> escapeChar)
      Create a predicate for testing whether the expression satisfies the given pattern.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, String pattern)
      Create a predicate for testing whether the expression satisfies the given pattern.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, String pattern, char escapeChar)
      Create a predicate for testing whether the expression satisfies the given pattern.
      jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x, String pattern, jakarta.persistence.criteria.Expression<Character> escapeChar)
      Create a predicate for testing whether the expression satisfies the given pattern.
      <T> jakarta.persistence.criteria.Expression<T> literal​(T value)
      Create an expression literal.
      jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern)
      Create expression to locate the position of one string within another, returning position of first character if found.
      jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern, jakarta.persistence.criteria.Expression<Integer> from)
      Create expression to locate the position of one string within another, returning position of first character if found.
      jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x, String pattern)
      Create expression to locate the position of one string within another, returning position of first character if found.
      jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x, String pattern, int from)
      Create expression to locate the position of one string within another, returning position of first character if found.
      jakarta.persistence.criteria.Expression<String> lower​(jakarta.persistence.criteria.Expression<String> x)
      Create expression for converting a string to lowercase.
      jakarta.persistence.criteria.Predicate lt​(jakarta.persistence.criteria.Expression<? extends Number> x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create a predicate for testing whether the first argument is less than the second.
      jakarta.persistence.criteria.Predicate lt​(jakarta.persistence.criteria.Expression<? extends Number> x, Number y)
      Create a predicate for testing whether the first argument is less than the second.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 max​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression applying the numerical max operation.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 min​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression applying the numerical min operation.
      jakarta.persistence.criteria.Expression<Integer> mod​(jakarta.persistence.criteria.Expression<Integer> x, jakarta.persistence.criteria.Expression<Integer> y)
      Create an expression that returns the modulus of its arguments.
      jakarta.persistence.criteria.Expression<Integer> mod​(jakarta.persistence.criteria.Expression<Integer> x, Integer y)
      Create an expression that returns the modulus of its arguments.
      jakarta.persistence.criteria.Expression<Integer> mod​(Integer x, jakarta.persistence.criteria.Expression<Integer> y)
      Create an expression that returns the modulus of its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 neg​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression that returns the arithmetic negation of its argument.
      jakarta.persistence.criteria.Predicate not​(jakarta.persistence.criteria.Expression<Boolean> restriction)
      Create a negation of the given restriction.
      jakarta.persistence.criteria.Predicate notEqual​(jakarta.persistence.criteria.Expression<?> x, jakarta.persistence.criteria.Expression<?> y)
      Create a predicate for testing the arguments for inequality.
      jakarta.persistence.criteria.Predicate notEqual​(jakarta.persistence.criteria.Expression<?> x, Object y)
      Create a predicate for testing the arguments for inequality.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern, char escapeChar)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<String> pattern, jakarta.persistence.criteria.Expression<Character> escapeChar)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, String pattern)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, String pattern, char escapeChar)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x, String pattern, jakarta.persistence.criteria.Expression<Character> escapeChar)
      Create a predicate for testing whether the expression does not satisfy the given pattern.
      <Y> jakarta.persistence.criteria.Expression<Y> nullif​(jakarta.persistence.criteria.Expression<Y> x, jakarta.persistence.criteria.Expression<?> y)
      Create an expression that tests whether its argument are equal, returning null if they are and the value of the first expression if they are not.
      <Y> jakarta.persistence.criteria.Expression<Y> nullif​(jakarta.persistence.criteria.Expression<Y> x, Y y)
      Create an expression that tests whether its argument are equal, returning null if they are and the value of the first expression if they are not.
      <T> jakarta.persistence.criteria.Expression<T> nullLiteral​(Class<T> resultClass)
      Create an expression for a null literal with the given type.
      jakarta.persistence.criteria.Predicate or​(jakarta.persistence.criteria.Expression<Boolean> x, jakarta.persistence.criteria.Expression<Boolean> y)
      Create a disjunction of the given boolean expressions.
      jakarta.persistence.criteria.Predicate or​(jakarta.persistence.criteria.Predicate... restrictions)
      Create a disjunction of the given restriction predicates.
      <T> jakarta.persistence.criteria.ParameterExpression<T> parameter​(Class<T> paramClass)
      Create a parameter.
      <T> jakarta.persistence.criteria.ParameterExpression<T> parameter​(Class<T> paramClass, String name)
      Create a parameter expression with the given name.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 prod​(jakarta.persistence.criteria.Expression<? extends N> x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the product of its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 prod​(jakarta.persistence.criteria.Expression<? extends N> x, N y)
      Create an expression that returns the product of its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 prod​(N x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the product of its arguments.
      jakarta.persistence.criteria.Expression<Number> quot​(jakarta.persistence.criteria.Expression<? extends Number> x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create an expression that returns the quotient of its arguments.
      jakarta.persistence.criteria.Expression<Number> quot​(jakarta.persistence.criteria.Expression<? extends Number> x, Number y)
      Create an expression that returns the quotient of its arguments.
      jakarta.persistence.criteria.Expression<Number> quot​(Number x, jakarta.persistence.criteria.Expression<? extends Number> y)
      Create an expression that returns the quotient of its arguments.
      <R> jakarta.persistence.criteria.CriteriaBuilder.Case<R> selectCase()
      Create a general case expression.
      <C,​R>
      jakarta.persistence.criteria.CriteriaBuilder.SimpleCase<C,​R>      		 selectCase​(jakarta.persistence.criteria.Expression<? extends C> expression)
      Create simple case expression.
      <C extends Collection<?>>
      jakarta.persistence.criteria.Expression<Integer>      		 size​(C collection)
      Create an expression that tests the size of a collection.
      <C extends Collection<?>>
      jakarta.persistence.criteria.Expression<Integer>      		 size​(jakarta.persistence.criteria.Expression<C> collection)
      Create an expression that tests the size of a collection.
      <Y> jakarta.persistence.criteria.Expression<Y> some​(jakarta.persistence.criteria.Subquery<Y> subquery)
      Create a predicate corresponding to a some expression over the subquery results.
      jakarta.persistence.criteria.Expression<Double> sqrt​(jakarta.persistence.criteria.Expression<? extends Number> x)
      Create an expression that returns the square root of its argument.
      jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x, int from)
      Substring extraction operation.
      jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x, int from, int len)
      Substring extraction operation.
      jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<Integer> from)
      Substring extraction operation.
      jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x, jakarta.persistence.criteria.Expression<Integer> from, jakarta.persistence.criteria.Expression<Integer> len)
      Substring extraction operation.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 sum​(jakarta.persistence.criteria.Expression<? extends N> x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the sum of its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 sum​(jakarta.persistence.criteria.Expression<? extends N> x, N y)
      Create an expression that returns the sum of its arguments.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 sum​(jakarta.persistence.criteria.Expression<N> x)
      Create an expression applying the sum operation.
      <N extends Number>
      jakarta.persistence.criteria.Expression<N>      		 sum​(N x, jakarta.persistence.criteria.Expression<? extends N> y)
      Create an expression that returns the sum of its arguments.
      jakarta.persistence.criteria.Expression<Double> sumAsDouble​(jakarta.persistence.criteria.Expression<Float> x)
      Create an aggregate expression applying the sum operation to a Float-valued expression, returning a Double result.
      jakarta.persistence.criteria.Expression<Long> sumAsLong​(jakarta.persistence.criteria.Expression<Integer> x)
      Create an aggregate expression applying the sum operation to an Integer-valued expression, returning a Long result.
      jakarta.persistence.criteria.Expression<BigDecimal> toBigDecimal​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      jakarta.persistence.criteria.Expression<BigInteger> toBigInteger​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      jakarta.persistence.criteria.Expression<Double> toDouble​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      Expression toExpression​(jakarta.persistence.criteria.Expression expression)
      ADVANCED: Allow a Criteria Expression to be converted to a EclipseLink native API Expression object.
      jakarta.persistence.criteria.Expression<Float> toFloat​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      jakarta.persistence.criteria.Expression<Integer> toInteger​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      jakarta.persistence.criteria.Expression<Long> toLong​(jakarta.persistence.criteria.Expression<? extends Number> number)
      Typecast.
      jakarta.persistence.criteria.Expression<String> toString​(jakarta.persistence.criteria.Expression<Character> character)
      Typecast.
      <X,​T,​E extends T>
      jakarta.persistence.criteria.CollectionJoin<X,​E>      		 treat​(jakarta.persistence.criteria.CollectionJoin<X,​T> join, Class<E> type)  
      <X,​T,​V extends T>
      jakarta.persistence.criteria.Join<X,​V>      		 treat​(jakarta.persistence.criteria.Join<X,​T> join, Class<V> type)  
      <X,​T,​E extends T>
      jakarta.persistence.criteria.ListJoin<X,​E>      		 treat​(jakarta.persistence.criteria.ListJoin<X,​T> join, Class<E> type)  
      <X,​K,​T,​V extends T>
      jakarta.persistence.criteria.MapJoin<X,​K,​V>      		 treat​(jakarta.persistence.criteria.MapJoin<X,​K,​T> join, Class<V> type)  
      <X,​T extends X>
      jakarta.persistence.criteria.Path<T>      		 treat​(jakarta.persistence.criteria.Path<X> path, Class<T> type)  
      <X,​T extends X>
      jakarta.persistence.criteria.Root<T>      		 treat​(jakarta.persistence.criteria.Root<X> root, Class<T> type)  
      <X,​T,​E extends T>
      jakarta.persistence.criteria.SetJoin<X,​E>      		 treat​(jakarta.persistence.criteria.SetJoin<X,​T> join, Class<E> type)  
      jakarta.persistence.criteria.Expression<String> trim​(char t, jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim character from both ends of a string.
      jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts, char t, jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim character from a string.
      jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts, jakarta.persistence.criteria.Expression<Character> t, jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim character from a string.
      jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts, jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim blanks from a string.
      jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.Expression<Character> t, jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim character from both ends of a string.
      jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.Expression<String> x)
      Create expression to trim blanks from both ends of a string.
      jakarta.persistence.criteria.CompoundSelection<jakarta.persistence.Tuple> tuple​(jakarta.persistence.criteria.Selection<?>... selections)  
      jakarta.persistence.criteria.Expression<String> upper​(jakarta.persistence.criteria.Expression<String> x)
      Create expression for converting a string to uppercase.
      <V,​M extends Map<?,​V>>
      jakarta.persistence.criteria.Expression<Collection<V>>      		 values​(M map)
      Create an expression that returns the values of a map.

    • Constructor Detail

      • CriteriaBuilderImpl

        public CriteriaBuilderImpl​(jakarta.persistence.metamodel.Metamodel metamodel)

    • Method Detail

      • createQuery

        public jakarta.persistence.criteria.CriteriaQuery<Object> createQuery()
        Create a Criteria query object.
        Specified by:
        createQuery in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        query object

      • createQuery

        public <T> jakarta.persistence.criteria.CriteriaQuery<T> createQuery​(Class<T> resultClass)
        Create a Criteria query object.
        Specified by:
        createQuery in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        query object

      • createTupleQuery

        public jakarta.persistence.criteria.CriteriaQuery<jakarta.persistence.Tuple> createTupleQuery()
        Create a Criteria query object that returns a tuple of objects as its result.
        Specified by:
        createTupleQuery in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        query object

      • construct

        public <Y> jakarta.persistence.criteria.CompoundSelection<Y> construct​(Class<Y> result,
                                                                       jakarta.persistence.criteria.Selection<?>... selections)
        Define a select list item corresponding to a constructor.
        Specified by:
        construct in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        result - class whose instance is to be constructed
        selections - arguments to the constructor
        Returns:
        selection item

      • tuple

        public jakarta.persistence.criteria.CompoundSelection<jakarta.persistence.Tuple> tuple​(jakarta.persistence.criteria.Selection<?>... selections)
        Specified by:
        tuple in interface jakarta.persistence.criteria.CriteriaBuilder

      • array

        public jakarta.persistence.criteria.CompoundSelection<Object[]> array​(jakarta.persistence.criteria.Selection<?>... selections)
        Create an array-valued selection item
        Specified by:
        array in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        selections - selection items
        Returns:
        array-valued compound selection
        Throws:
        IllegalArgumentException - if an argument is a tuple- or array-valued selection item

      • asc

        public jakarta.persistence.criteria.Order asc​(jakarta.persistence.criteria.Expression<?> x)
        Create an ordering by the ascending value of the expression.
        Specified by:
        asc in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression used to define the ordering
        Returns:
        ascending ordering corresponding to the expression

      • desc

        public jakarta.persistence.criteria.Order desc​(jakarta.persistence.criteria.Expression<?> x)
        Create an ordering by the descending value of the expression.
        Specified by:
        desc in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression used to define the ordering
        Returns:
        descending ordering corresponding to the expression

      • avg

        public <N extends Number> jakarta.persistence.criteria.Expression<Double> avg​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression applying the avg operation.
        Specified by:
        avg in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to avg operation
        Returns:
        avg expression

      • sum

        public <N extends Number> jakarta.persistence.criteria.Expression<N> sum​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression applying the sum operation.
        Specified by:
        sum in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to sum operation
        Returns:
        sum expression

      • max

        public <N extends Number> jakarta.persistence.criteria.Expression<N> max​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression applying the numerical max operation.
        Specified by:
        max in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to max operation
        Returns:
        max expression

      • min

        public <N extends Number> jakarta.persistence.criteria.Expression<N> min​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression applying the numerical min operation.
        Specified by:
        min in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to min operation
        Returns:
        min expression

      • greatest

        public <X extends Comparable<? super X>> jakarta.persistence.criteria.Expression<X> greatest​(jakarta.persistence.criteria.Expression<X> x)
        Create an aggregate expression for finding the greatest of the values (strings, dates, etc).
        Specified by:
        greatest in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to greatest operation
        Returns:
        greatest expression

      • least

        public <X extends Comparable<? super X>> jakarta.persistence.criteria.Expression<X> least​(jakarta.persistence.criteria.Expression<X> x)
        Create an aggregate expression for finding the least of the values (strings, dates, etc).
        Specified by:
        least in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to least operation
        Returns:
        least expression

      • count

        public jakarta.persistence.criteria.Expression<Long> count​(jakarta.persistence.criteria.Expression<?> x)
        Create an expression applying the count operation.
        Specified by:
        count in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to count operation
        Returns:
        count expression

      • countDistinct

        public jakarta.persistence.criteria.Expression<Long> countDistinct​(jakarta.persistence.criteria.Expression<?> x)
        Create an expression applying the count distinct operation.
        Specified by:
        countDistinct in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to count distinct operation
        Returns:
        count distinct expression

      • exists

        public jakarta.persistence.criteria.Predicate exists​(jakarta.persistence.criteria.Subquery<?> subquery)
        Create a predicate testing the existence of a subquery result.
        Specified by:
        exists in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        subquery - subquery whose result is to be tested
        Returns:
        exists predicate

      • all

        public <Y> jakarta.persistence.criteria.Expression<Y> all​(jakarta.persistence.criteria.Subquery<Y> subquery)
        Create a predicate corresponding to an all expression over the subquery results.
        Specified by:
        all in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        subquery -
        Returns:
        all expression

      • some

        public <Y> jakarta.persistence.criteria.Expression<Y> some​(jakarta.persistence.criteria.Subquery<Y> subquery)
        Create a predicate corresponding to a some expression over the subquery results. This is equivalent to an any expression.
        Specified by:
        some in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        subquery -
        Returns:
        all expression

      • any

        public <Y> jakarta.persistence.criteria.Expression<Y> any​(jakarta.persistence.criteria.Subquery<Y> subquery)
        Create a predicate corresponding to an any expression over the subquery results. This is equivalent to a some expression.
        Specified by:
        any in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        subquery -
        Returns:
        any expression

      • and

        public jakarta.persistence.criteria.Predicate and​(jakarta.persistence.criteria.Expression<Boolean> x,
                                                  jakarta.persistence.criteria.Expression<Boolean> y)
        Create a conjunction of the given boolean expressions.
        Specified by:
        and in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - boolean expression
        y - boolean expression
        Returns:
        and predicate

      • or

        public jakarta.persistence.criteria.Predicate or​(jakarta.persistence.criteria.Expression<Boolean> x,
                                                 jakarta.persistence.criteria.Expression<Boolean> y)
        Create a disjunction of the given boolean expressions.
        Specified by:
        or in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - boolean expression
        y - boolean expression
        Returns:
        or predicate

      • and

        public jakarta.persistence.criteria.Predicate and​(jakarta.persistence.criteria.Predicate... restrictions)
        Create a conjunction of the given restriction predicates. A conjunction of zero predicates is true.
        Specified by:
        and in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        restrictions - zero or more restriction predicates
        Returns:
        and predicate

      • or

        public jakarta.persistence.criteria.Predicate or​(jakarta.persistence.criteria.Predicate... restrictions)
        Create a disjunction of the given restriction predicates. A disjunction of zero predicates is false.
        Specified by:
        or in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        restrictions - zero or more restriction predicates
        Returns:
        and predicate

      • not

        public jakarta.persistence.criteria.Predicate not​(jakarta.persistence.criteria.Expression<Boolean> restriction)
        Create a negation of the given restriction.
        Specified by:
        not in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        restriction - restriction expression
        Returns:
        not predicate

      • conjunction

        public jakarta.persistence.criteria.Predicate conjunction()
        Create a conjunction (with zero conjuncts). A conjunction with zero conjuncts is true.
        Specified by:
        conjunction in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        and predicate

      • disjunction

        public jakarta.persistence.criteria.Predicate disjunction()
        Create a disjunction (with zero disjuncts). A disjunction with zero disjuncts is false.
        Specified by:
        disjunction in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        or predicate

      • isTrue

        public jakarta.persistence.criteria.Predicate isTrue​(jakarta.persistence.criteria.Expression<Boolean> x)
        Create a predicate testing for a true value.
        Specified by:
        isTrue in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression to be tested if true
        Returns:
        predicate

      • isFalse

        public jakarta.persistence.criteria.Predicate isFalse​(jakarta.persistence.criteria.Expression<Boolean> x)
        Create a predicate testing for a false value.
        Specified by:
        isFalse in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression to be tested if false
        Returns:
        predicate

      • isNull

        public jakarta.persistence.criteria.Predicate isNull​(jakarta.persistence.criteria.Expression<?> x)
        Create a predicate to test whether the expression is null.
        Specified by:
        isNull in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        Returns:
        predicate

      • isNotNull

        public jakarta.persistence.criteria.Predicate isNotNull​(jakarta.persistence.criteria.Expression<?> x)
        Create a predicate to test whether the expression is not null.
        Specified by:
        isNotNull in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        Returns:
        predicate

      • equal

        public jakarta.persistence.criteria.Predicate equal​(jakarta.persistence.criteria.Expression<?> x,
                                                    jakarta.persistence.criteria.Expression<?> y)
        Create a predicate for testing the arguments for equality.
        Specified by:
        equal in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        equality predicate

      • notEqual

        public jakarta.persistence.criteria.Predicate notEqual​(jakarta.persistence.criteria.Expression<?> x,
                                                       jakarta.persistence.criteria.Expression<?> y)
        Create a predicate for testing the arguments for inequality.
        Specified by:
        notEqual in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        inequality predicate

      • equal

        public jakarta.persistence.criteria.Predicate equal​(jakarta.persistence.criteria.Expression<?> x,
                                                    Object y)
        Create a predicate for testing the arguments for equality.
        Specified by:
        equal in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - object
        Returns:
        equality predicate

      • notEqual

        public jakarta.persistence.criteria.Predicate notEqual​(jakarta.persistence.criteria.Expression<?> x,
                                                       Object y)
        Create a predicate for testing the arguments for inequality.
        Specified by:
        notEqual in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - object
        Returns:
        inequality predicate

      • greaterThan

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate greaterThan​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                            jakarta.persistence.criteria.Expression<? extends Y> y)
        Create a predicate for testing whether the first argument is greater than the second.
        Specified by:
        greaterThan in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        greater-than predicate

      • lessThan

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate lessThan​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                         jakarta.persistence.criteria.Expression<? extends Y> y)
        Create a predicate for testing whether the first argument is less than the second.
        Specified by:
        lessThan in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        less-than predicate

      • greaterThanOrEqualTo

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate greaterThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                                     jakarta.persistence.criteria.Expression<? extends Y> y)
        Create a predicate for testing whether the first argument is greater than or equal to the second.
        Specified by:
        greaterThanOrEqualTo in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        greater-than-or-equal predicate

      • lessThanOrEqualTo

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate lessThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                                  jakarta.persistence.criteria.Expression<? extends Y> y)
        Create a predicate for testing whether the first argument is less than or equal to the second.
        Specified by:
        lessThanOrEqualTo in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        less-than-or-equal predicate

      • between

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate between​(jakarta.persistence.criteria.Expression<? extends Y> v,
                                                                                        jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                        jakarta.persistence.criteria.Expression<? extends Y> y)
        Create a predicate for testing whether the first argument is between the second and third arguments in value.
        Specified by:
        between in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        v - expression
        x - expression
        y - expression
        Returns:
        between predicate

      • greaterThan

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate greaterThan​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                            Y y)
        Create a predicate for testing whether the first argument is greater than the second.
        Specified by:
        greaterThan in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        greater-than predicate

      • lessThan

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate lessThan​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                         Y y)
        Create a predicate for testing whether the first argument is less than the second.
        Specified by:
        lessThan in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        less-than predicate

      • greaterThanOrEqualTo

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate greaterThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                                     Y y)
        Create a predicate for testing whether the first argument is greater than or equal to the second.
        Specified by:
        greaterThanOrEqualTo in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        greater-than-or-equal predicate

      • lessThanOrEqualTo

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate lessThanOrEqualTo​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                                                                  Y y)
        Create a predicate for testing whether the first argument is less than or equal to the second.
        Specified by:
        lessThanOrEqualTo in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        less-than-or-equal predicate

      • between

        public <Y extends Comparable<? super Y>> jakarta.persistence.criteria.Predicate between​(jakarta.persistence.criteria.Expression<? extends Y> v,
                                                                                        Y x,
                                                                                        Y y)
        Create a predicate for testing whether the first argument is between the second and third arguments in value.
        Specified by:
        between in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        v - expression
        x - value
        y - value
        Returns:
        between predicate

      • buildList

        protected List<jakarta.persistence.criteria.Expression<?>> buildList​(jakarta.persistence.criteria.Expression<?>... expressions)

      • gt

        public jakarta.persistence.criteria.Predicate gt​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 jakarta.persistence.criteria.Expression<? extends Number> y)
        Create a predicate for testing whether the first argument is greater than the second.
        Specified by:
        gt in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        greater-than predicate

      • lt

        public jakarta.persistence.criteria.Predicate lt​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 jakarta.persistence.criteria.Expression<? extends Number> y)
        Create a predicate for testing whether the first argument is less than the second.
        Specified by:
        lt in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        less-than predicate

      • ge

        public jakarta.persistence.criteria.Predicate ge​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 jakarta.persistence.criteria.Expression<? extends Number> y)
        Create a predicate for testing whether the first argument is greater than or equal to the second.
        Specified by:
        ge in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        greater-than-or-equal predicate

      • le

        public jakarta.persistence.criteria.Predicate le​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 jakarta.persistence.criteria.Expression<? extends Number> y)
        Create a predicate for testing whether the first argument is less than or equal to the second.
        Specified by:
        le in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        less-than-or-equal predicate

      • gt

        public jakarta.persistence.criteria.Predicate gt​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 Number y)
        Create a predicate for testing whether the first argument is greater than the second.
        Specified by:
        gt in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        greater-than predicate

      • lt

        public jakarta.persistence.criteria.Predicate lt​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 Number y)
        Create a predicate for testing whether the first argument is less than the second.
        Specified by:
        lt in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        less-than predicate

      • ge

        public jakarta.persistence.criteria.Predicate ge​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 Number y)
        Create a predicate for testing whether the first argument is greater than or equal to the second.
        Specified by:
        ge in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        greater-than-or-equal predicate

      • le

        public jakarta.persistence.criteria.Predicate le​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                 Number y)
        Create a predicate for testing whether the first argument is less than or equal to the second.
        Specified by:
        le in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        less-than-or-equal predicate

      • neg

        public <N extends Number> jakarta.persistence.criteria.Expression<N> neg​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression that returns the arithmetic negation of its argument.
        Specified by:
        neg in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        Returns:
        negated expression

      • abs

        public <N extends Number> jakarta.persistence.criteria.Expression<N> abs​(jakarta.persistence.criteria.Expression<N> x)
        Create an expression that returns the absolute value of its argument.
        Specified by:
        abs in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        Returns:
        absolute value

      • sum

        public <N extends Number> jakarta.persistence.criteria.Expression<N> sum​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                         jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the sum of its arguments.
        Specified by:
        sum in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        sum

      • sumAsLong

        public jakarta.persistence.criteria.Expression<Long> sumAsLong​(jakarta.persistence.criteria.Expression<Integer> x)
        Create an aggregate expression applying the sum operation to an Integer-valued expression, returning a Long result.
        Specified by:
        sumAsLong in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to sum operation
        Returns:
        sum expression

      • sumAsDouble

        public jakarta.persistence.criteria.Expression<Double> sumAsDouble​(jakarta.persistence.criteria.Expression<Float> x)
        Create an aggregate expression applying the sum operation to a Float-valued expression, returning a Double result.
        Specified by:
        sumAsDouble in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression representing input value to sum operation
        Returns:
        sum expression

      • prod

        public <N extends Number> jakarta.persistence.criteria.Expression<N> prod​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                          jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the product of its arguments.
        Specified by:
        prod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        product

      • diff

        public <N extends Number> jakarta.persistence.criteria.Expression<N> diff​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                          jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the difference between its arguments.
        Specified by:
        diff in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        difference

      • sum

        public <N extends Number> jakarta.persistence.criteria.Expression<N> sum​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                         N y)
        Create an expression that returns the sum of its arguments.
        Specified by:
        sum in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        sum

      • prod

        public <N extends Number> jakarta.persistence.criteria.Expression<N> prod​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                          N y)
        Create an expression that returns the product of its arguments.
        Specified by:
        prod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        product

      • diff

        public <N extends Number> jakarta.persistence.criteria.Expression<N> diff​(jakarta.persistence.criteria.Expression<? extends N> x,
                                                                          N y)
        Create an expression that returns the difference between its arguments.
        Specified by:
        diff in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        difference

      • sum

        public <N extends Number> jakarta.persistence.criteria.Expression<N> sum​(N x,
                                                                         jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the sum of its arguments.
        Specified by:
        sum in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - value
        y - expression
        Returns:
        sum

      • prod

        public <N extends Number> jakarta.persistence.criteria.Expression<N> prod​(N x,
                                                                          jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the product of its arguments.
        Specified by:
        prod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - value
        y - expression
        Returns:
        product

      • diff

        public <N extends Number> jakarta.persistence.criteria.Expression<N> diff​(N x,
                                                                          jakarta.persistence.criteria.Expression<? extends N> y)
        Create an expression that returns the difference between its arguments.
        Specified by:
        diff in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - value
        y - expression
        Returns:
        difference

      • quot

        public jakarta.persistence.criteria.Expression<Number> quot​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                            jakarta.persistence.criteria.Expression<? extends Number> y)
        Create an expression that returns the quotient of its arguments.
        Specified by:
        quot in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        quotient

      • quot

        public jakarta.persistence.criteria.Expression<Number> quot​(jakarta.persistence.criteria.Expression<? extends Number> x,
                                                            Number y)
        Create an expression that returns the quotient of its arguments.
        Specified by:
        quot in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        quotient

      • quot

        public jakarta.persistence.criteria.Expression<Number> quot​(Number x,
                                                            jakarta.persistence.criteria.Expression<? extends Number> y)
        Create an expression that returns the quotient of its arguments.
        Specified by:
        quot in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - value
        y - expression
        Returns:
        quotient

      • mod

        public jakarta.persistence.criteria.Expression<Integer> mod​(jakarta.persistence.criteria.Expression<Integer> x,
                                                            jakarta.persistence.criteria.Expression<Integer> y)
        Create an expression that returns the modulus of its arguments.
        Specified by:
        mod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        modulus

      • mod

        public jakarta.persistence.criteria.Expression<Integer> mod​(jakarta.persistence.criteria.Expression<Integer> x,
                                                            Integer y)
        Create an expression that returns the modulus of its arguments.
        Specified by:
        mod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        modulus

      • mod

        public jakarta.persistence.criteria.Expression<Integer> mod​(Integer x,
                                                            jakarta.persistence.criteria.Expression<Integer> y)
        Create an expression that returns the modulus of its arguments.
        Specified by:
        mod in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - value
        y - expression
        Returns:
        modulus

      • sqrt

        public jakarta.persistence.criteria.Expression<Double> sqrt​(jakarta.persistence.criteria.Expression<? extends Number> x)
        Create an expression that returns the square root of its argument.
        Specified by:
        sqrt in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        Returns:
        modulus

      • toLong

        public jakarta.persistence.criteria.Expression<Long> toLong​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toLong in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<Long>

      • toInteger

        public jakarta.persistence.criteria.Expression<Integer> toInteger​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toInteger in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<Integer>

      • toFloat

        public jakarta.persistence.criteria.Expression<Float> toFloat​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toFloat in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<Float>

      • toDouble

        public jakarta.persistence.criteria.Expression<Double> toDouble​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toDouble in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<Double>

      • toBigDecimal

        public jakarta.persistence.criteria.Expression<BigDecimal> toBigDecimal​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toBigDecimal in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<BigDecimal>

      • toBigInteger

        public jakarta.persistence.criteria.Expression<BigInteger> toBigInteger​(jakarta.persistence.criteria.Expression<? extends Number> number)
        Typecast.
        Specified by:
        toBigInteger in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        number - numeric expression
        Returns:
        Expression<BigInteger>

      • toString

        public jakarta.persistence.criteria.Expression<String> toString​(jakarta.persistence.criteria.Expression<Character> character)
        Typecast.
        Specified by:
        toString in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        character - expression
        Returns:
        Expression<String>

      • literal

        public <T> jakarta.persistence.criteria.Expression<T> literal​(T value)
        Create an expression literal.
        Specified by:
        literal in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        value -
        Returns:
        expression literal

      • nullLiteral

        public <T> jakarta.persistence.criteria.Expression<T> nullLiteral​(Class<T> resultClass)
        Create an expression for a null literal with the given type.
        Specified by:
        nullLiteral in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        resultClass - type of the null literal
        Returns:
        null expression literal

      • internalLiteral

        protected <T> jakarta.persistence.criteria.Expression<T> internalLiteral​(T value)
        Create an expression literal but without null validation.
        Parameters:
        value -
        Returns:
        expression literal

      • parameter

        public <T> jakarta.persistence.criteria.ParameterExpression<T> parameter​(Class<T> paramClass)
        Create a parameter. Create a parameter expression.
        Specified by:
        parameter in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        paramClass - parameter class
        Returns:
        parameter expression

      • parameter

        public <T> jakarta.persistence.criteria.ParameterExpression<T> parameter​(Class<T> paramClass,
                                                                         String name)
        Create a parameter expression with the given name.
        Specified by:
        parameter in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        paramClass - parameter class
        name -
        Returns:
        parameter

      • isEmpty

        public <C extends Collection<?>> jakarta.persistence.criteria.Predicate isEmpty​(jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether a collection is empty.
        Specified by:
        isEmpty in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        collection - expression
        Returns:
        predicate

      • isNotEmpty

        public <C extends Collection<?>> jakarta.persistence.criteria.Predicate isNotEmpty​(jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether a collection is not empty.
        Specified by:
        isNotEmpty in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        collection - expression
        Returns:
        predicate

      • size

        public <C extends Collection<?>> jakarta.persistence.criteria.Expression<Integer> size​(C collection)
        Create an expression that tests the size of a collection.
        Specified by:
        size in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        collection -
        Returns:
        size expression

      • size

        public <C extends Collection<?>> jakarta.persistence.criteria.Expression<Integer> size​(jakarta.persistence.criteria.Expression<C> collection)
        Create an expression that tests the size of a collection.
        Specified by:
        size in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        collection - expression
        Returns:
        size expression

      • isMember

        public <E,​C extends Collection<E>> jakarta.persistence.criteria.Predicate isMember​(E elem,
                                                                                         jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether an element is a member of a collection.
        Specified by:
        isMember in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        elem - element
        collection - expression
        Returns:
        predicate

      • isNotMember

        public <E,​C extends Collection<E>> jakarta.persistence.criteria.Predicate isNotMember​(E elem,
                                                                                            jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether an element is not a member of a collection.
        Specified by:
        isNotMember in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        elem - element
        collection - expression
        Returns:
        predicate

      • isMember

        public <E,​C extends Collection<E>> jakarta.persistence.criteria.Predicate isMember​(jakarta.persistence.criteria.Expression<E> elem,
                                                                                         jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether an element is a member of a collection.
        Specified by:
        isMember in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        elem - element expression
        collection - expression
        Returns:
        predicate

      • isNotMember

        public <E,​C extends Collection<E>> jakarta.persistence.criteria.Predicate isNotMember​(jakarta.persistence.criteria.Expression<E> elem,
                                                                                            jakarta.persistence.criteria.Expression<C> collection)
        Create a predicate that tests whether an element is not a member of a collection.
        Specified by:
        isNotMember in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        elem - element expression
        collection - expression
        Returns:
        predicate

      • values

        public <V,​M extends Map<?,​V>> jakarta.persistence.criteria.Expression<Collection<V>> values​(M map)
        Create an expression that returns the values of a map.
        Specified by:
        values in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        map -
        Returns:
        collection expression

      • keys

        public <K,​M extends Map<K,​?>> jakarta.persistence.criteria.Expression<Set<K>> keys​(M map)
        Create an expression that returns the keys of a map.
        Specified by:
        keys in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        map -
        Returns:
        set expression

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   jakarta.persistence.criteria.Expression<String> pattern)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        Returns:
        like predicate

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   jakarta.persistence.criteria.Expression<String> pattern,
                                                   jakarta.persistence.criteria.Expression<Character> escapeChar)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        escapeChar - escape character expression
        Returns:
        like predicate

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   jakarta.persistence.criteria.Expression<String> pattern,
                                                   char escapeChar)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        escapeChar - escape character
        Returns:
        like predicate

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   String pattern)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        Returns:
        like predicate

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   String pattern,
                                                   jakarta.persistence.criteria.Expression<Character> escapeChar)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        escapeChar - escape character expression
        Returns:
        like predicate

      • like

        public jakarta.persistence.criteria.Predicate like​(jakarta.persistence.criteria.Expression<String> x,
                                                   String pattern,
                                                   char escapeChar)
        Create a predicate for testing whether the expression satisfies the given pattern.
        Specified by:
        like in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        escapeChar - escape character
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      jakarta.persistence.criteria.Expression<String> pattern)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      jakarta.persistence.criteria.Expression<String> pattern,
                                                      jakarta.persistence.criteria.Expression<Character> escapeChar)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        escapeChar - escape character expression
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      jakarta.persistence.criteria.Expression<String> pattern,
                                                      char escapeChar)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string expression
        escapeChar - escape character
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      String pattern)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      String pattern,
                                                      jakarta.persistence.criteria.Expression<Character> escapeChar)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        escapeChar - escape character expression
        Returns:
        like predicate

      • notLike

        public jakarta.persistence.criteria.Predicate notLike​(jakarta.persistence.criteria.Expression<String> x,
                                                      String pattern,
                                                      char escapeChar)
        Create a predicate for testing whether the expression does not satisfy the given pattern.
        Specified by:
        notLike in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        pattern - string
        escapeChar - escape character
        Returns:
        like predicate

      • concat

        public jakarta.persistence.criteria.Expression<String> concat​(jakarta.persistence.criteria.Expression<String> x,
                                                              jakarta.persistence.criteria.Expression<String> y)
        String concatenation operation.
        Specified by:
        concat in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        y - string expression
        Returns:
        expression corresponding to concatenation

      • concat

        public jakarta.persistence.criteria.Expression<String> concat​(jakarta.persistence.criteria.Expression<String> x,
                                                              String y)
        String concatenation operation.
        Specified by:
        concat in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        y - string
        Returns:
        expression corresponding to concatenation

      • concat

        public jakarta.persistence.criteria.Expression<String> concat​(String x,
                                                              jakarta.persistence.criteria.Expression<String> y)
        String concatenation operation.
        Specified by:
        concat in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string
        y - string expression
        Returns:
        expression corresponding to concatenation

      • substring

        public jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x,
                                                                 jakarta.persistence.criteria.Expression<Integer> from)
        Substring extraction operation. Extracts a substring starting at specified position through to end of the string. First position is 1.
        Specified by:
        substring in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        from - start position expression
        Returns:
        expression corresponding to substring extraction

      • substring

        public jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x,
                                                                 int from)
        Substring extraction operation. Extracts a substring starting at specified position through to end of the string. First position is 1.
        Specified by:
        substring in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        from - start position
        Returns:
        expression corresponding to substring extraction

      • substring

        public jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x,
                                                                 jakarta.persistence.criteria.Expression<Integer> from,
                                                                 jakarta.persistence.criteria.Expression<Integer> len)
        Substring extraction operation. Extracts a substring of given length starting at specified position. First position is 1.
        Specified by:
        substring in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        from - start position expression
        len - length expression
        Returns:
        expression corresponding to substring extraction

      • substring

        public jakarta.persistence.criteria.Expression<String> substring​(jakarta.persistence.criteria.Expression<String> x,
                                                                 int from,
                                                                 int len)
        Substring extraction operation. Extracts a substring of given length starting at specified position. First position is 1.
        Specified by:
        substring in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        from - start position
        len - length
        Returns:
        expression corresponding to substring extraction

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim blanks from both ends of a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression for string to trim
        Returns:
        trim expression

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts,
                                                            jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim blanks from a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        ts - trim specification
        x - expression for string to trim
        Returns:
        trim expression

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.Expression<Character> t,
                                                            jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim character from both ends of a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        t - expression for character to be trimmed
        x - expression for string to trim
        Returns:
        trim expression

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts,
                                                            jakarta.persistence.criteria.Expression<Character> t,
                                                            jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim character from a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        ts - trim specification
        t - expression for character to be trimmed
        x - expression for string to trim
        Returns:
        trim expression

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(char t,
                                                            jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim character from both ends of a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        t - character to be trimmed
        x - expression for string to trim
        Returns:
        trim expression

      • trim

        public jakarta.persistence.criteria.Expression<String> trim​(jakarta.persistence.criteria.CriteriaBuilder.Trimspec ts,
                                                            char t,
                                                            jakarta.persistence.criteria.Expression<String> x)
        Create expression to trim character from a string.
        Specified by:
        trim in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        ts - trim specification
        t - character to be trimmed
        x - expression for string to trim
        Returns:
        trim expression

      • lower

        public jakarta.persistence.criteria.Expression<String> lower​(jakarta.persistence.criteria.Expression<String> x)
        Create expression for converting a string to lowercase.
        Specified by:
        lower in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        Returns:
        expression to convert to lowercase

      • upper

        public jakarta.persistence.criteria.Expression<String> upper​(jakarta.persistence.criteria.Expression<String> x)
        Create expression for converting a string to uppercase.
        Specified by:
        upper in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        Returns:
        expression to convert to uppercase

      • length

        public jakarta.persistence.criteria.Expression<Integer> length​(jakarta.persistence.criteria.Expression<String> x)
        Create expression to return length of a string.
        Specified by:
        length in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - string expression
        Returns:
        length expression

      • locate

        public jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x,
                                                               jakarta.persistence.criteria.Expression<String> pattern)
        Create expression to locate the position of one string within another, returning position of first character if found. The first position in a string is denoted by 1. If the string to be located is not found, 0 is returned.
        Specified by:
        locate in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression for string to be searched
        pattern - expression for string to be located
        Returns:
        expression corresponding to position

      • locate

        public jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x,
                                                               jakarta.persistence.criteria.Expression<String> pattern,
                                                               jakarta.persistence.criteria.Expression<Integer> from)
        Create expression to locate the position of one string within another, returning position of first character if found. The first position in a string is denoted by 1. If the string to be located is not found, 0 is returned.
        Specified by:
        locate in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression for string to be searched
        pattern - expression for string to be located
        from - expression for position at which to start search
        Returns:
        expression corresponding to position

      • locate

        public jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x,
                                                               String pattern)
        Create expression to locate the position of one string within another, returning position of first character if found. The first position in a string is denoted by 1. If the string to be located is not found, 0 is returned.
        Specified by:
        locate in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression for string to be searched
        pattern - string to be located
        Returns:
        expression corresponding to position

      • locate

        public jakarta.persistence.criteria.Expression<Integer> locate​(jakarta.persistence.criteria.Expression<String> x,
                                                               String pattern,
                                                               int from)
        Create expression to locate the position of one string within another, returning position of first character if found. The first position in a string is denoted by 1. If the string to be located is not found, 0 is returned.
        Specified by:
        locate in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression for string to be searched
        pattern - string to be located
        from - position at which to start search
        Returns:
        expression corresponding to position

      • currentDate

        public jakarta.persistence.criteria.Expression<Date> currentDate()
        Create expression to return current date.
        Specified by:
        currentDate in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        expression for current date

      • currentTimestamp

        public jakarta.persistence.criteria.Expression<Timestamp> currentTimestamp()
        Create expression to return current timestamp.
        Specified by:
        currentTimestamp in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        expression for current timestamp

      • currentTime

        public jakarta.persistence.criteria.Expression<Time> currentTime()
        Create expression to return current time.
        Specified by:
        currentTime in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        expression for current time

      • in

        public <T> jakarta.persistence.criteria.CriteriaBuilder.In<T> in​(jakarta.persistence.criteria.Expression<? extends T> expression)
        Create predicate to test whether given expression is contained in a list of values.
        Specified by:
        in in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        expression - to be tested against list of values
        Returns:
        in predicate

      • coalesce

        public <Y> jakarta.persistence.criteria.Expression<Y> coalesce​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                               jakarta.persistence.criteria.Expression<? extends Y> y)
        Create an expression that returns null if all its arguments evaluate to null, and the value of the first non-null argument otherwise.
        Specified by:
        coalesce in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        expression corresponding to the given coalesce expression

      • coalesce

        public <Y> jakarta.persistence.criteria.Expression<Y> coalesce​(jakarta.persistence.criteria.Expression<? extends Y> x,
                                                               Y y)
        Create an expression that returns null if all its arguments evaluate to null, and the value of the first non-null argument otherwise.
        Specified by:
        coalesce in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        coalesce expression

      • nullif

        public <Y> jakarta.persistence.criteria.Expression<Y> nullif​(jakarta.persistence.criteria.Expression<Y> x,
                                                             jakarta.persistence.criteria.Expression<?> y)
        Create an expression that tests whether its argument are equal, returning null if they are and the value of the first expression if they are not.
        Specified by:
        nullif in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - expression
        Returns:
        expression corresponding to the given nullif expression

      • nullif

        public <Y> jakarta.persistence.criteria.Expression<Y> nullif​(jakarta.persistence.criteria.Expression<Y> x,
                                                             Y y)
        Create an expression that tests whether its argument are equal, returning null if they are and the value of the first expression if they are not.
        Specified by:
        nullif in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        x - expression
        y - value
        Returns:
        expression corresponding to the given nullif expression

      • coalesce

        public <T> jakarta.persistence.criteria.CriteriaBuilder.Coalesce<T> coalesce()
        Create a coalesce expression.
        Specified by:
        coalesce in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        coalesce expression

      • selectCase

        public <C,​R> jakarta.persistence.criteria.CriteriaBuilder.SimpleCase<C,​R> selectCase​(jakarta.persistence.criteria.Expression<? extends C> expression)
        Create simple case expression.
        Specified by:
        selectCase in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        expression - to be tested against the case conditions
        Returns:
        simple case expression

      • selectCase

        public <R> jakarta.persistence.criteria.CriteriaBuilder.Case<R> selectCase()
        Create a general case expression.
        Specified by:
        selectCase in interface jakarta.persistence.criteria.CriteriaBuilder
        Returns:
        general case expression

      • function

        public <T> jakarta.persistence.criteria.Expression<T> function​(String name,
                                                               Class<T> type,
                                                               jakarta.persistence.criteria.Expression<?>... args)
        Create an expression for execution of a database function.
        Specified by:
        function in interface jakarta.persistence.criteria.CriteriaBuilder
        Parameters:
        name - function name
        type - expected result type
        args - function arguments
        Returns:
        expression

      • fromExpression

        public <T> jakarta.persistence.criteria.Expression<T> fromExpression​(Expression expression,
                                                                     Class<T> type)
        ADVANCED: Allow a Criteria Expression to be built from a EclipseLink native API Expression object. This allows for an extended functionality supported in EclipseLink Expressions to be used in Criteria.
        Specified by:
        fromExpression in interface JpaCriteriaBuilder

      • fromExpression

        public jakarta.persistence.criteria.Expression fromExpression​(Expression expression)
        ADVANCED: Allow a Criteria Expression to be built from a EclipseLink native API Expression object. This allows for an extended functionality supported in EclipseLink Expressions to be used in Criteria.
        Specified by:
        fromExpression in interface JpaCriteriaBuilder

      • toExpression

        public Expression toExpression​(jakarta.persistence.criteria.Expression expression)
        ADVANCED: Allow a Criteria Expression to be converted to a EclipseLink native API Expression object. This allows for roots and paths defined in the Criteria to be used with EclipseLink native API Expresions.
        Specified by:
        toExpression in interface JpaCriteriaBuilder

      • createCriteriaDelete

        public <T> jakarta.persistence.criteria.CriteriaDelete<T> createCriteriaDelete​(Class<T> targetEntity)
        Specified by:
        createCriteriaDelete in interface jakarta.persistence.criteria.CriteriaBuilder

      • createCriteriaUpdate

        public <T> jakarta.persistence.criteria.CriteriaUpdate<T> createCriteriaUpdate​(Class<T> targetEntity)
        Specified by:
        createCriteriaUpdate in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T,​V extends T> jakarta.persistence.criteria.Join<X,​V> treat​(jakarta.persistence.criteria.Join<X,​T> join,
                                                                                        Class<V> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T,​E extends T> jakarta.persistence.criteria.CollectionJoin<X,​E> treat​(jakarta.persistence.criteria.CollectionJoin<X,​T> join,
                                                                                                  Class<E> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T,​E extends T> jakarta.persistence.criteria.SetJoin<X,​E> treat​(jakarta.persistence.criteria.SetJoin<X,​T> join,
                                                                                           Class<E> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T,​E extends T> jakarta.persistence.criteria.ListJoin<X,​E> treat​(jakarta.persistence.criteria.ListJoin<X,​T> join,
                                                                                            Class<E> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​K,​T,​V extends T> jakarta.persistence.criteria.MapJoin<X,​K,​V> treat​(jakarta.persistence.criteria.MapJoin<X,​K,​T> join,
                                                                                                           Class<V> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T extends X> jakarta.persistence.criteria.Path<T> treat​(jakarta.persistence.criteria.Path<X> path,
                                                                        Class<T> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder

      • treat

        public <X,​T extends X> jakarta.persistence.criteria.Root<T> treat​(jakarta.persistence.criteria.Root<X> root,
                                                                        Class<T> type)
        Specified by:
        treat in interface jakarta.persistence.criteria.CriteriaBuilder