Package org.dellroad.querystream.jpa

Interface DoubleStream

All Superinterfaces:

ExprStream<Double,Expression<Double>>, QueryConfigurer<AbstractQuery<?>,Double,Expression<Double>>, QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>, SearchStream<Double,Expression<Double>>

All Known Subinterfaces:

DoubleValue

public interface DoubleStream
extends ExprStream<Double,Expression<Double>>

SearchStream containing Double values.

Nested Class Summary

Nested classes/interfaces inherited from interface org.dellroad.querystream.jpa.QueryStream

QueryStream.Builder

Method Summary

Modifier and Type	Method	Description
<R> DoubleStream	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.
DoubleValue	average()
DoubleStream	bind(Ref<Double,? super Expression<Double>> ref)	Bind an unbound reference to the items in this stream.
<X2, S2 extends Selection<X2>> DoubleStream	bind(Ref<X2,? super S2> ref, Function<? super Expression<Double>,? extends S2> refFunction)	Bind an unbound reference to the result of applying the given function to the items in this stream.
DoubleStream	distinct()	Suppress duplicates.
DoubleStream	filter(Function<? super Expression<Double>,? extends Expression<Boolean>> predicateBuilder)	Filter results using the boolean expression produced by the given function.
DoubleValue	findAny()	Find any instance in the stream.
DoubleValue	findFirst()	Find the first instance in the stream.
DoubleValue	findSingle()	Find the only instance in the stream or null.
DoubleStream	groupBy(Function<? super Expression<Double>,? extends Expression<?>> groupFunction)	Apply grouping based on a single expression.
DoubleStream	groupBy(Ref<?,? extends Expression<?>> ref)	Apply grouping based on an expression reference.
DoubleStream	groupByMulti(Function<? super Expression<Double>,? extends List<Expression<?>>> groupFunction)	Apply grouping based on a list of expressions.
DoubleStream	having(Function<? super Expression<Double>,? extends Expression<Boolean>> havingFunction)	Add a "having" restriction.
DoubleStream	limit(int maxSize)	Return this stream truncated to the specified maximum length.
DoubleValue	max()
DoubleValue	min()
DoubleStream	orderBy(Order... orders)	Order results using the specified Orders.
DoubleStream	orderBy(Function<? super Expression<Double>,? extends Expression<?>> orderExprFunction, boolean asc)	Order results using the Expression produced by the given Function.
DoubleStream	orderBy(Ref<?,? extends Expression<?>> ref, boolean asc)	Order results using the specified expression reference.
DoubleStream	orderByMulti(Function<? super Expression<Double>,? extends List<? extends Order>> orderListFunction)	Order results using the Order list produced by the given Function.
DoubleStream	peek(Consumer<? super Expression<Double>> peeker)	Peek at the items in this stream.
DoubleStream	skip(int num)	Return this stream with the specified number of initial elements skipped.
DoubleValue	sum()
DoubleStream	thenOrderBy(Order... orders)	Order results using the specified Orders after existing sort.
DoubleStream	thenOrderBy(Function<? super Expression<Double>,? extends Expression<?>> orderExprFunction, boolean asc)	Order results using the Expression produced by the given Function after existing sort.
DoubleStream	thenOrderBy(Ref<?,? extends Expression<?>> ref, boolean asc)	Order results using the specified expression reference after existing sort.
DoubleStream	withFetchGraph(String name)	Configure a fetch graph for this query.
DoubleStream	withFlushMode(FlushModeType flushMode)	Set the FlushModeType associated with this query.
DoubleStream	withHint(String name, Object value)	Associate a hint with this query.
DoubleStream	withHints(Map<String,Object> hints)	Associate hints with this query.
DoubleStream	withLoadGraph(String name)	Configure a load graph for this query.
DoubleStream	withLockMode(LockModeType lockMode)	Set the LockModeType associated with this query.
DoubleStream	withParam(Parameter<Calendar> parameter, Calendar value, TemporalType temporalType)	Bind the value of a query parameter of type Calendar.
DoubleStream	withParam(Parameter<Date> parameter, Date value, TemporalType temporalType)	Bind the value of a query parameter of type Date.
<T> DoubleStream	withParam(Parameter<T> parameter, T value)	Bind the value of a query parameter.
DoubleStream	withParams(Iterable<? extends ParamBinding<?>> params)	Associate parameter bindings with this query.

