Package org.dellroad.querystream.jpa

Interface DeleteStream<X>

All Superinterfaces:

QueryConfigurer<CriteriaDelete<X>,X,Root<X>>, QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

public interface DeleteStream<X>
extends QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Builder for JPA criteria bulk delete queries using a Stream-like API.

Nested Class Summary

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

QueryStream.Builder

Method Summary

Modifier and Type	Method	Description
DeleteStream<X>	bind(Ref<X,? super Root<X>> ref)	Bind an unbound reference to the items in this stream.
<X2, S2 extends Selection<X2>> DeleteStream<X>	bind(Ref<X2,? super S2> ref, Function<? super Root<X>,? extends S2> refFunction)	Bind an unbound reference to the result of applying the given function to the items in this stream.
int	delete()	Build and execute a JPA query based on this instance.
DeleteStream<X>	filter(SingularAttribute<? super X,Boolean> attribute)	Filter results using the specified boolean property.
DeleteStream<X>	filter(Function<? super Root<X>,? extends Expression<Boolean>> predicateBuilder)	Filter results using the boolean expression produced by the given function.
DeleteType<X>	getQueryType()	Get the QueryType of this instance.
DeleteStream<X>	limit(int maxSize)	Return this stream truncated to the specified maximum length.
DeleteStream<X>	peek(Consumer<? super Root<X>> peeker)	Peek at the items in this stream.
DeleteStream<X>	skip(int num)	Return this stream with the specified number of initial elements skipped.
DeleteStream<X>	withFetchGraph(String name)	Configure a fetch graph for this query.
DeleteStream<X>	withFlushMode(FlushModeType flushMode)	Set the FlushModeType associated with this query.
DeleteStream<X>	withHint(String name, Object value)	Associate a hint with this query.
DeleteStream<X>	withHints(Map<String,Object> hints)	Associate hints with this query.
DeleteStream<X>	withLoadGraph(String name)	Configure a load graph for this query.
DeleteStream<X>	withLockMode(LockModeType lockMode)	Set the LockModeType associated with this query.
DeleteStream<X>	withParam(Parameter<Calendar> parameter, Calendar value, TemporalType temporalType)	Bind the value of a query parameter of type Calendar.
DeleteStream<X>	withParam(Parameter<Date> parameter, Date value, TemporalType temporalType)	Bind the value of a query parameter of type Date.
<T> DeleteStream<X>	withParam(Parameter<T> parameter, T value)	Bind the value of a query parameter.
DeleteStream<X>	withParams(Iterable<? extends ParamBinding<?>> params)	Associate parameter bindings with this query.

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

Method Details

delete

int delete()

Build and execute a JPA query based on this instance.

Ultimately delegates to Query.executeUpdate() and can throw any exception thrown by that method.

Returns:

the number of entities deleted

getQueryType

DeleteType<X> getQueryType()

Description copied from interface: QueryStream

Get the QueryType of this instance.

Specified by:

getQueryType in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Returns:

associated QueryType

bind

DeleteStream<X> bind(Ref<X,? super Root<X>> ref)

Description copied from interface: QueryStream

Bind an unbound reference to the items in this stream.

Specified by:

bind in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

ref - unbound reference

Returns:

new stream that binds ref

bind

<X2,
S2 extends Selection<X2>> DeleteStream<X> bind(Ref<X2,? super S2> ref,
 Function<? super Root<X>,? 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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

peek

DeleteStream<X> peek(Consumer<? super Root<X>> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

peeker - peeker into stream

Returns:

new stream that peeks into this stream

filter

DeleteStream<X> filter(SingularAttribute<? super X,Boolean> attribute)

Description copied from interface: QueryStream

Filter results using the specified boolean property.

Adds to any previously specified filters.

Specified by:

filter in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

attribute - boolean property

Returns:

new filtered stream

filter

DeleteStream<X> filter(Function<? super Root<X>,? 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

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

Returns:

new filtered stream

limit

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

maxSize - maximum number of elements to return

Returns:

new truncated stream

skip

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

num - number of elements to skip

Returns:

new elided stream

withFlushMode

DeleteStream<X> withFlushMode(FlushModeType flushMode)

Description copied from interface: QueryStream

Set the FlushModeType associated with this query.

Specified by:

withFlushMode in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

flushMode - new flush mode

Returns:

new stream with the specified flush mode configured

See Also:

• Query.setFlushMode(jakarta.persistence.FlushModeType)

withLockMode

DeleteStream<X> withLockMode(LockModeType lockMode)

Description copied from interface: QueryStream

Set the LockModeType associated with this query.

Specified by:

withLockMode in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

lockMode - new lock mode

Returns:

new stream with the specified lock mode configured

See Also:

• Query.setLockMode(jakarta.persistence.LockModeType)

withHint

DeleteStream<X> withHint(String name,
 Object value)

Description copied from interface: QueryStream

Associate a hint with this query.

Specified by:

withHint in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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

DeleteStream<X> withHints(Map<String,Object> hints)

Description copied from interface: QueryStream

Associate hints with this query.

Specified by:

withHints in interface QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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> DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

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

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

params - bindings to add

Returns:

new stream with the specified parameter bindings added

See Also:

• Query.setParameter(Parameter, Object)

withLoadGraph

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

name - name of load graph

Returns:

new stream with the specified load graph configured

withFetchGraph

DeleteStream<X> 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 QueryStream<X,Root<X>,CriteriaDelete<X>,CriteriaDelete<X>,Query>

Parameters:

name - name of fetch graph

Returns:

new stream with the specified fetch graph configured