Package io.quarkus.hibernate.panache.runtime.orm

Class PanacheBlockingQueryImpl<Entity>

java.lang.Object

io.quarkus.hibernate.panache.runtime.orm.PanacheBlockingQueryImpl<Entity>

All Implemented Interfaces:

PanacheBlockingQuery<Entity>, PanacheQuery<Entity,List<Entity>,Boolean,Long>

public class PanacheBlockingQueryImpl<Entity>
extends Object
implements PanacheBlockingQuery<Entity>

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final io.quarkus.hibernate.orm.panache.common.runtime.CommonPanacheQueryImpl<Entity>	delegate

Constructor Summary

Constructors

Constructor	Description
PanacheBlockingQueryImpl(io.quarkus.hibernate.orm.panache.common.runtime.CommonPanacheQueryImpl<Entity> delegate)
PanacheBlockingQueryImpl(org.hibernate.SharedSessionContract session, String query, String originalQuery, String orderBy, Object paramsArrayOrMap)

Method Summary

Modifier and Type	Method	Description
Long	count()	Reads and caches the total number of entities this query operates on.
PanacheBlockingQueryImpl<Entity>	filter(String filterName)	Enables a Hibernate filter during fetching of results for this query.
PanacheBlockingQueryImpl<Entity>	filter(String filterName, Map<String,Object> parameters)	Enables a Hibernate filter during fetching of results for this query.
PanacheBlockingQueryImpl<Entity>	firstPage()	Sets the current page to the first page
Entity	firstResult()	Returns the first result of the current page index.
Optional<Entity>	firstResultOptional()	Returns the first result of the current page index.
Boolean	hasNextPage()	Returns true if there is another page to read after the current one.
Boolean	hasPreviousPage()	Returns true if there is a page to read before the current one.
PanacheBlockingQueryImpl<Entity>	lastPage()	Sets the current page to the last page.
List<Entity>	list()	Returns the current page of results as a List.
PanacheBlockingQueryImpl<Entity>	nextPage()	Sets the current page to the next page
org.hibernate.query.Page	page()	Returns the current page.
PanacheBlockingQueryImpl<Entity>	page(int pageIndex, int pageSize)	Sets the current page.
PanacheBlockingQueryImpl<Entity>	page(org.hibernate.query.Page page)	Sets the current page.
Long	pageCount()	Returns the total number of pages to be read using the current page size.
PanacheBlockingQueryImpl<Entity>	previousPage()	Sets the current page to the previous page (or the first page if there is no previous page)
<NewEntity> PanacheBlockingQueryImpl<NewEntity>	project(Class<NewEntity> type)	Defines a projection class.
PanacheBlockingQueryImpl<Entity>	range(int startIndex, int lastIndex)	Switch the query to use a fixed range (start index - last index) instead of a page.
Entity	singleResult()	Executes this query for the current page and return a single result.
Optional<Entity>	singleResultOptional()	Executes this query for the current page and return a single result.
Stream<Entity>	stream()	Returns the current page of results as a Stream.
PanacheBlockingQueryImpl<Entity>	withHint(String hintName, Object value)	Set a query property or hint on the underlying JPA Query.
PanacheBlockingQueryImpl<Entity>	withLock(jakarta.persistence.LockModeType lockModeType)	Define the locking strategy used for this query.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

delegate

final io.quarkus.hibernate.orm.panache.common.runtime.CommonPanacheQueryImpl<Entity> delegate

Constructor Details

PanacheBlockingQueryImpl

PanacheBlockingQueryImpl(org.hibernate.SharedSessionContract session,
 String query,
 String originalQuery,
 String orderBy,
 Object paramsArrayOrMap)

PanacheBlockingQueryImpl

PanacheBlockingQueryImpl(io.quarkus.hibernate.orm.panache.common.runtime.CommonPanacheQueryImpl<Entity> delegate)

Method Details

page

public PanacheBlockingQueryImpl<Entity> page(org.hibernate.query.Page page)

Description copied from interface: PanacheQuery

Sets the current page.

Specified by:

page in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

page - the new page

Returns:

this query, modified

