org.elasticsearch.search.aggregations.bucket.terms

Class TermsAggregationBuilder

java.lang.Object

org.elasticsearch.action.support.ToXContentToBytes

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, BaseAggregationBuilder

public class TermsAggregationBuilder
extends ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

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.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Field Summary

Fields

Modifier and Type	Field and 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

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor and Description
TermsAggregationBuilder(StreamInput in) Read from a stream.
TermsAggregationBuilder(java.lang.String name, ValueType valueType)

Method Summary

Modifier and Type	Method and Description
Aggregator.SubAggCollectionMode	collectMode() Expert: get the collection mode.
TermsAggregationBuilder	collectMode(Aggregator.SubAggCollectionMode collectMode) Expert: set the collection mode.
protected XContentBuilder	doXContentBody(XContentBuilder builder, ToXContent.Params params)
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.
IncludeExclude	includeExclude() Get terms to include and exclude from the aggregation results
TermsAggregationBuilder	includeExclude(IncludeExclude includeExclude) Set terms to include and exclude from the aggregation results
protected ValuesSourceAggregatorFactory<ValuesSource,?>	innerBuild(SearchContext context, ValuesSourceConfig<ValuesSource> config, AggregatorFactory<?> parent, AggregatorFactories.Builder subFactoriesBuilder)
protected boolean	innerEquals(java.lang.Object obj)
protected int	innerHashCode()
protected void	innerWriteTo(StreamOutput out) Write subclass's state to the stream.
long	minDocCount() Returns the minimum document count required per term
TermsAggregationBuilder	minDocCount(long minDocCount) Set the minimum document count terms should have in order to appear in the response.
Terms.Order	order() Gets the order in which the buckets will be returned.
TermsAggregationBuilder	order(java.util.List<Terms.Order> orders) Sets the order in which the buckets will be returned.
TermsAggregationBuilder	order(Terms.Order order) Sets the order in which the buckets will be returned.
static AggregationBuilder	parse(java.lang.String aggregationName, QueryParseContext context)
protected boolean	serializeTargetValueType() Should this builder serialize its targetValueType? Defaults to false.
TermsAggregationBuilder	shardMinDocCount(long shardMinDocCount) Set the minimum document count terms should have on the shard in order to appear in the response.
TermsAggregationBuilder	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 terms
TermsAggregationBuilder	showTermDocCountError(boolean showTermDocCountError) Set whether doc count error will be return for individual terms
TermsAggregationBuilder	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

doBuild, doEquals, doHashCode, doWriteTo, field, field, format, format, internalXContent, missing, missing, resolveConfig, script, script, timeZone, timeZone, valueType, valueType

Methods inherited from class org.elasticsearch.search.aggregations.AbstractAggregationBuilder

build, equals, getWriteableName, hashCode, setMetaData, subAggregation, subAggregation, subAggregations, toXContent, writeTo

Methods inherited from class org.elasticsearch.search.aggregations.AggregationBuilder

getName

Methods inherited from class org.elasticsearch.action.support.ToXContentToBytes

buildAsBytes, buildAsBytes, toString, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContent

isFragment

Field Detail

NAME

public static final java.lang.String NAME

See Also:

Constant Field Values

EXECUTION_HINT_FIELD_NAME

public static final ParseField EXECUTION_HINT_FIELD_NAME

SHARD_SIZE_FIELD_NAME

public static final ParseField SHARD_SIZE_FIELD_NAME

MIN_DOC_COUNT_FIELD_NAME

public static final ParseField MIN_DOC_COUNT_FIELD_NAME

SHARD_MIN_DOC_COUNT_FIELD_NAME

public static final ParseField SHARD_MIN_DOC_COUNT_FIELD_NAME

REQUIRED_SIZE_FIELD_NAME

public static final ParseField REQUIRED_SIZE_FIELD_NAME

SHOW_TERM_DOC_COUNT_ERROR

public static final ParseField SHOW_TERM_DOC_COUNT_ERROR

ORDER_FIELD

public static final ParseField ORDER_FIELD

Constructor Detail

TermsAggregationBuilder

public TermsAggregationBuilder(java.lang.String name,
                               ValueType valueType)

TermsAggregationBuilder

public TermsAggregationBuilder(StreamInput in)
                        throws java.io.IOException

Read from a stream.

Throws:

java.io.IOException

Method Detail

parse

public static AggregationBuilder parse(java.lang.String aggregationName,
                                       QueryParseContext context)
                                throws java.io.IOException

Throws:

java.io.IOException

serializeTargetValueType

protected boolean 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 class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

innerWriteTo

protected void innerWriteTo(StreamOutput out)
                     throws java.io.IOException

Description copied from class: ValuesSourceAggregationBuilder

Write subclass's state to the stream.

Specified by:

innerWriteTo in class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

Throws:

java.io.IOException

size

public TermsAggregationBuilder size(int size)

Sets the size - indicating how many term buckets should be returned (defaults to 10)

shardSize

public TermsAggregationBuilder 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). The higher the shard size is, the more accurate the results are.

minDocCount

public TermsAggregationBuilder minDocCount(long 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

public TermsAggregationBuilder shardMinDocCount(long shardMinDocCount)

Set the minimum document count terms should have on the shard in order to appear in the response.

order

public TermsAggregationBuilder order(Terms.Order order)

Sets the order in which the buckets will be returned.

order

public TermsAggregationBuilder order(java.util.List<Terms.Order> orders)

Sets the order in which the buckets will be returned.

order

public Terms.Order order()

Gets the order in which the buckets will be returned.

executionHint

public TermsAggregationBuilder executionHint(java.lang.String executionHint)

Expert: sets an execution hint to the aggregation.

executionHint

public java.lang.String executionHint()

Expert: gets an execution hint to the aggregation.

collectMode

public TermsAggregationBuilder collectMode(Aggregator.SubAggCollectionMode collectMode)

Expert: set the collection mode.

collectMode

public Aggregator.SubAggCollectionMode collectMode()

Expert: get the collection mode.

includeExclude

public TermsAggregationBuilder includeExclude(IncludeExclude includeExclude)

Set terms to include and exclude from the aggregation results

includeExclude

public IncludeExclude 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

public TermsAggregationBuilder showTermDocCountError(boolean showTermDocCountError)

Set whether doc count error will be return for individual terms

innerBuild

protected ValuesSourceAggregatorFactory<ValuesSource,?> innerBuild(SearchContext context,
                                                                   ValuesSourceConfig<ValuesSource> config,
                                                                   AggregatorFactory<?> parent,
                                                                   AggregatorFactories.Builder subFactoriesBuilder)
                                                            throws java.io.IOException

Specified by:

innerBuild in class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

Throws:

java.io.IOException

doXContentBody

protected XContentBuilder doXContentBody(XContentBuilder builder,
                                         ToXContent.Params params)
                                  throws java.io.IOException

Specified by:

doXContentBody in class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

Throws:

java.io.IOException

innerHashCode

protected int innerHashCode()

Specified by:

innerHashCode in class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

innerEquals

protected boolean innerEquals(java.lang.Object obj)

Specified by:

innerEquals in class ValuesSourceAggregationBuilder<ValuesSource,TermsAggregationBuilder>

getType

public java.lang.String getType()

Description copied from interface: BaseAggregationBuilder

The name of the type of aggregation built by this builder.