Module org.elasticsearch.server

Package org.elasticsearch.search.aggregations.bucket.prefix

Class IpPrefixAggregationBuilder

java.lang.Object

org.elasticsearch.search.aggregations.AggregationBuilder

org.elasticsearch.search.aggregations.AbstractAggregationBuilder<AB>

org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

org.elasticsearch.search.aggregations.bucket.prefix.IpPrefixAggregationBuilder

All Implemented Interfaces:

NamedWriteable, VersionedNamedWriteable, Writeable, Rewriteable<AggregationBuilder>, BaseAggregationBuilder, ToXContent, ToXContentFragment

public class IpPrefixAggregationBuilder
extends ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

A builder for IP prefix aggregations. This builder can operate with both IPv4 and IPv6 fields.

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder

ValuesSourceAggregationBuilder.LeafOnly<AB extends ValuesSourceAggregationBuilder<AB>>, ValuesSourceAggregationBuilder.MetricsAggregationBuilder<AB extends ValuesSourceAggregationBuilder<AB>>, ValuesSourceAggregationBuilder.SingleMetricAggregationBuilder<AB extends ValuesSourceAggregationBuilder<AB>>

Nested classes/interfaces inherited from class org.elasticsearch.search.aggregations.AggregationBuilder

AggregationBuilder.BucketCardinality, AggregationBuilder.CommonFields

Nested classes/interfaces inherited from interface org.elasticsearch.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 final ParseField	APPEND_PREFIX_LENGTH_FIELD
static final ParseField	IS_IPV6_FIELD
static final ParseField	KEYED_FIELD
static final ParseField	MIN_DOC_COUNT_FIELD
static final String	NAME
static final ObjectParser<IpPrefixAggregationBuilder,String>	PARSER
static final ParseField	PREFIX_LENGTH_FIELD
static final ValuesSourceRegistry.RegistryKey<IpPrefixAggregationSupplier>	REGISTRY_KEY

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

metadata

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

DEFAULT_PREALLOCATION, factoriesBuilder, name

Fields inherited from interface org.elasticsearch.index.query.Rewriteable

MAX_REWRITE_ROUNDS

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY, EMPTY_PARAMS

Constructor Summary

Constructors

Modifier	Constructor	Description
	IpPrefixAggregationBuilder(String name)	Create a new builder with the given name.
	IpPrefixAggregationBuilder(StreamInput in)	Read from a stream, for internal use only.
protected	IpPrefixAggregationBuilder(IpPrefixAggregationBuilder clone, AggregatorFactories.Builder factoriesBuilder, Map<String,Object> metadata)

Method Summary

Modifier and Type	Method	Description
IpPrefixAggregationBuilder	appendPrefixLength(boolean appendPrefixLength)	Set the appendPrefixLength on this builder, and return the builder so that calls can be chained.
AggregationBuilder.BucketCardinality	bucketCardinality()	A rough count of the number of buckets that Aggregators built by this builder will contain per owning parent bucket.
protected ValuesSourceType	defaultValueSourceType()	Aggregations should use this method to define a ValuesSourceType of last resort.
protected XContentBuilder	doXContentBody(XContentBuilder builder, ToXContent.Params params)
boolean	equals(Object o)
static org.apache.lucene.util.BytesRef	extractNetmask(int prefixLength, boolean isIpv6)
TransportVersion	getMinimalSupportedVersion()	The minimal version of the recipient this object can be sent to
String	getType()	The name of the type of aggregation built by this builder.
int	hashCode()
protected ValuesSourceAggregatorFactory	innerBuild(AggregationContext context, ValuesSourceConfig config, AggregatorFactory parent, AggregatorFactories.Builder subFactoriesBuilder)
protected void	innerWriteTo(StreamOutput out)	Write subclass's state to the stream.
IpPrefixAggregationBuilder	isIpv6(boolean isIpv6)	Set the isIpv6 on this builder, and return the builder so that calls can be chained.
IpPrefixAggregationBuilder	keyed(boolean keyed)	Set the keyed on this builder, and return the builder so that calls can be chained.
IpPrefixAggregationBuilder	minDocCount(long minDocCount)	Set the minDocCount on this builder, and return the builder so that calls can be chained.
IpPrefixAggregationBuilder	prefixLength(int prefixLength)	Set the prefixLength on this builder, and return the builder so that calls can be chained.
static void	registerAggregators(ValuesSourceRegistry.Builder builder)
protected AggregationBuilder	shallowCopy(AggregatorFactories.Builder factoriesBuilder, Map<String,Object> metadata)	Create a shallow copy of this builder and replacing AggregationBuilder.factoriesBuilder and metadata.

Methods inherited from class org.elasticsearch.search.aggregations.support.ValuesSourceAggregationBuilder

declareFields, declareFields, doBuild, doWriteTo, field, field, format, format, internalXContent, missing, resolveConfig, script, script, serializeTargetValueType, timeZone, timeZone, userValueTypeHint, userValueTypeHint

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

buildPipelineTree, bytesToPreallocate, deepCopy, doRewrite, getName, getOutputFieldNames, getPipelineAggregations, getQuery, getSubAggregations, isInSortOrderExecutionRequired, rewrite, supportsParallelCollection, supportsSampling, toString, validateSequentiallyOrdered, validateSequentiallyOrderedWithoutGaps

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.xcontent.ToXContentFragment