See Also:

• PanacheQuery.page(int, int)
• PanacheQuery.page()

page

public PanacheBlockingQueryImpl<Entity> page(int pageIndex,
 int pageSize)

Description copied from interface: PanacheQuery

Sets the current page.

Specified by:

page in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

pageIndex - the page index (0-based)

pageSize - the page size

Returns:

this query, modified

See Also:

• PanacheQuery.page(Page)
• PanacheQuery.page()

nextPage

public PanacheBlockingQueryImpl<Entity> nextPage()

Description copied from interface: PanacheQuery

Sets the current page to the next page

Specified by:

nextPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

this query, modified

See Also:

• PanacheQuery.previousPage()

previousPage

public PanacheBlockingQueryImpl<Entity> previousPage()

Description copied from interface: PanacheQuery

Sets the current page to the previous page (or the first page if there is no previous page)

Specified by:

previousPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

this query, modified

See Also:

• PanacheQuery.nextPage()

firstPage

public PanacheBlockingQueryImpl<Entity> firstPage()

Description copied from interface: PanacheQuery

Sets the current page to the first page

Specified by:

firstPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

this query, modified

See Also:

• PanacheQuery.lastPage()

lastPage

public PanacheBlockingQueryImpl<Entity> lastPage()

Description copied from interface: PanacheQuery

Sets the current page to the last page. This will cause reading of the entity count.

Specified by:

lastPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

this query, modified

See Also:

• PanacheQuery.firstPage()
• PanacheQuery.count()

hasNextPage

public Boolean hasNextPage()

Description copied from interface: PanacheQuery

Returns true if there is another page to read after the current one. This will cause reading of the entity count.

Specified by:

hasNextPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

true if there is another page to read

See Also:

• PanacheQuery.hasPreviousPage()
• PanacheQuery.count()

hasPreviousPage

public Boolean hasPreviousPage()

Description copied from interface: PanacheQuery

Returns true if there is a page to read before the current one.

Specified by:

hasPreviousPage in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

true if there is a previous page to read

See Also:

• PanacheQuery.hasNextPage()

pageCount

public Long pageCount()

Description copied from interface: PanacheQuery

Returns the total number of pages to be read using the current page size. This will cause reading of the entity count.

Specified by:

pageCount in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the total number of pages to be read using the current page size.

page

public org.hibernate.query.Page page()

Description copied from interface: PanacheQuery

Returns the current page.

Specified by:

page in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the current page

See Also:

• PanacheQuery.page(Page)
• PanacheQuery.page(int,int)

range

public PanacheBlockingQueryImpl<Entity> range(int startIndex,
 int lastIndex)

Description copied from interface: PanacheQuery

Switch the query to use a fixed range (start index - last index) instead of a page. As the range is fixed, subsequent pagination of the query is not possible.

Specified by:

range in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

startIndex - the index of the first element, starting at 0

lastIndex - the index of the last element

Returns:

this query, modified

withLock

public PanacheBlockingQueryImpl<Entity> withLock(jakarta.persistence.LockModeType lockModeType)

Description copied from interface: PanacheQuery

Define the locking strategy used for this query.

Specified by:

withLock in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

lockModeType - the locking strategy to be used for this query.

Returns:

this query, modified

withHint

public PanacheBlockingQueryImpl<Entity> withHint(String hintName,
 Object value)

Description copied from interface: PanacheQuery

Set a query property or hint on the underlying JPA Query.

Specified by:

withHint in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

hintName - name of the property or hint.

value - value for the property or hint.

Returns:

this query, modified

filter

public PanacheBlockingQueryImpl<Entity> filter(String filterName,
 Map<String,Object> parameters)

Description copied from interface: PanacheQuery

Enables a Hibernate filter during fetching of results for this query. Your filter must be declared with FilterDef on your entity or package, and enabled with Filter on your entity.

WARNING: setting filters can only be done on the underlying Hibernate Session and so this will modify the session's filters for the duration of obtaining the results (not while building the query). Enabled filters will be removed from the session afterwards, but no effort is made to preserve filters enabled on the session outside of this API.

Specified by:

