lumis.portal.bigdata.query

Class TermsAggregation

java.lang.Object

lumis.portal.bigdata.query.TermsAggregation

All Implemented Interfaces:

IAggregation, IFieldAwareAggregation, IMultiBucketAggregation, ISizeAwareAggregation, ISubAggregationAwareAggregation

@StableMinor(version="10.1",
             sinceVersion="9.0")
public class TermsAggregation
extends Object
implements ISizeAwareAggregation, IFieldAwareAggregation

Aggregation that produces an ITermsAggregationResult. This aggregation splits the documents in the context in multiple buckets accordingly to their aggregated field value. This aggregation does not work with the following data types:

• DocumentTypeField.DataType.ATTACHMENT
• DocumentTypeField.DataType.FLAT_OBJECT
• DocumentTypeField.DataType.HTML
• DocumentTypeField.DataType.NESTED_OBJECT
• DocumentTypeField.DataType.GEO_POINT

Since:

9.0.0

Version:

$Revision: 19961 $ $Date: 2017-02-21 21:39:20 +0000 (Tue, 21 Feb 2017) $

Constructor Summary

Constructors

Constructor and Description
TermsAggregation(String id, DocumentTypeField field) Creates a new instance.
TermsAggregation(String id, DocumentTypeField field, Integer size) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
void	addSubAggregation(IAggregation aggregation) Adds the given sub-aggregation.
void	addSubAggregations(IAggregation... aggregations) Adds the given sub-aggregations.
void	addSubAggregations(List<IAggregation> aggregations) Adds the given sub-aggregations.
DocumentTypeField	getField() Returns the field this aggregation is bound to.
String	getId() Returns the aggregation identifier.
int	getSize() Returns the number of buckets to be returned in aggregation.
List<IAggregation>	getSubAggregations() Returns an unmodifiable list of the sub-aggregations.

Methods inherited from class java.lang.Object

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

Methods inherited from interface lumis.portal.bigdata.query.IAggregation

getId

Constructor Detail

TermsAggregation

public TermsAggregation(String id,
                        DocumentTypeField field)

Creates a new instance. Uses null as the size.

Parameters:

id - the aggregation identifier.

field - the field that aggregation will be performed on.

Since:

9.0.0

TermsAggregation

public TermsAggregation(String id,
                        DocumentTypeField field,
                        Integer size)

Creates a new instance.

Parameters:

id - the aggregation identifier.

field - the field that aggregation will be performed on.

size - the result size of this aggregation (maximum number of buckets). When not defined, 10 is assumed as default. When set to 0, it is assumed to be unlimited.

Since:

9.0.0

Method Detail

getField

public DocumentTypeField getField()

Description copied from interface: IFieldAwareAggregation

Returns the field this aggregation is bound to.

Specified by:

getField in interface IFieldAwareAggregation

Returns:

the field this aggregation is bound to.

getSize

public int getSize()

Description copied from interface: ISizeAwareAggregation

Returns the number of buckets to be returned in aggregation.

Specified by:

getSize in interface ISizeAwareAggregation

Returns:

the number of buckets to be returned in aggregation.

getId

public String getId()

Description copied from interface: IAggregation

Returns the aggregation identifier.

Specified by:

getId in interface IAggregation

Returns:

the aggregation identifier.

addSubAggregation

public void addSubAggregation(IAggregation aggregation)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregation.

Specified by:

addSubAggregation in interface ISubAggregationAwareAggregation

getSubAggregations

public List<IAggregation> getSubAggregations()

Description copied from interface: ISubAggregationAwareAggregation

Returns an unmodifiable list of the sub-aggregations.

Specified by:

getSubAggregations in interface ISubAggregationAwareAggregation

Returns:

an unmodifiable list of the sub-aggregations.

addSubAggregations

public void addSubAggregations(IAggregation... aggregations)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregations.

Specified by:

addSubAggregations in interface ISubAggregationAwareAggregation

Parameters:

aggregations - the sub-aggregations.

addSubAggregations

public void addSubAggregations(List<IAggregation> aggregations)

Description copied from interface: ISubAggregationAwareAggregation

Adds the given sub-aggregations.

Specified by:

addSubAggregations in interface ISubAggregationAwareAggregation

Parameters:

aggregations - the sub-aggregations.