public interface LongStream extends ExprStream<Long,Expression<Long>>
SearchStream containing Long values.QueryStream.Builder| Modifier and Type | Method and Description |
|---|---|
<R> LongStream |
addRoot(Ref<R,? super Root<R>> ref,
Class<R> type)
Bind an unbound reference to a new query root that will be added to the query.
|
DoubleStream |
asDoubleStream() |
DoubleValue |
average() |
LongStream |
bind(Ref<Long,? super Expression<Long>> ref)
Bind an unbound reference to the items in this stream.
|
<X2,S2 extends Selection<X2>> |
bind(Ref<X2,? super S2> ref,
Function<? super Expression<Long>,? extends S2> refFunction)
Bind an unbound reference to the result of applying the given function to the items in this stream.
|
LongStream |
distinct()
Suppress duplicates.
|
LongStream |
filter(Function<? super Expression<Long>,? extends Expression<Boolean>> predicateBuilder)
Filter results using the boolean expression produced by the given function.
|
LongValue |
findAny()
Find any instance in the stream.
|
LongValue |
findFirst()
Find the first instance in the stream.
|
LongValue |
findSingle()
Find the only instance in the stream.
|
LongStream |
groupBy(Function<? super Expression<Long>,? extends Expression<?>> groupFunction)
Apply grouping based on a single expression.
|
LongStream |
groupBy(Ref<?,? extends Expression<?>> ref)
Apply grouping based on an expression reference.
|
LongStream |
groupByMulti(Function<? super Expression<Long>,? extends List<Expression<?>>> groupFunction)
Apply grouping based on a list of expressions.
|
LongStream |
having(Function<? super Expression<Long>,? extends Expression<Boolean>> havingFunction)
Add a "having" restriction.
|
LongStream |
limit(int maxSize)
Return this stream truncated to the specified maximum length.
|
LongValue |
max() |
LongValue |
min() |
LongStream |
orderBy(Function<? super Expression<Long>,? extends Expression<?>> orderExprFunction,
boolean asc)
Order results using the
Expression produced by the given Function. |
LongStream |
orderBy(Order... orders)
Order results using the specified
Orders. |
LongStream |
orderBy(Ref<?,? extends Expression<?>> ref,
boolean asc)
Order results using the specified expression reference.
|
LongStream |
orderByMulti(Function<? super Expression<Long>,? extends List<? extends Order>> orderListFunction)
|
LongStream |
peek(Consumer<? super Expression<Long>> peeker)
Peek at the items in this stream.
|
LongStream |
skip(int num)
Return this stream with the specified number of initial elements skipped.
|
LongValue |
sum() |
LongStream |
thenOrderBy(Function<? super Expression<Long>,? extends Expression<?>> orderExprFunction,
boolean asc)
Order results using the
Expression produced by the given Function after existing sort. |
LongStream |
thenOrderBy(Order... orders)
Order results using the specified
Orders after existing sort. |
LongStream |
thenOrderBy(Ref<?,? extends Expression<?>> ref,
boolean asc)
Order results using the specified expression reference after existing sort.
|
LongStream |
withFetchGraph(String name)
Configure a fetch graph for this query.
|
LongStream |
withFlushMode(FlushModeType flushMode)
Set the
FlushModeType associated with this query. |
LongStream |
withHint(String name,
Object value)
Associate a hint with this query.
|
LongStream |
withHints(Map<String,Object> hints)
Associate hints with this query.
|
LongStream |
withLoadGraph(String name)
Configure a load graph for this query.
|
LongStream |
withLockMode(LockModeType lockMode)
Set the
LockModeType associated with this query. |
LongStream |
withParam(Parameter<Calendar> parameter,
Calendar value,
TemporalType temporalType)
Bind the value of a query parameter of type
Calendar. |
LongStream |
withParam(Parameter<Date> parameter,
Date value,
TemporalType temporalType)
Bind the value of a query parameter of type
Date. |
<T> LongStream |
withParam(Parameter<T> parameter,
T value)
Bind the value of a query parameter.
|
LongStream |
withParams(Iterable<? extends ParamBinding<?>> params)
Associate parameter bindings with this query.
|
asSubquery, count, countDistinct, exists, fetch, fetch, fetch, fetch, filter, groupBy, orderBy, orderBy, orderBy, thenOrderByallMatch, allMatch, anyMatch, anyMatch, flatMap, flatMap, flatMap, flatMapKeys, flatMapValues, getQueryType, getResultList, getResultStream, isEmpty, join, join, join, join, join, join, join, join, join, join, join, join, join, join, join, map, map, map, map, mapToDouble, mapToDouble, mapToExpr, mapToFrom, mapToInt, mapToInt, mapToLong, mapToLong, mapToPath, mapToRef, mapToRef, mapToRef, mapToRef, mapToRoot, mapToSelection, noneMatch, noneMatchgetEntityManager, getFirstResult, getFlushMode, getHints, getLockMode, getMaxResults, getParams, newBuilder, toCriteriaQuery, toQueryconfigureDoubleValue average()
LongValue max()
LongValue min()
LongValue sum()
DoubleStream asDoubleStream()
LongStream distinct()
SearchStreamdistinct in interface ExprStream<Long,Expression<Long>>distinct in interface SearchStream<Long,Expression<Long>>LongStream orderBy(Ref<?,? extends Expression<?>> ref, boolean asc)
SearchStreamReplaces any existing sort ordering.
orderBy in interface ExprStream<Long,Expression<Long>>orderBy in interface SearchStream<Long,Expression<Long>>ref - previously bound expression referenceasc - true for ascending, false for descendingLongStream orderBy(Function<? super Expression<Long>,? extends Expression<?>> orderExprFunction, boolean asc)
SearchStreamExpression produced by the given Function.
Replaces any existing sort ordering.
orderBy in interface ExprStream<Long,Expression<Long>>orderBy in interface SearchStream<Long,Expression<Long>>orderExprFunction - Function that produces an Expression to order on given an item expressionasc - true for ascending, false for descendingLongStream orderByMulti(Function<? super Expression<Long>,? extends List<? extends Order>> orderListFunction)
SearchStreamOrder list produced by the given Function.
Replaces any existing sort ordering.
orderByMulti in interface ExprStream<Long,Expression<Long>>orderByMulti in interface SearchStream<Long,Expression<Long>>orderListFunction - Function that produces the sort ordering given an item expressionLongStream thenOrderBy(Ref<?,? extends Expression<?>> ref, boolean asc)
SearchStreamAdds to any existing sort ordering.
thenOrderBy in interface ExprStream<Long,Expression<Long>>thenOrderBy in interface SearchStream<Long,Expression<Long>>ref - previously bound expression referenceasc - true for ascending, false for descendingLongStream thenOrderBy(Order... orders)
SearchStreamOrders after existing sort.
Adds to any existing sort ordering.
thenOrderBy in interface ExprStream<Long,Expression<Long>>thenOrderBy in interface SearchStream<Long,Expression<Long>>orders - ordering(s), with higher precedence orderings firstLongStream thenOrderBy(Function<? super Expression<Long>,? extends Expression<?>> orderExprFunction, boolean asc)
SearchStreamExpression produced by the given Function after existing sort.
Adds to any existing sort ordering.
thenOrderBy in interface ExprStream<Long,Expression<Long>>thenOrderBy in interface SearchStream<Long,Expression<Long>>orderExprFunction - Function that produces an Expression to order on given an item expressionasc - true for ascending, false for descendingLongStream groupBy(Ref<?,? extends Expression<?>> ref)
SearchStreamAdds to any previously specified groupings.
groupBy in interface ExprStream<Long,Expression<Long>>groupBy in interface SearchStream<Long,Expression<Long>>ref - previously bound expression referenceLongStream groupBy(Function<? super Expression<Long>,? extends Expression<?>> groupFunction)
SearchStreamAdds to any previously specified groupings.
groupBy in interface ExprStream<Long,Expression<Long>>groupBy in interface SearchStream<Long,Expression<Long>>groupFunction - function returning an expression by which to group resultsLongStream orderBy(Order... orders)
SearchStreamOrders.
Replaces any existing sort ordering.
orderBy in interface ExprStream<Long,Expression<Long>>orderBy in interface SearchStream<Long,Expression<Long>>orders - ordering(s), with higher precedence orderings firstLongStream groupByMulti(Function<? super Expression<Long>,? extends List<Expression<?>>> groupFunction)
SearchStreamAdds to any previously specified groupings.
groupByMulti in interface ExprStream<Long,Expression<Long>>groupByMulti in interface SearchStream<Long,Expression<Long>>groupFunction - function returning a list of expressions by which to group resultsLongStream having(Function<? super Expression<Long>,? extends Expression<Boolean>> havingFunction)
SearchStreamAdds to any previously specified "having" restrictions.
having in interface ExprStream<Long,Expression<Long>>having in interface SearchStream<Long,Expression<Long>>havingFunction - function returning a test to apply to grouped resultsLongValue findAny()
SearchStreamfindAny in interface ExprStream<Long,Expression<Long>>findAny in interface SearchStream<Long,Expression<Long>>NULL if this stream is empty)LongValue findFirst()
SearchStreamfindFirst in interface ExprStream<Long,Expression<Long>>findFirst in interface SearchStream<Long,Expression<Long>>NULL if this stream is empty)LongValue findSingle()
SearchStream
Invoke this method only when you know that the result stream contains at most one value, e.g., when searching
for an object by its value in a field with a unique constraint. If the stream actually contains multiple values,
then invoking any of the "single value" SearchValue methods such as value() or
toOptional() will generate a NonUniqueResultException.
Using this method is preferable to using SearchStream.findFirst() or SearchStream.findAny() for the same purpose, because it
not only actually verifies the uniqueness assumption, but it also makes that assumption clearer in the code.
Example:
final User user = qb.stream(User.class)
.filter(u -> qb.equal(u.get(User_.username), username))
.findSingle()
.orElseThrow(NoSuchUserException::new);
findSingle in interface ExprStream<Long,Expression<Long>>findSingle in interface SearchStream<Long,Expression<Long>>NULL if this stream is empty)LongStream bind(Ref<Long,? super Expression<Long>> ref)
QueryStreambind in interface ExprStream<Long,Expression<Long>>bind in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>bind in interface SearchStream<Long,Expression<Long>>ref - unbound referencerefLongStream peek(Consumer<? super Expression<Long>> peeker)
QueryStream
This is useful in cases where the selection can be modified, e.g., setting join ON conditions
using Join.on().
peek in interface ExprStream<Long,Expression<Long>>peek in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>peek in interface SearchStream<Long,Expression<Long>>peeker - peeker into stream<X2,S2 extends Selection<X2>> LongStream bind(Ref<X2,? super S2> ref, Function<? super Expression<Long>,? extends S2> refFunction)
QueryStreambind in interface ExprStream<Long,Expression<Long>>bind in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>bind in interface SearchStream<Long,Expression<Long>>X2 - type of the bound valueS2 - criteria type of the bound valueref - unbound referencerefFunction - function mapping this stream's Selection to the reference valueref<R> LongStream addRoot(Ref<R,? super Root<R>> ref, Class<R> type)
SearchStream
To select the new root in a SearchStream, use SearchStream.map(),
providing a Function that returns ref.
Note that this effectively creates an unconstrained (cross product) join with the new root.
Typically there would be some additional restrictions imposed (e.g., via filter())
to relate the new root to the items in the stream.
addRoot in interface ExprStream<Long,Expression<Long>>addRoot in interface SearchStream<Long,Expression<Long>>R - type of the new query rootref - unbound referencetype - type of the new query rootref to a new query root from typeLongStream filter(Function<? super Expression<Long>,? extends Expression<Boolean>> predicateBuilder)
QueryStreamAdds to any previously specified filters.
filter in interface ExprStream<Long,Expression<Long>>filter in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>filter in interface SearchStream<Long,Expression<Long>>predicateBuilder - function mapping this stream's item to a boolean ExpressionLongStream limit(int maxSize)
QueryStreamDue to limitations in the JPA Criteria API, this method is not supported on subquery streams and in general must be specified last (after any filtering, sorting, grouping, joins, etc.).
limit in interface ExprStream<Long,Expression<Long>>limit in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>limit in interface SearchStream<Long,Expression<Long>>maxSize - maximum number of elements to returnLongStream skip(int num)
QueryStreamDue to limitations in the JPA Criteria API, this method is not supported on subquery streams and in general must be specified last (after any filtering, sorting, grouping, joins, etc.).
skip in interface ExprStream<Long,Expression<Long>>skip in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>skip in interface SearchStream<Long,Expression<Long>>num - number of elements to skipLongStream withFlushMode(FlushModeType flushMode)
QueryStreamFlushModeType associated with this query.withFlushMode in interface ExprStream<Long,Expression<Long>>withFlushMode in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withFlushMode in interface SearchStream<Long,Expression<Long>>flushMode - new flush modeQuery.setFlushMode(javax.persistence.FlushModeType)LongStream withLockMode(LockModeType lockMode)
QueryStreamLockModeType associated with this query.withLockMode in interface ExprStream<Long,Expression<Long>>withLockMode in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withLockMode in interface SearchStream<Long,Expression<Long>>lockMode - new lock modeQuery.setLockMode(javax.persistence.LockModeType)LongStream withHint(String name, Object value)
QueryStreamwithHint in interface ExprStream<Long,Expression<Long>>withHint in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withHint in interface SearchStream<Long,Expression<Long>>name - name of hintvalue - value of hintQuery.setHint(java.lang.String, java.lang.Object)LongStream withHints(Map<String,Object> hints)
QueryStreamwithHints in interface ExprStream<Long,Expression<Long>>withHints in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withHints in interface SearchStream<Long,Expression<Long>>hints - hints to addQuery.setHint(java.lang.String, java.lang.Object)<T> LongStream withParam(Parameter<T> parameter, T value)
QueryStreamReplaces any previous binding of the same parameter.
withParam in interface ExprStream<Long,Expression<Long>>withParam in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withParam in interface SearchStream<Long,Expression<Long>>T - parameter value typeparameter - the parameter to setvalue - parameter valueQuery.setParameter(javax.persistence.Parameter, Object)LongStream withParam(Parameter<Date> parameter, Date value, TemporalType temporalType)
QueryStreamDate.
Replaces any previous binding of the same parameter.
withParam in interface ExprStream<Long,Expression<Long>>withParam in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withParam in interface SearchStream<Long,Expression<Long>>parameter - the parameter to setvalue - parameter valuetemporalType - temporal type for valueQuery.setParameter(javax.persistence.Parameter, Date, TemporalType)LongStream withParam(Parameter<Calendar> parameter, Calendar value, TemporalType temporalType)
QueryStreamCalendar.
Replaces any previous binding of the same parameter.
withParam in interface ExprStream<Long,Expression<Long>>withParam in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withParam in interface SearchStream<Long,Expression<Long>>parameter - the parameter to setvalue - parameter valuetemporalType - temporal type for valueQuery.setParameter(javax.persistence.Parameter, Calendar, TemporalType)LongStream withParams(Iterable<? extends ParamBinding<?>> params)
QueryStreamReplaces any previous bindings of the same parameters.
withParams in interface ExprStream<Long,Expression<Long>>withParams in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withParams in interface SearchStream<Long,Expression<Long>>params - bindings to addQuery.setParameter(javax.persistence.Parameter, Object)LongStream withLoadGraph(String name)
QueryStream
Equivalent to withHint("javax.persistence.loadgraph", name).
withLoadGraph in interface ExprStream<Long,Expression<Long>>withLoadGraph in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withLoadGraph in interface SearchStream<Long,Expression<Long>>name - name of load graphLongStream withFetchGraph(String name)
QueryStream
Equivalent to withHint("javax.persistence.fetchgraph", name).
withFetchGraph in interface ExprStream<Long,Expression<Long>>withFetchGraph in interface QueryStream<Long,Expression<Long>,AbstractQuery<?>,CriteriaQuery<Long>,TypedQuery<Long>>withFetchGraph in interface SearchStream<Long,Expression<Long>>name - name of fetch graphCopyright © 2023. All rights reserved.