Package io.quarkiverse.groovy.hibernate.reactive.panache

Interface PanacheQuery<Entity>

Type Parameters:
Entity - The entity type being queried
All Known Implementing Classes:
PanacheQueryImpl
public interface PanacheQuery<Entity>

Interface representing an entity query, which abstracts the use of paging, getting the number of results, and operating on List.

Instances of this interface cannot mutate the query itself or its parameters: only paging information can be modified, and instances of this interface can be reused to obtain multiple pages of results.

  • Method Summary

    Modifier and Type
    Method
    Description
    io.smallrye.mutiny.Uni<Long>
    count()
    Reads and caches the total number of entities this query operates on.
    <T extends Entity>
    PanacheQuery<T>
    filter(String filterName)
    Enables a Hibernate filter during fetching of results for this query.
    <T extends Entity>
    PanacheQuery<T>
    filter(String filterName, io.quarkus.panache.common.Parameters parameters)
    Enables a Hibernate filter during fetching of results for this query.
    <T extends Entity>
    PanacheQuery<T>
    filter(String filterName, Map<String,Object> parameters)
    Enables a Hibernate filter during fetching of results for this query.
    <T extends Entity>
    PanacheQuery<T>
    firstPage()
    Sets the current page to the first page
    <T extends Entity>
    io.smallrye.mutiny.Uni<T>
    firstResult()
    Returns the first result of the current page index.
    io.smallrye.mutiny.Uni<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.
    <T extends Entity>
    io.smallrye.mutiny.Uni<PanacheQuery<T>>
    lastPage()
    Sets the current page to the last page.
    <T extends Entity>
    io.smallrye.mutiny.Uni<List<T>>
    list()
    Returns the current page of results as a List.
    <T extends Entity>
    PanacheQuery<T>
    nextPage()
    Sets the current page to the next page
    io.quarkus.panache.common.Page
    page()
    Returns the current page.
    <T extends Entity>
    PanacheQuery<T>
    page(int pageIndex, int pageSize)
    Sets the current page.
    <T extends Entity>
    PanacheQuery<T>
    page(io.quarkus.panache.common.Page page)
    Sets the current page.
    io.smallrye.mutiny.Uni<Integer>
    pageCount()
    Returns the total number of pages to be read using the current page size.
    <T extends Entity>
    PanacheQuery<T>
    previousPage()
    Sets the current page to the previous page (or the first page if there is no previous page)
    <T> PanacheQuery<T>
    project(Class<T> type)
    Defines a projection class: the getters, and the public fields, will be used to restrict which fields should be retrieved from the database.
    <T extends Entity>
    PanacheQuery<T>
    range(int startIndex, int lastIndex)
    Switch the query to use a fixed range (start index - last index) instead of a page.
    <T extends Entity>
    io.smallrye.mutiny.Uni<T>
    singleResult()
    Executes this query for the current page and return a single result.
    <T extends Entity>
    PanacheQuery<T>
    withHint(String hintName, Object value)
    Set a query property or hint on the underlying JPA Query.
    <T extends Entity>
    PanacheQuery<T>
    withLock(jakarta.persistence.LockModeType lockModeType)
    Define the locking strategy used for this query.

  • Method Details

    • project

      <T> PanacheQuery<T> project(Class<T> type)
      Defines a projection class: the getters, and the public fields, will be used to restrict which fields should be retrieved from the database.
      Returns:
      a new query with the same state as the previous one (params, page, range, lockMode, hints, ...).

    • page

      <T extends Entity> PanacheQuery<T> page(io.quarkus.panache.common.Page page)
      Sets the current page.
      Parameters:
      page - the new page
      Returns:
      this query, modified
      See Also:

    • page

      <T extends Entity> PanacheQuery<T> page(int pageIndex, int pageSize)
      Sets the current page.
      Parameters:
      pageIndex - the page index (0-based)
      pageSize - the page size
      Returns:
      this query, modified
      See Also:

    • nextPage

      <T extends Entity> PanacheQuery<T> nextPage()
      Sets the current page to the next page
      Returns:
      this query, modified
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • previousPage

      <T extends Entity> PanacheQuery<T> previousPage()
      Sets the current page to the previous page (or the first page if there is no previous page)
      Returns:
      this query, modified
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • firstPage

      <T extends Entity> PanacheQuery<T> firstPage()
      Sets the current page to the first page
      Returns:
      this query, modified
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • lastPage

      @CheckReturnValue <T extends Entity> io.smallrye.mutiny.Uni<PanacheQuery<T>> lastPage()
      Sets the current page to the last page. This will cause reading of the entity count.
      Returns:
      this query, modified
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • hasNextPage

      @CheckReturnValue io.smallrye.mutiny.Uni<Boolean> hasNextPage()
      Returns true if there is another page to read after the current one. This will cause reading of the entity count.
      Returns:
      true if there is another page to read
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • hasPreviousPage

      boolean hasPreviousPage()
      Returns true if there is a page to read before the current one.
      Returns:
      true if there is a previous page to read
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • pageCount

      @CheckReturnValue io.smallrye.mutiny.Uni<Integer> pageCount()
      Returns the total number of pages to be read using the current page size. This will cause reading of the entity count.
      Returns:
      the total number of pages to be read using the current page size.
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set

    • page

      io.quarkus.panache.common.Page page()
      Returns the current page.
      Returns:
      the current page
      Throws:
      UnsupportedOperationException - if a page hasn't been set or if a range is already set
      See Also:

    • range

      <T extends Entity> PanacheQuery<T> range(int startIndex, int lastIndex)
      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.
      Parameters:
      startIndex - the index of the first element, starting at 0
      lastIndex - the index of the last element
      Returns:
      this query, modified

    • withLock

      <T extends Entity> PanacheQuery<T> withLock(jakarta.persistence.LockModeType lockModeType)
      Define the locking strategy used for this query.
      Parameters:
      lockModeType - the locking strategy to be used for this query.
      Returns:
      this query, modified

    • withHint

      <T extends Entity> PanacheQuery<T> withHint(String hintName, Object value)
      Set a query property or hint on the underlying JPA Query.
      Parameters:
      hintName - name of the property or hint.
      value - value for the property or hint.
      Returns:
      this query, modified

    • filter

      <T extends Entity> PanacheQuery<T> filter(String filterName, io.quarkus.panache.common.Parameters parameters)

      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.

      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

      <T extends Entity> PanacheQuery<T> filter(String filterName, Map<String,Object> parameters)

      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.

      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

      <T extends Entity> PanacheQuery<T> filter(String filterName)

      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.

      Parameters:
      filterName - The name of the filter to enable
      Returns:
      this query, modified

    • count

      @CheckReturnValue io.smallrye.mutiny.Uni<Long> count()
      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.
      Returns:
      the total number of entities this query operates on, cached.

    • list

      @CheckReturnValue <T extends Entity> io.smallrye.mutiny.Uni<List<T>> list()
      Returns the current page of results as a List.
      Returns:
      the current page of results as a List.
      See Also:

    • firstResult

      @CheckReturnValue <T extends Entity> io.smallrye.mutiny.Uni<T> firstResult()
      Returns the first result of the current page index. This ignores the current page size to fetch a single result.
      Returns:
      the first result of the current page index, or null if there are no results.
      See Also:

    • singleResult

      @CheckReturnValue <T extends Entity> io.smallrye.mutiny.Uni<T> singleResult()
      Executes this query for the current page and return a single result.
      Returns:
      the single result (throws if there is not exactly one)
      Throws:
      jakarta.persistence.NoResultException - if there is no result
      jakarta.persistence.NonUniqueResultException - if there are more than one result
      See Also: