Package org.opensearch.search.aggregations

Class PipelineAggregationBuilder

java.lang.Object

org.opensearch.search.aggregations.PipelineAggregationBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, org.opensearch.common.xcontent.ToXContent, org.opensearch.common.xcontent.ToXContentFragment, Rewriteable<PipelineAggregationBuilder>, BaseAggregationBuilder

Direct Known Subclasses:

AbstractPipelineAggregationBuilder

public abstract class PipelineAggregationBuilder
extends java.lang.Object
implements NamedWriteable, BaseAggregationBuilder, org.opensearch.common.xcontent.ToXContentFragment, Rewriteable<PipelineAggregationBuilder>

A factory that knows how to create an PipelineAggregator of a specific type.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PipelineAggregationBuilder.ValidationContext

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

org.opensearch.common.xcontent.ToXContent.DelegatingMapParams, org.opensearch.common.xcontent.ToXContent.MapParams, org.opensearch.common.xcontent.ToXContent.Params

Nested classes/interfaces inherited from interface org.opensearch.common.io.stream.Writeable

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

Field Summary

Fields

Modifier and Type	Field	Description
protected java.lang.String[]	bucketsPaths
protected java.lang.String	name

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

MAX_REWRITE_ROUNDS

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

EMPTY_PARAMS

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PipelineAggregationBuilder(java.lang.String name, java.lang.String[] bucketsPaths)	Constructs a new pipeline aggregator factory.

Method Summary

Modifier and Type	Method	Description
protected abstract PipelineAggregator	create()	Creates the pipeline aggregator
java.lang.String[]	getBucketsPaths()	Return the consumed buckets paths.
java.lang.String	getName()	Return this aggregation's name.
PipelineAggregationBuilder	rewrite(QueryRewriteContext context)	Rewrites this instance based on the provided context.
abstract PipelineAggregationBuilder	setMetadata(java.util.Map<java.lang.String,java.lang.Object> metadata)	Associate metadata with this PipelineAggregationBuilder.
PipelineAggregationBuilder	subAggregations(AggregatorFactories.Builder subFactories)	Set the sub aggregations if this aggregation supports sub aggregations.
java.lang.String	toString()
protected abstract void	validate(PipelineAggregationBuilder.ValidationContext context)	Makes sure this builder is properly configured.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opensearch.search.aggregations.BaseAggregationBuilder

getType

Methods inherited from interface org.opensearch.common.io.stream.NamedWriteable

getWriteableName

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

toXContent

Methods inherited from interface org.opensearch.common.xcontent.ToXContentFragment

isFragment

Methods inherited from interface org.opensearch.common.io.stream.Writeable

writeTo

Field Details

name

protected final java.lang.String name

bucketsPaths

protected final java.lang.String[] bucketsPaths

Constructor Details

PipelineAggregationBuilder

protected PipelineAggregationBuilder(java.lang.String name, java.lang.String[] bucketsPaths)

Constructs a new pipeline aggregator factory.

Parameters:

name - The aggregation name

Method Details

getName

public java.lang.String getName()

Return this aggregation's name.

getBucketsPaths

public final java.lang.String[] getBucketsPaths()

Return the consumed buckets paths.

validate

protected abstract void validate(PipelineAggregationBuilder.ValidationContext context)

Makes sure this builder is properly configured.

create

protected abstract PipelineAggregator create()

Creates the pipeline aggregator

Returns:

The created aggregator

setMetadata

public abstract PipelineAggregationBuilder setMetadata(java.util.Map<java.lang.String,java.lang.Object> metadata)

Associate metadata with this PipelineAggregationBuilder.

Specified by:

setMetadata in interface BaseAggregationBuilder

subAggregations

public PipelineAggregationBuilder subAggregations(AggregatorFactories.Builder subFactories)

Description copied from interface: BaseAggregationBuilder

Set the sub aggregations if this aggregation supports sub aggregations. Returns this for chaining.

Specified by:

subAggregations in interface BaseAggregationBuilder

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

rewrite

public PipelineAggregationBuilder rewrite(QueryRewriteContext context) throws java.io.IOException

Rewrites this instance based on the provided context. The returned objects will be the same instance as this if no changes during the rewrite were applied.

The default implementation return the same instance. It should be overridden by aggregations that must load data before they can be run, particularly if that load must by asynchronous.

Specified by:

rewrite in interface Rewriteable<PipelineAggregationBuilder>

Throws:

java.io.IOException