filter in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

filterName - The name of the filter to enable

parameters - The set of parameters for the filter, if the filter requires parameters

Returns:

this query, modified

filter

public PanacheBlockingQueryImpl<Entity> filter(String filterName)

Description copied from interface: PanacheQuery

Enables a Hibernate filter during fetching of results for this query. Your filter must be declared with FilterDef on your entity or package, and enabled with Filter on your entity.

WARNING: setting filters can only be done on the underlying Hibernate Session and so this will modify the session's filters for the duration of obtaining the results (not while building the query). Enabled filters will be removed from the session afterwards, but no effort is made to preserve filters enabled on the session outside of this API.

Specified by:

filter in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Parameters:

filterName - The name of the filter to enable

Returns:

this query, modified

count

public Long count()

Description copied from interface: PanacheQuery

Reads and caches the total number of entities this query operates on. This causes a database query with SELECT COUNT(*) and a query equivalent to the current query, minus ordering.

Specified by:

count in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the total number of entities this query operates on, cached.

list

public List<Entity> list()

Description copied from interface: PanacheQuery

Returns the current page of results as a List.

Specified by:

list in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the current page of results as a List.

See Also:

• invalid reference

  #stream()

• PanacheQuery.page(Page)
• PanacheQuery.page()

firstResult

public Entity firstResult()

Description copied from interface: PanacheQuery

Returns the first result of the current page index. This ignores the current page size to fetch a single result.

Specified by:

firstResult in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the first result of the current page index, or null if there are no results.

See Also:

• PanacheQuery.singleResult()

singleResult

public Entity singleResult()

Description copied from interface: PanacheQuery

Executes this query for the current page and return a single result.

Specified by:

singleResult in interface PanacheQuery<Entity,List<Entity>,Boolean,Long>

Returns:

the single result (throws if there is not exactly one)

See Also:

• PanacheQuery.firstResult()

project

public <NewEntity>
PanacheBlockingQueryImpl<NewEntity> project(Class<NewEntity> type)

Description copied from interface: PanacheBlockingQuery

Defines a projection class. This will transform the returned values into instances of the given type using the following mapping rules:

• If your query already selects some specific columns (starts with select distinct? a, b, c…) then we transform it into a query of the form: select distinct? new ProjectionClass(a, b, c)…. There must be a matching constructor that accepts the selected column types, in the right order.
• If your query does not select any specific column (starts with from…) then we transform it into a query of the form: select new ProjectionClass(a, b, c…) from… where we fetch the list of selected columns from your projection class' single constructor, using its parameter names (or their
  invalid reference

  ProjectedFieldName

  annotations), in the same order as the constructor.
• If this is already a project query of the form select distinct? new…, we throw a
  invalid reference

  PanacheQueryException

Specified by:

project in interface PanacheBlockingQuery<Entity>

Parameters:

type - the projected class type

Returns:

a new query with the same state as the previous one (params, page, range, lockMode, hints, ...) but a projected result of the type type

stream

public Stream<Entity> stream()

Description copied from interface: PanacheBlockingQuery

Returns the current page of results as a Stream.

Specified by:

stream in interface PanacheBlockingQuery<Entity>

Returns:

the current page of results as a Stream.

See Also:

• PanacheQuery.list()
• PanacheQuery.page(Page)
• PanacheQuery.page()

firstResultOptional

public Optional<Entity> firstResultOptional()

Description copied from interface: PanacheBlockingQuery

Returns the first result of the current page index. This ignores the current page size to fetch a single result.

Specified by:

firstResultOptional in interface PanacheBlockingQuery<Entity>

Returns:

if found, an optional containing the entity, else Optional.empty().

See Also:

• PanacheBlockingQuery.singleResultOptional()

singleResultOptional

public Optional<Entity> singleResultOptional()

Description copied from interface: PanacheBlockingQuery

Executes this query for the current page and return a single result.

Specified by:

singleResultOptional in interface PanacheBlockingQuery<Entity>

Returns:

if found, an optional containing the entity, else Optional.empty().

See Also:

• PanacheBlockingQuery.firstResultOptional()