Interface Query<T>

All Superinterfaces:
Iterable<T>, Query<T>
All Known Implementing Classes:
BaseQuery
@Deprecated(since="14.0", forRemoval=true) public interface Query<T> extends Query<T>
Deprecated, for removal: This API element is subject to removal in a future version.
use @Query instead
An immutable object representing both the query and the result. The result is obtained lazily when one of the methods in this interface is executed first time. The query is executed only once. Further calls will just return the previously cached results.
Since:
6.0
Author:
anistor@redhat.com

  • Method Details

    • execute

      QueryResult<T> execute()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Executes the query (a SELECT statement). Subsequent invocations cause the query to be re-executed.

      Executing a DELETE is also allowed. In this case, no results will be returned, but the number of affected entries will be returned as the hit count in the QueryResult.

      Specified by:
      execute in interface Query<T>
      Returns:
      QueryResult with the results.

    • executeAsync

      CompletionStage<QueryResult<T>> executeAsync()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Due to Generic limitations the erased type must stay as the commons QueryResult. Feel free to cast to QueryResult as needed in chained operations on the stage.
      Specified by:
      executeAsync in interface Query<T>
      Returns:
      a stage when complete has the results

    • getResultSize

      @Deprecated int getResultSize()
      Deprecated.
      since 10.1. This will be removed in 12. It's closest replacement is QueryResult.hitCount() which returns an optional long.
      Gets the total number of results matching the query, ignoring pagination (startOffset, maxResults).
      Returns:
      total number of results.

    • getProjection

      @Deprecated String[] getProjection()
      Deprecated.
      since 11.0. This method will be removed in next major version. To find out if a query uses projections use Query.hasProjections()
      Returns:
      the values for query projections or null if the query does not have projections.

    • startOffset

      Query<T> startOffset(long startOffset)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Sets the starting offset into the overall result set. Must be equal or greater than 0. Use it in combination with Query.maxResults(int) to implement pagination.
      Specified by:
      startOffset in interface Query<T>
      Parameters:
      startOffset - the start offset
      Returns:
      this, for method chaining

    • maxResults

      Query<T> maxResults(int maxResults)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Sets the maximum number of results to return. Must be equal or greater than 0. When 0 is set, the execution of the query will not return any results, but will still information about the total number of hits. Use it in combination with Query.startOffset(long) to implement pagination.
      Specified by:
      maxResults in interface Query<T>
      Parameters:
      maxResults - the maximum number of results to return
      Returns:
      this, for method chaining

    • hitCountAccuracy

      Query<T> hitCountAccuracy(int hitCountAccuracy)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Limits the required accuracy of the hit count for the indexed queries to an upper-bound. Setting the hit-count-accuracy could improve the performance of queries targeting large data sets.
      Specified by:
      hitCountAccuracy in interface Query<T>
      Parameters:
      hitCountAccuracy - The value to apply
      Returns:
      this, for method chaining

    • setParameter

      Query<T> setParameter(String paramName, Object paramValue)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Sets the value of a named parameter.
      Specified by:
      setParameter in interface Query<T>
      Parameters:
      paramName - the parameters name (non-empty and not null)
      paramValue - a non-null value
      Returns:
      itself

    • setParameters

      Query<T> setParameters(Map<String,Object> paramValues)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Sets multiple named parameters at once. Parameter names cannot be empty or null. Parameter values must not be null.
      Specified by:
      setParameters in interface Query<T>
      Parameters:
      paramValues - a Map of parameters
      Returns:
      itself

    • timeout

      Query<T> timeout(long timeout, TimeUnit timeUnit)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Description copied from interface: Query
      Set the timeout for this query. If the query hasn't finished processing before the timeout, a timeout will be thrown. For queries that use the index, the timeout is handled on a best effort basis, and the supplied time is rounded to the nearest millisecond.
      Specified by:
      timeout in interface Query<T>