Package org.hibernate.reactive.mutiny
Interface Mutiny.SelectionQuery<R>
-
- All Superinterfaces:
Mutiny.AbstractQuery
- All Known Subinterfaces:
Mutiny.Query<R>
- Enclosing interface:
- Mutiny
public static interface Mutiny.SelectionQuery<R> extends Mutiny.AbstractQuery
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description CacheMode
getCacheMode()
Obtain theCacheMode
in effect for this query.String
getCacheRegion()
jakarta.persistence.CacheRetrieveMode
getCacheRetrieveMode()
jakarta.persistence.CacheStoreMode
getCacheStoreMode()
int
getFirstResult()
FlushMode
getFlushMode()
Obtain theFlushMode
in effect for this query.int
getMaxResults()
io.smallrye.mutiny.Uni<List<R>>
getResultList()
Asynchronously execute this query, returning the query results as aList
, via aUni
.io.smallrye.mutiny.Uni<R>
getSingleResult()
Asynchronously execute this query, returning a single row that matches the query, throwing an exception if the query returns zero rows or more than one matching row.io.smallrye.mutiny.Uni<R>
getSingleResultOrNull()
Asynchronously execute this query, returning a single row that matches the query, ornull
if the query returns no results, throwing an exception if the query returns more than one matching row.boolean
isCacheable()
boolean
isReadOnly()
Mutiny.SelectionQuery<R>
setCacheable(boolean cacheable)
Enable or disable caching of this query result set in the second-level query cache.Mutiny.SelectionQuery<R>
setCacheMode(CacheMode cacheMode)
Set the currentCacheMode
in effect while this query is being executed.Mutiny.SelectionQuery<R>
setCacheRegion(String cacheRegion)
Set the name of the cache region in which to store this query result set ifcaching is enabled
.default Mutiny.SelectionQuery<R>
setCacheRetrieveMode(jakarta.persistence.CacheRetrieveMode cacheRetrieveMode)
Set the currentCacheRetrieveMode
in effect while this query is being executed.default Mutiny.SelectionQuery<R>
setCacheStoreMode(jakarta.persistence.CacheStoreMode cacheStoreMode)
Set the currentCacheStoreMode
in effect while this query is being executed.Mutiny.SelectionQuery<R>
setComment(String comment)
Set the comment for this query.Mutiny.SelectionQuery<R>
setFirstResult(int firstResult)
Set the position of the first result that may be returned by this query when executed, where the results are numbered from 0.default Mutiny.SelectionQuery<R>
setFlushMode(jakarta.persistence.FlushModeType flushModeType)
Set the currentFlushModeType
in effect while this query is being executed.Mutiny.SelectionQuery<R>
setFlushMode(FlushMode flushMode)
Set the currentFlushMode
in effect while this query is being executed.default Mutiny.SelectionQuery<R>
setLockMode(jakarta.persistence.LockModeType lockModeType)
Set theLockModeType
to use for the whole query.default Mutiny.SelectionQuery<R>
setLockMode(String alias, jakarta.persistence.LockModeType lockModeType)
Set theLockModeType
to use for specified alias (as defined in the query'sfrom
clause).Mutiny.SelectionQuery<R>
setLockMode(String alias, LockMode lockMode)
Set theLockMode
to use for specified alias (as defined in the query'sfrom
clause).Mutiny.SelectionQuery<R>
setLockMode(LockMode lockMode)
Set theLockMode
to use for the whole query.Mutiny.SelectionQuery<R>
setMaxResults(int maxResults)
Set the maximum number of results that may be returned by this query when executed.Mutiny.SelectionQuery<R>
setParameter(int parameter, Object argument)
Set the value of an ordinal parameter.<T> Mutiny.SelectionQuery<R>
setParameter(jakarta.persistence.Parameter<T> parameter, T argument)
Set the value of a typed parameter.Mutiny.SelectionQuery<R>
setParameter(String parameter, Object argument)
Set the value of a named parameter.Mutiny.SelectionQuery<R>
setPlan(jakarta.persistence.EntityGraph<R> entityGraph)
Set theEntityGraph
that will be used as a fetch plan for the root entity returned by this query.Mutiny.SelectionQuery<R>
setReadOnly(boolean readOnly)
Set the read-only/modifiable mode for entities and proxies loaded by this Query.-
Methods inherited from interface org.hibernate.reactive.mutiny.Mutiny.AbstractQuery
getComment
-
-
-
-
Method Detail
-
setMaxResults
Mutiny.SelectionQuery<R> setMaxResults(int maxResults)
Set the maximum number of results that may be returned by this query when executed.
-
setFirstResult
Mutiny.SelectionQuery<R> setFirstResult(int firstResult)
Set the position of the first result that may be returned by this query when executed, where the results are numbered from 0.
-
getMaxResults
int getMaxResults()
- Returns:
- the maximum number results, or
Integer.MAX_VALUE
if not set
-
getFirstResult
int getFirstResult()
- Returns:
- the first result, or 0 if not set
-
getSingleResult
io.smallrye.mutiny.Uni<R> getSingleResult()
Asynchronously execute this query, returning a single row that matches the query, throwing an exception if the query returns zero rows or more than one matching row. If the query has multiple results per row, the results are returned in an instance ofObject[]
.- Returns:
- the single resulting row
- Throws:
jakarta.persistence.NoResultException
- if there is no resultjakarta.persistence.NonUniqueResultException
- if there are multiple results- See Also:
Query.getSingleResult()
-
getSingleResultOrNull
io.smallrye.mutiny.Uni<R> getSingleResultOrNull()
Asynchronously execute this query, returning a single row that matches the query, ornull
if the query returns no results, throwing an exception if the query returns more than one matching row. If the query has multiple results per row, the results are returned in an instance ofObject[]
.- Returns:
- the single resulting row or
null
- Throws:
jakarta.persistence.NonUniqueResultException
- if there are multiple results- See Also:
getSingleResult()
-
getResultList
io.smallrye.mutiny.Uni<List<R>> getResultList()
Asynchronously execute this query, returning the query results as aList
, via aUni
. If the query has multiple results per row, the results are returned in an instance ofObject[]
.- Returns:
- the resulting rows as a
List
- See Also:
Query.getResultList()
-
setReadOnly
Mutiny.SelectionQuery<R> setReadOnly(boolean readOnly)
Set the read-only/modifiable mode for entities and proxies loaded by this Query. This setting overrides the default setting for the persistence context.
-
isReadOnly
boolean isReadOnly()
- Returns:
- the read-only/modifiable mode
- See Also:
Mutiny.Session.isDefaultReadOnly()
-
setCacheable
Mutiny.SelectionQuery<R> setCacheable(boolean cacheable)
Enable or disable caching of this query result set in the second-level query cache.- Parameters:
cacheable
-true
if this query is cacheable
-
isCacheable
boolean isCacheable()
- Returns:
true
if this query is cacheable- See Also:
setCacheable(boolean)
-
setCacheRegion
Mutiny.SelectionQuery<R> setCacheRegion(String cacheRegion)
Set the name of the cache region in which to store this query result set ifcaching is enabled
.- Parameters:
cacheRegion
- the name of the cache region
-
getCacheRegion
String getCacheRegion()
- Returns:
- the name of the cache region
- See Also:
setCacheRegion(String)
-
setCacheMode
Mutiny.SelectionQuery<R> setCacheMode(CacheMode cacheMode)
Set the currentCacheMode
in effect while this query is being executed.
-
setCacheStoreMode
default Mutiny.SelectionQuery<R> setCacheStoreMode(jakarta.persistence.CacheStoreMode cacheStoreMode)
Set the currentCacheStoreMode
in effect while this query is being executed.
-
setCacheRetrieveMode
default Mutiny.SelectionQuery<R> setCacheRetrieveMode(jakarta.persistence.CacheRetrieveMode cacheRetrieveMode)
Set the currentCacheRetrieveMode
in effect while this query is being executed.
-
getCacheStoreMode
jakarta.persistence.CacheStoreMode getCacheStoreMode()
-
getCacheRetrieveMode
jakarta.persistence.CacheRetrieveMode getCacheRetrieveMode()
-
getCacheMode
CacheMode getCacheMode()
Obtain theCacheMode
in effect for this query. By default, the query inherits theCacheMode
of theMutiny.Session
from which is originates.- See Also:
Mutiny.Session.getCacheMode()
-
setFlushMode
Mutiny.SelectionQuery<R> setFlushMode(FlushMode flushMode)
Set the currentFlushMode
in effect while this query is being executed.
-
setFlushMode
default Mutiny.SelectionQuery<R> setFlushMode(jakarta.persistence.FlushModeType flushModeType)
Set the currentFlushModeType
in effect while this query is being executed.
-
getFlushMode
FlushMode getFlushMode()
Obtain theFlushMode
in effect for this query. By default, the query inherits theFlushMode
of theMutiny.Session
from which is originates.- See Also:
Mutiny.Session.getFlushMode()
-
setLockMode
Mutiny.SelectionQuery<R> setLockMode(LockMode lockMode)
Set theLockMode
to use for the whole query.
-
setLockMode
default Mutiny.SelectionQuery<R> setLockMode(jakarta.persistence.LockModeType lockModeType)
Set theLockModeType
to use for the whole query.
-
setLockMode
Mutiny.SelectionQuery<R> setLockMode(String alias, LockMode lockMode)
Set theLockMode
to use for specified alias (as defined in the query'sfrom
clause).- Parameters:
alias
- the from clause aliaslockMode
- the requestedLockMode
- See Also:
Query.setLockMode(String,LockMode)
-
setLockMode
default Mutiny.SelectionQuery<R> setLockMode(String alias, jakarta.persistence.LockModeType lockModeType)
Set theLockModeType
to use for specified alias (as defined in the query'sfrom
clause).- Parameters:
alias
- the from clause aliaslockModeType
- the requestedLockModeType
- See Also:
Query.setLockMode(String,LockMode)
-
setPlan
Mutiny.SelectionQuery<R> setPlan(jakarta.persistence.EntityGraph<R> entityGraph)
Set theEntityGraph
that will be used as a fetch plan for the root entity returned by this query.
-
setParameter
Mutiny.SelectionQuery<R> setParameter(int parameter, Object argument)
Description copied from interface:Mutiny.AbstractQuery
Set the value of an ordinal parameter. Ordinal parameters are numbered from 1, and are specified in the query using placeholder tokens of form?1
,?2
, etc.- Specified by:
setParameter
in interfaceMutiny.AbstractQuery
- Parameters:
parameter
- an integer identifying the ordinal parameterargument
- the argument to set
-
setParameter
Mutiny.SelectionQuery<R> setParameter(String parameter, Object argument)
Description copied from interface:Mutiny.AbstractQuery
Set the value of a named parameter. Named parameters are specified in the query using placeholder tokens of form:name
.- Specified by:
setParameter
in interfaceMutiny.AbstractQuery
- Parameters:
parameter
- the name of the parameterargument
- the argument to set
-
setParameter
<T> Mutiny.SelectionQuery<R> setParameter(jakarta.persistence.Parameter<T> parameter, T argument)
Description copied from interface:Mutiny.AbstractQuery
Set the value of a typed parameter. Typed parameters are obtained from the JPACriteriaBuilder
, which may itself be obtained by callingMutiny.SessionFactory.getCriteriaBuilder()
.- Specified by:
setParameter
in interfaceMutiny.AbstractQuery
- Parameters:
parameter
- the parameterargument
- the argument to set- See Also:
CriteriaBuilder.parameter(Class)
-
setComment
Mutiny.SelectionQuery<R> setComment(String comment)
Description copied from interface:Mutiny.AbstractQuery
Set the comment for this query. This comment will be prepended to the SQL query sent to the database.- Specified by:
setComment
in interfaceMutiny.AbstractQuery
- Parameters:
comment
- The human-readable comment
-
-