Methods inherited from interface org.dellroad.querystream.jpa.ExprStream

asSubquery, count, countDistinct, exists, fetch, fetch, fetch, fetch, filter, groupBy, orderBy, orderBy, orderBy, thenOrderBy

Methods inherited from interface org.dellroad.querystream.jpa.QueryConfigurer

configure

Methods inherited from interface org.dellroad.querystream.jpa.QueryStream

getEntityManager, getFirstResult, getFlushMode, getHints, getLockMode, getMaxResults, getParams, toCriteriaQuery, toQuery

Methods inherited from interface org.dellroad.querystream.jpa.SearchStream

allMatch, 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, noneMatch

Method Details

average

DoubleValue average()

max

DoubleValue max()

min

DoubleValue min()

sum

DoubleValue sum()

distinct

DoubleStream distinct()

Description copied from interface: SearchStream

Suppress duplicates.

Specified by:

distinct in interface ExprStream<Double,Expression<Double>>

Specified by:

distinct in interface SearchStream<Double,Expression<Double>>

Returns:

a new stream with duplicates removed

orderBy

DoubleStream orderBy(Ref<?,? extends Expression<?>> ref,
 boolean asc)

Description copied from interface: SearchStream

Order results using the specified expression reference.

Replaces any existing sort ordering.

Specified by:

orderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

orderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

ref - previously bound expression reference

asc - true for ascending, false for descending

Returns:

a new stream with specified ordering

orderBy

DoubleStream orderBy(Function<? super Expression<Double>,? extends Expression<?>> orderExprFunction,
 boolean asc)

Description copied from interface: SearchStream

Order results using the Expression produced by the given Function.

Replaces any existing sort ordering.

Specified by:

orderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

orderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

orderExprFunction - Function that produces an Expression to order on given an item expression

asc - true for ascending, false for descending

Returns:

a new stream with specified ordering

orderBy

DoubleStream orderBy(Order... orders)

Description copied from interface: SearchStream

Order results using the specified Orders.

Replaces any existing sort ordering.

Specified by:

orderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

orderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

orders - ordering(s), with higher precedence orderings first

Returns:

a new stream with specified ordering(s)

orderByMulti

DoubleStream orderByMulti(Function<? super Expression<Double>,? extends List<? extends Order>> orderListFunction)

Description copied from interface: SearchStream

Order results using the Order list produced by the given Function.

Replaces any existing sort ordering.

Specified by:

orderByMulti in interface ExprStream<Double,Expression<Double>>

Specified by:

orderByMulti in interface SearchStream<Double,Expression<Double>>

Parameters:

orderListFunction - Function that produces the sort ordering given an item expression

Returns:

a new stream with specified ordering

thenOrderBy

DoubleStream thenOrderBy(Ref<?,? extends Expression<?>> ref,
 boolean asc)

Description copied from interface: SearchStream

Order results using the specified expression reference after existing sort.

Adds to any existing sort ordering.

Specified by:

thenOrderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

thenOrderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

ref - previously bound expression reference

asc - true for ascending, false for descending

Returns:

a new stream with specified additional ordering

thenOrderBy

DoubleStream thenOrderBy(Order... orders)

Description copied from interface: SearchStream

Order results using the specified Orders after existing sort.

Adds to any existing sort ordering.

Specified by:

thenOrderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

thenOrderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

orders - ordering(s), with higher precedence orderings first

Returns:

a new stream with specified additional ordering(s)

thenOrderBy

DoubleStream thenOrderBy(Function<? super Expression<Double>,? extends Expression<?>> orderExprFunction,
 boolean asc)

Description copied from interface: SearchStream

Order results using the Expression produced by the given Function after existing sort.

Adds to any existing sort ordering.

Specified by:

thenOrderBy in interface ExprStream<Double,Expression<Double>>

Specified by:

thenOrderBy in interface SearchStream<Double,Expression<Double>>

Parameters:

orderExprFunction - Function that produces an Expression to order on given an item expression

asc - true for ascending, false for descending

Returns:

a new stream with specified additional ordering

groupBy

DoubleStream groupBy(Ref<?,? extends Expression<?>> ref)

Description copied from interface: SearchStream

Apply grouping based on an expression reference.

Adds to any previously specified groupings.

Specified by:

groupBy in interface ExprStream<Double,Expression<Double>>

Specified by:

groupBy in interface SearchStream<Double,Expression<Double>>

Parameters:

ref - previously bound expression reference

Returns:

a new stream with additional grouping

groupBy

DoubleStream groupBy(Function<? super Expression<Double>,? extends Expression<?>> groupFunction)

Description copied from interface: SearchStream

Apply grouping based on a single expression.

Adds to any previously specified groupings.

Specified by:

groupBy in interface ExprStream<Double,Expression<Double>>

Specified by:

groupBy in interface SearchStream<Double,Expression<Double>>

Parameters:

groupFunction - function returning an expression by which to group results

Returns:

a new stream with additional grouping

groupByMulti

DoubleStream groupByMulti(Function<? super Expression<Double>,? extends List<Expression<?>>> groupFunction)

Description copied from interface: SearchStream

Apply grouping based on a list of expressions.

Adds to any previously specified groupings.

Specified by:

groupByMulti in interface ExprStream<Double,Expression<Double>>

Specified by:

groupByMulti in interface SearchStream<Double,Expression<Double>>

Parameters:

groupFunction - function returning a list of expressions by which to group results

Returns:

a new instance

having

DoubleStream having(Function<? super Expression<Double>,? extends Expression<Boolean>> havingFunction)

Description copied from interface: SearchStream

Add a "having" restriction.

Adds to any previously specified "having" restrictions.

Specified by:

having in interface ExprStream<Double,Expression<Double>>

Specified by:

having in interface SearchStream<Double,Expression<Double>>

Parameters:

havingFunction - function returning a test to apply to grouped results

Returns:

a new instance

findAny

DoubleValue findAny()

Description copied from interface: SearchStream

Find any instance in the stream.

Specified by:

findAny in interface ExprStream<Double,Expression<Double>>

Specified by:

findAny in interface SearchStream<Double,Expression<Double>>

Returns:

single-valued stream containg any instance in this stream (or NULL if this stream is empty)

findFirst

DoubleValue findFirst()

Description copied from interface: SearchStream

Find the first instance in the stream.

Specified by:

findFirst in interface ExprStream<Double,Expression<Double>>

Specified by:

findFirst in interface SearchStream<Double,Expression<Double>>

Returns:

single-valued stream containg the first instance in this stream (or NULL if this stream is empty)

findSingle

DoubleValue findSingle()

Description copied from interface: SearchStream

Find the only instance in the stream or null.

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);
 

Specified by:

findSingle in interface ExprStream<Double,Expression<Double>>

Specified by:

findSingle in interface SearchStream<Double,Expression<Double>>

Returns:

a single value, either the only instance in this stream or null if this stream is empty

bind

DoubleStream bind(Ref<Double,? super Expression<Double>> ref)

Description copied from interface: QueryStream

Bind an unbound reference to the items in this stream.

Specified by:

bind in interface ExprStream<Double,Expression<Double>>

Specified by:

bind in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

bind in interface SearchStream<Double,Expression<Double>>

Parameters:

ref - unbound reference

Returns:

new stream that binds ref

peek

DoubleStream peek(Consumer<? super Expression<Double>> peeker)

Description copied from interface: QueryStream

Peek at the items in this stream.

This is useful in cases where the selection can be modified, e.g., setting join ON conditions using Join.on().

Specified by:

