Package org.elasticsearch.client.core

Class CountRequest

java.lang.Object
org.elasticsearch.transport.TransportMessage
org.elasticsearch.transport.TransportRequest
org.elasticsearch.action.ActionRequest
org.elasticsearch.client.core.CountRequest
All Implemented Interfaces:
IndicesRequest, IndicesRequest.Replaceable, Writeable, ToXContent, ToXContentObject, TaskAwareRequest
public final class CountRequest
extends ActionRequest
implements IndicesRequest.Replaceable, ToXContentObject
Encapsulates a request to _count API against one, several or all indices.

  • Constructor Details

    • CountRequest

      public CountRequest()

    • CountRequest

      public CountRequest​(java.lang.String... indices)
      Constructs a new count request against the indices. No indices provided here means that count will execute on all indices.

    • CountRequest

      @Deprecated public CountRequest​(java.lang.String[] indices, SearchSourceBuilder searchSourceBuilder)
      Deprecated.
      The count api only supports a query. Use CountRequest(String[], QueryBuilder) instead.
      Constructs a new search request against the provided indices with the given search source.

    • CountRequest

      public CountRequest​(java.lang.String[] indices, QueryBuilder query)
      Constructs a new search request against the provided indices with the given query.

  • Method Details

    • validate

      public ActionRequestValidationException validate()
      Specified by:
      validate in class ActionRequest

    • indices

      public CountRequest indices​(java.lang.String... indices)
      Sets the indices the count will be executed on.
      Specified by:
      indices in interface IndicesRequest.Replaceable

    • source

      @Deprecated public CountRequest source​(SearchSourceBuilder searchSourceBuilder)
      Deprecated.
      The count api only supports a query. Use query(QueryBuilder) instead.
      The source of the count request.

    • query

      public CountRequest query​(QueryBuilder query)
      Sets the query to execute for this count request.

    • types

      @Deprecated public CountRequest types​(java.lang.String... types)
      Deprecated.
      Types are in the process of being removed. Instead of using a type, prefer to filter on a field on the document.
      The document types to execute the count against. Defaults to be executed against all types.

    • routing

      public CountRequest routing​(java.lang.String routing)
      The routing values to control the shards that the search will be executed on.

    • routing

      public CountRequest routing​(java.lang.String... routings)
      A comma separated list of routing values to control the shards the count will be executed on.

    • indicesOptions

      public CountRequest indicesOptions​(IndicesOptions indicesOptions)
      Returns the indices options used to resolve indices. They tell for instance whether a single index is accepted, whether an empty array will be converted to _all, and how wildcards will be expanded if needed.
      See Also:
      IndicesOptions

    • preference

      public CountRequest preference​(java.lang.String preference)
      Sets the preference to execute the count. Defaults to randomize across shards. Can be set to _local to prefer local shards or a custom value, which guarantees that the same order will be used across different requests.

    • indicesOptions

      public IndicesOptions indicesOptions()
      Specified by:
      indicesOptions in interface IndicesRequest

    • routing

      public java.lang.String routing()

    • preference

      public java.lang.String preference()

    • indices

      public java.lang.String[] indices()
      Specified by:
      indices in interface IndicesRequest

    • minScore

      public java.lang.Float minScore()

    • minScore

      public CountRequest minScore​(java.lang.Float minScore)

    • terminateAfter

      public int terminateAfter()

    • terminateAfter

      public CountRequest terminateAfter​(int terminateAfter)

    • types

      @Deprecated public java.lang.String[] types()
      Deprecated.
      Types are in the process of being removed. Instead of using a type, prefer to filter on a field on the document.

    • source

      @Deprecated public SearchSourceBuilder source()
      Deprecated.
      The count api only supports a query. Use query() instead.
      Returns:
      the source builder

    • query

      public QueryBuilder query()
      Returns:
      The provided query to execute with the count request or null if no query was provided.

    • toXContent

      public XContentBuilder toXContent​(XContentBuilder builder, ToXContent.Params params) throws java.io.IOException
      Specified by:
      toXContent in interface ToXContent
      Throws:
      java.io.IOException

    • equals

      public boolean equals​(java.lang.Object o)
      Overrides:
      equals in class java.lang.Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class java.lang.Object