isFragment

Field Details

NAME

public static final String NAME

See Also:

• Constant Field Values

REGISTRY_KEY

public static final ValuesSourceRegistry.RegistryKey<IpPrefixAggregationSupplier> REGISTRY_KEY

PARSER

public static final ObjectParser<IpPrefixAggregationBuilder,String> PARSER

PREFIX_LENGTH_FIELD

public static final ParseField PREFIX_LENGTH_FIELD

IS_IPV6_FIELD

public static final ParseField IS_IPV6_FIELD

APPEND_PREFIX_LENGTH_FIELD

public static final ParseField APPEND_PREFIX_LENGTH_FIELD

MIN_DOC_COUNT_FIELD

public static final ParseField MIN_DOC_COUNT_FIELD

KEYED_FIELD

public static final ParseField KEYED_FIELD

Constructor Details

IpPrefixAggregationBuilder

public IpPrefixAggregationBuilder(StreamInput in)
                           throws IOException

Read from a stream, for internal use only.

Throws:

IOException

IpPrefixAggregationBuilder

public IpPrefixAggregationBuilder(String name)

Create a new builder with the given name.

IpPrefixAggregationBuilder

protected IpPrefixAggregationBuilder(IpPrefixAggregationBuilder clone,
 AggregatorFactories.Builder factoriesBuilder,
 Map<String,Object> metadata)

Method Details

registerAggregators

public static void registerAggregators(ValuesSourceRegistry.Builder builder)

minDocCount

public IpPrefixAggregationBuilder minDocCount(long minDocCount)

Set the minDocCount on this builder, and return the builder so that calls can be chained.

prefixLength

public IpPrefixAggregationBuilder prefixLength(int prefixLength)

Set the prefixLength on this builder, and return the builder so that calls can be chained.

Throws:

IllegalArgumentException - if prefixLength is negative.

isIpv6

public IpPrefixAggregationBuilder isIpv6(boolean isIpv6)

Set the isIpv6 on this builder, and return the builder so that calls can be chained.

appendPrefixLength

public IpPrefixAggregationBuilder appendPrefixLength(boolean appendPrefixLength)

Set the appendPrefixLength on this builder, and return the builder so that calls can be chained.

keyed

public IpPrefixAggregationBuilder keyed(boolean keyed)

Set the keyed on this builder, and return the builder so that calls can be chained.

shallowCopy

protected AggregationBuilder shallowCopy(AggregatorFactories.Builder factoriesBuilder,
 Map<String,Object> metadata)

Description copied from class: AggregationBuilder

Create a shallow copy of this builder and replacing AggregationBuilder.factoriesBuilder and metadata.

Specified by:

shallowCopy in class AggregationBuilder

bucketCardinality

public AggregationBuilder.BucketCardinality bucketCardinality()

Description copied from class: AggregationBuilder

A rough count of the number of buckets that Aggregators built by this builder will contain per owning parent bucket.

Specified by:

bucketCardinality in class AggregationBuilder

getType

public String getType()

Description copied from interface: BaseAggregationBuilder

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

innerWriteTo

protected void innerWriteTo(StreamOutput out)
                     throws IOException

Description copied from class: ValuesSourceAggregationBuilder

Write subclass's state to the stream.

Specified by:

innerWriteTo in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

Throws:

IOException

defaultValueSourceType

protected ValuesSourceType defaultValueSourceType()

Description copied from class: ValuesSourceAggregationBuilder

Aggregations should use this method to define a ValuesSourceType of last resort. This will only be used when the resolver can't find a field and the user hasn't provided a value type hint.

Specified by:

defaultValueSourceType in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

Returns:

The CoreValuesSourceType we expect this script to yield.

innerBuild

protected ValuesSourceAggregatorFactory innerBuild(AggregationContext context,
 ValuesSourceConfig config,
 AggregatorFactory parent,
 AggregatorFactories.Builder subFactoriesBuilder)
                                            throws IOException

Specified by:

innerBuild in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

Throws:

IOException

extractNetmask

public static org.apache.lucene.util.BytesRef extractNetmask(int prefixLength,
 boolean isIpv6)

Parameters:

prefixLength - the network prefix length which defines the size of the network.

isIpv6 - true for an IPv6 netmask, false for an IPv4 netmask.

Returns:

a 16-bytes representation of the subnet with 1s identifying the network part and 0s identifying the host part.

Throws:

IllegalArgumentException - if prefixLength is not in range [0, 128] for an IPv6 network, or is not in range [0, 32] for an IPv4 network.

doXContentBody

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

Specified by:

doXContentBody in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

Throws:

IOException

equals

public boolean equals(Object o)

Overrides:

equals in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

hashCode

public int hashCode()

Overrides:

hashCode in class ValuesSourceAggregationBuilder<IpPrefixAggregationBuilder>

getMinimalSupportedVersion

public TransportVersion getMinimalSupportedVersion()

Description copied from interface: VersionedNamedWriteable

The minimal version of the recipient this object can be sent to