peek in interface ExprStream<Double,Expression<Double>>

Specified by:

peek in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

peek in interface SearchStream<Double,Expression<Double>>

Parameters:

peeker - peeker into stream

Returns:

new stream that peeks into this stream

bind

<X2,
S2 extends Selection<X2>> DoubleStream bind(Ref<X2,? super S2> ref,
 Function<? super Expression<Double>,? extends S2> refFunction)

Description copied from interface: QueryStream

Bind an unbound reference to the result of applying the given function to the items in this stream.

Specified by:

bind in interface ExprStream<Double,Expression<Double>>

Specified by:

bind in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

bind in interface SearchStream<Double,Expression<Double>>

Type Parameters:

X2 - type of the bound value

S2 - criteria type of the bound value

Parameters:

ref - unbound reference

refFunction - function mapping this stream's Selection to the reference value

Returns:

new stream that binds ref

addRoot

<R> DoubleStream addRoot(Ref<R,? super Root<R>> ref,
 Class<R> type)

Description copied from interface: SearchStream

Bind an unbound reference to a new query root that will be added to the query.

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.

Specified by:

addRoot in interface ExprStream<Double,Expression<Double>>

Specified by:

addRoot in interface SearchStream<Double,Expression<Double>>

Type Parameters:

R - type of the new query root

Parameters:

ref - unbound reference

type - type of the new query root

Returns:

new stream that binds ref to a new query root from type

filter

DoubleStream filter(Function<? super Expression<Double>,? extends Expression<Boolean>> predicateBuilder)

Description copied from interface: QueryStream

Filter results using the boolean expression produced by the given function.

Adds to any previously specified filters.

Specified by:

filter in interface ExprStream<Double,Expression<Double>>

Specified by:

filter in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

filter in interface SearchStream<Double,Expression<Double>>

Parameters:

predicateBuilder - function mapping this stream's item to a boolean Expression

Returns:

new filtered stream

limit

DoubleStream limit(int maxSize)

Description copied from interface: QueryStream

Return this stream truncated to the specified maximum length.

Due 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.).

Specified by:

limit in interface ExprStream<Double,Expression<Double>>

Specified by:

limit in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

limit in interface SearchStream<Double,Expression<Double>>

Parameters:

maxSize - maximum number of elements to return

Returns:

new truncated stream

skip

DoubleStream skip(int num)

Description copied from interface: QueryStream

Return this stream with the specified number of initial elements skipped.

Due 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.).

Specified by:

skip in interface ExprStream<Double,Expression<Double>>

Specified by:

skip in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

skip in interface SearchStream<Double,Expression<Double>>

Parameters:

num - number of elements to skip

Returns:

new elided stream

withFlushMode

DoubleStream withFlushMode(FlushModeType flushMode)

Description copied from interface: QueryStream

Set the FlushModeType associated with this query.

Specified by:

withFlushMode in interface ExprStream<Double,Expression<Double>>

Specified by:

withFlushMode in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withFlushMode in interface SearchStream<Double,Expression<Double>>

Parameters:

flushMode - new flush mode

Returns:

new stream with the specified flush mode configured

See Also:

• Query.setFlushMode(jakarta.persistence.FlushModeType)

withLockMode

DoubleStream withLockMode(LockModeType lockMode)

Description copied from interface: QueryStream

Set the LockModeType associated with this query.

Specified by:

withLockMode in interface ExprStream<Double,Expression<Double>>

Specified by:

withLockMode in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withLockMode in interface SearchStream<Double,Expression<Double>>

Parameters:

lockMode - new lock mode

Returns:

new stream with the specified lock mode configured

See Also:

• Query.setLockMode(jakarta.persistence.LockModeType)

withHint

DoubleStream withHint(String name,
 Object value)

Description copied from interface: QueryStream

Associate a hint with this query.

Specified by:

withHint in interface ExprStream<Double,Expression<Double>>

Specified by:

withHint in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withHint in interface SearchStream<Double,Expression<Double>>

Parameters:

name - name of hint

