Class TermsAggregationBuilder
java.lang.Object
org.elasticsearch.search.aggregations.AggregationBuilder
org.elasticsearch.search.aggregations.AbstractAggregationBuilder<AB>
org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
org.elasticsearch.search.aggregations.bucket.terms.TermsAggregationBuilder
- All Implemented Interfaces:
NamedWriteable
,Writeable
,ToXContent
,ToXContentFragment
,BaseAggregationBuilder
,MultiBucketAggregationBuilder
public class TermsAggregationBuilder extends ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder> implements MultiBucketAggregationBuilder
-
Nested Class Summary
Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder
ValuesSourceAggregationBuilder.LeafOnly<VS extends ValuesSource,AB extends ValuesSourceAggregationBuilder<VS,AB>>
Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.AggregationBuilder
AggregationBuilder.CommonFields
Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent
ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params
Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable
Writeable.Reader<V>, Writeable.Writer<V>
-
Field Summary
Fields Modifier and Type Field Description static ParseField
EXECUTION_HINT_FIELD_NAME
static ParseField
MIN_DOC_COUNT_FIELD_NAME
static java.lang.String
NAME
static ParseField
ORDER_FIELD
static ParseField
REQUIRED_SIZE_FIELD_NAME
static ParseField
SHARD_MIN_DOC_COUNT_FIELD_NAME
static ParseField
SHARD_SIZE_FIELD_NAME
static ParseField
SHOW_TERM_DOC_COUNT_ERROR
Fields inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder
config
Fields inherited from class org.elasticsearch.search.aggregations.AbstractAggregationBuilder
metaData
Fields inherited from class org.elasticsearch.search.aggregations.AggregationBuilder
factoriesBuilder, name
-
Constructor Summary
Constructors Modifier Constructor Description TermsAggregationBuilder(java.lang.String name, ValueType valueType)
TermsAggregationBuilder(StreamInput in)
Read from a stream.protected
TermsAggregationBuilder(TermsAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder, java.util.Map<java.lang.String,java.lang.Object> metaData)
-
Method Summary
Modifier and Type Method Description Aggregator.SubAggCollectionMode
collectMode()
Expert: get the collection mode.TermsAggregationBuilder
collectMode(Aggregator.SubAggCollectionMode collectMode)
Expert: set the collection mode.protected AggregationBuilder
doRewrite(QueryRewriteContext queryShardContext)
Rewrites this aggregation builder into its primitive form.protected XContentBuilder
doXContentBody(XContentBuilder builder, ToXContent.Params params)
boolean
equals(java.lang.Object obj)
java.lang.String
executionHint()
Expert: gets an execution hint to the aggregation.TermsAggregationBuilder
executionHint(java.lang.String executionHint)
Expert: sets an execution hint to the aggregation.java.lang.String
getType()
The name of the type of aggregation built by this builder.int
hashCode()
IncludeExclude
includeExclude()
Get terms to include and exclude from the aggregation resultsTermsAggregationBuilder
includeExclude(IncludeExclude includeExclude)
Set terms to include and exclude from the aggregation resultsprotected ValuesSourceAggregatorFactory<ValuesSource>
innerBuild(QueryShardContext queryShardContext, ValuesSourceConfig<ValuesSource> config, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder)
protected void
innerWriteTo(StreamOutput out)
Write subclass's state to the stream.long
minDocCount()
Returns the minimum document count required per termTermsAggregationBuilder
minDocCount(long minDocCount)
Set the minimum document count terms should have in order to appear in the response.BucketOrder
order()
Gets the order in which the buckets will be returned.TermsAggregationBuilder
order(java.util.List<BucketOrder> orders)
Sets the order in which the buckets will be returned.TermsAggregationBuilder
order(BucketOrder order)
Set a new order on this builder and return the builder so that calls can be chained.static AggregationBuilder
parse(java.lang.String aggregationName, XContentParser parser)
protected boolean
serializeTargetValueType(Version version)
Should this builder serialize its targetValueType? Defaults to false.protected AggregationBuilder
shallowCopy(AggregatorFactories.Builder factoriesBuilder, java.util.Map<java.lang.String,java.lang.Object> metaData)
Create a shallow copy of this builder and replacingAggregationBuilder.factoriesBuilder
andmetaData
.long
shardMinDocCount()
Returns the minimum document count required per term, per shardTermsAggregationBuilder
shardMinDocCount(long shardMinDocCount)
Set the minimum document count terms should have on the shard in order to appear in the response.int
shardSize()
Returns the number of term buckets per shard that are currently configuredTermsAggregationBuilder
shardSize(int shardSize)
Sets the shard_size - indicating the number of term buckets each shard will return to the coordinating node (the node that coordinates the search execution).boolean
showTermDocCountError()
Get whether doc count error will be return for individual termsTermsAggregationBuilder
showTermDocCountError(boolean showTermDocCountError)
Set whether doc count error will be return for individual termsint
size()
Returns the number of term buckets currently configuredTermsAggregationBuilder
size(int size)
Sets the size - indicating how many term buckets should be returned (defaults to 10)Methods inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder
defaultValueType, doBuild, doWriteTo, field, field, format, format, internalXContent, missing, missing, resolveConfig, resolveScriptAny, script, script, timeZone, timeZone, valueType, valueType
Methods inherited from class org.elasticsearch.search.aggregations.AbstractAggregationBuilder
build, getMetaData, getWriteableName, setMetaData, subAggregation, subAggregation, subAggregations, toXContent, writeTo
Methods inherited from class org.elasticsearch.search.aggregations.AggregationBuilder
getName, getPipelineAggregations, getSubAggregations, rewrite, toString
-
Field Details
-
NAME
public static final java.lang.String NAME- See Also:
- Constant Field Values
-
EXECUTION_HINT_FIELD_NAME
-
SHARD_SIZE_FIELD_NAME
-
MIN_DOC_COUNT_FIELD_NAME
-
SHARD_MIN_DOC_COUNT_FIELD_NAME
-
REQUIRED_SIZE_FIELD_NAME
-
SHOW_TERM_DOC_COUNT_ERROR
-
ORDER_FIELD
-
-
Constructor Details
-
TermsAggregationBuilder
-
TermsAggregationBuilder
protected TermsAggregationBuilder(TermsAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder, java.util.Map<java.lang.String,java.lang.Object> metaData) -
TermsAggregationBuilder
Read from a stream.- Throws:
java.io.IOException
-
-
Method Details
-
parse
public static AggregationBuilder parse(java.lang.String aggregationName, XContentParser parser) throws java.io.IOException- Throws:
java.io.IOException
-
shallowCopy
protected AggregationBuilder shallowCopy(AggregatorFactories.Builder factoriesBuilder, java.util.Map<java.lang.String,java.lang.Object> metaData)Description copied from class:AggregationBuilder
Create a shallow copy of this builder and replacingAggregationBuilder.factoriesBuilder
andmetaData
. Used byAggregationBuilder.rewrite(QueryRewriteContext)
.- Specified by:
shallowCopy
in classAggregationBuilder
-
serializeTargetValueType
Description copied from class:ValuesSourceAggregationBuilder
Should this builder serialize its targetValueType? Defaults to false. All subclasses that override this to true should use the three argument read constructor rather than the four argument version.- Overrides:
serializeTargetValueType
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
- Parameters:
version
- For backwards compatibility, subclasses can change behavior based on the version
-
innerWriteTo
Description copied from class:ValuesSourceAggregationBuilder
Write subclass's state to the stream.- Specified by:
innerWriteTo
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
- Throws:
java.io.IOException
-
size
Sets the size - indicating how many term buckets should be returned (defaults to 10) -
size
public int size()Returns the number of term buckets currently configured -
shardSize
Sets the shard_size - indicating the number of term buckets each shard will return to the coordinating node (the node that coordinates the search execution). The higher the shard size is, the more accurate the results are. -
shardSize
public int shardSize()Returns the number of term buckets per shard that are currently configured -
minDocCount
Set the minimum document count terms should have in order to appear in the response. -
minDocCount
public long minDocCount()Returns the minimum document count required per term -
shardMinDocCount
Set the minimum document count terms should have on the shard in order to appear in the response. -
shardMinDocCount
public long shardMinDocCount()Returns the minimum document count required per term, per shard -
order
Set a new order on this builder and return the builder so that calls can be chained. A tie-breaker may be added to avoid non-deterministic ordering. -
order
Sets the order in which the buckets will be returned. A tie-breaker may be added to avoid non-deterministic ordering. -
order
Gets the order in which the buckets will be returned. -
executionHint
Expert: sets an execution hint to the aggregation. -
executionHint
public java.lang.String executionHint()Expert: gets an execution hint to the aggregation. -
collectMode
Expert: set the collection mode. -
collectMode
Expert: get the collection mode. -
includeExclude
Set terms to include and exclude from the aggregation results -
includeExclude
Get terms to include and exclude from the aggregation results -
showTermDocCountError
public boolean showTermDocCountError()Get whether doc count error will be return for individual terms -
showTermDocCountError
Set whether doc count error will be return for individual terms -
innerBuild
protected ValuesSourceAggregatorFactory<ValuesSource> innerBuild(QueryShardContext queryShardContext, ValuesSourceConfig<ValuesSource> config, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder) throws java.io.IOException- Specified by:
innerBuild
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
- Throws:
java.io.IOException
-
doXContentBody
protected XContentBuilder doXContentBody(XContentBuilder builder, ToXContent.Params params) throws java.io.IOException- Specified by:
doXContentBody
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
- Throws:
java.io.IOException
-
hashCode
public int hashCode()- Overrides:
hashCode
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
-
equals
public boolean equals(java.lang.Object obj)- Overrides:
equals
in classValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>
-
getType
public java.lang.String getType()Description copied from interface:BaseAggregationBuilder
The name of the type of aggregation built by this builder.- Specified by:
getType
in interfaceBaseAggregationBuilder
-
doRewrite
protected AggregationBuilder doRewrite(QueryRewriteContext queryShardContext) throws java.io.IOExceptionDescription copied from class:AggregationBuilder
Rewrites this aggregation builder into its primitive form. By default this method return the builder itself. If the builder did not change the identity reference must be returned otherwise the builder will be rewritten infinitely.- Overrides:
doRewrite
in classAggregationBuilder
- Throws:
java.io.IOException
-