value - value of hint

Returns:

new stream with the specified hint configured

See Also:

• Query.setHint(java.lang.String, java.lang.Object)

withHints

DoubleStream withHints(Map<String,Object> hints)

Description copied from interface: QueryStream

Associate hints with this query.

Specified by:

withHints in interface ExprStream<Double,Expression<Double>>

Specified by:

withHints in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withHints in interface SearchStream<Double,Expression<Double>>

Parameters:

hints - hints to add

Returns:

new stream with the specified hints added

See Also:

• Query.setHint(java.lang.String, java.lang.Object)

withParam

<T> DoubleStream withParam(Parameter<T> parameter,
 T value)

Description copied from interface: QueryStream

Bind the value of a query parameter.

Replaces any previous binding of the same parameter.

Specified by:

withParam in interface ExprStream<Double,Expression<Double>>

Specified by:

withParam in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withParam in interface SearchStream<Double,Expression<Double>>

Type Parameters:

T - parameter value type

Parameters:

parameter - the parameter to set

value - parameter value

Returns:

new stream with the specified parameter value set

See Also:

• Query.setParameter(Parameter, Object)

withParam

DoubleStream withParam(Parameter<Date> parameter,
 Date value,
 TemporalType temporalType)

Description copied from interface: QueryStream

Bind the value of a query parameter of type Date.

Replaces any previous binding of the same parameter.

Specified by:

withParam in interface ExprStream<Double,Expression<Double>>

Specified by:

withParam in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withParam in interface SearchStream<Double,Expression<Double>>

Parameters:

parameter - the parameter to set

value - parameter value

temporalType - temporal type for value

Returns:

new stream with the specified parameter value set

See Also:

• Query.setParameter(Parameter, Date, TemporalType)

withParam

DoubleStream withParam(Parameter<Calendar> parameter,
 Calendar value,
 TemporalType temporalType)

Description copied from interface: QueryStream

Bind the value of a query parameter of type Calendar.

Replaces any previous binding of the same parameter.

Specified by:

withParam in interface ExprStream<Double,Expression<Double>>

Specified by:

withParam in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withParam in interface SearchStream<Double,Expression<Double>>

Parameters:

parameter - the parameter to set

value - parameter value

temporalType - temporal type for value

Returns:

new stream with the specified parameter value set

See Also:

• Query.setParameter(Parameter, Calendar, TemporalType)

withParams

DoubleStream withParams(Iterable<? extends ParamBinding<?>> params)

Description copied from interface: QueryStream

Associate parameter bindings with this query.

Replaces any previous bindings of the same parameters.

Specified by:

withParams in interface ExprStream<Double,Expression<Double>>

Specified by:

withParams in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withParams in interface SearchStream<Double,Expression<Double>>

Parameters:

params - bindings to add

Returns:

new stream with the specified parameter bindings added

See Also:

• Query.setParameter(Parameter, Object)

withLoadGraph

DoubleStream withLoadGraph(String name)

Description copied from interface: QueryStream

Configure a load graph for this query.

Equivalent to withHint("jakarta.persistence.loadgraph", name).

Specified by:

withLoadGraph in interface ExprStream<Double,Expression<Double>>

Specified by:

withLoadGraph in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withLoadGraph in interface SearchStream<Double,Expression<Double>>

Parameters:

name - name of load graph

Returns:

new stream with the specified load graph configured

withFetchGraph

DoubleStream withFetchGraph(String name)

Description copied from interface: QueryStream

Configure a fetch graph for this query.

Equivalent to withHint("jakarta.persistence.fetchgraph", name).

Specified by:

withFetchGraph in interface ExprStream<Double,Expression<Double>>

Specified by:

withFetchGraph in interface QueryStream<Double,Expression<Double>,AbstractQuery<?>,CriteriaQuery<Double>,TypedQuery<Double>>

Specified by:

withFetchGraph in interface SearchStream<Double,Expression<Double>>

Parameters:

name - name of fetch graph

Returns:

new stream with the specified fetch graph configured