org.apache.lucene.search.grouping.term

Class TermAllGroupHeadsCollector<GH extends AbstractAllGroupHeadsCollector.GroupHead<?>>

java.lang.Object

org.apache.lucene.search.SimpleCollector

org.apache.lucene.search.grouping.AbstractAllGroupHeadsCollector<GH>

org.apache.lucene.search.grouping.term.TermAllGroupHeadsCollector<GH>

All Implemented Interfaces:

Collector, LeafCollector

Direct Known Subclasses:

TermAllGroupHeadsCollector.GeneralAllGroupHeadsCollector, TermAllGroupHeadsCollector.OrdAllGroupHeadsCollector, TermAllGroupHeadsCollector.OrdScoreAllGroupHeadsCollector, TermAllGroupHeadsCollector.ScoreAllGroupHeadsCollector

public abstract class TermAllGroupHeadsCollector<GH extends AbstractAllGroupHeadsCollector.GroupHead<?>>
extends AbstractAllGroupHeadsCollector<GH>

A base implementation of AbstractAllGroupHeadsCollector for retrieving the most relevant groups when grouping on a string based group field. More specifically this all concrete implementations of this base implementation use SortedDocValues.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	TermAllGroupHeadsCollector.GeneralAllGroupHeadsCollector
(package private) static class	TermAllGroupHeadsCollector.OrdAllGroupHeadsCollector
(package private) static class	TermAllGroupHeadsCollector.OrdScoreAllGroupHeadsCollector
(package private) static class	TermAllGroupHeadsCollector.ScoreAllGroupHeadsCollector

Nested classes/interfaces inherited from class org.apache.lucene.search.grouping.AbstractAllGroupHeadsCollector

AbstractAllGroupHeadsCollector.GroupHead<GROUP_VALUE_TYPE>, AbstractAllGroupHeadsCollector.TemporalResult

Field Summary

Fields

Modifier and Type	Field and Description
private static int	DEFAULT_INITIAL_SIZE
(package private) java.lang.String	groupField
(package private) SortedDocValues	groupIndex
(package private) LeafReaderContext	readerContext

Fields inherited from class org.apache.lucene.search.grouping.AbstractAllGroupHeadsCollector

compIDXEnd, reversed, temporalResult

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TermAllGroupHeadsCollector(java.lang.String groupField, int numberOfSorts)

Method Summary

Modifier and Type	Method and Description
static AbstractAllGroupHeadsCollector<?>	create(java.lang.String groupField, Sort sortWithinGroup) Creates an AbstractAllGroupHeadsCollector instance based on the supplied arguments.
static AbstractAllGroupHeadsCollector<?>	create(java.lang.String groupField, Sort sortWithinGroup, int initialSize) Creates an AbstractAllGroupHeadsCollector instance based on the supplied arguments.
private static boolean	needGeneralImpl(SortField sortField)

Methods inherited from class org.apache.lucene.search.grouping.AbstractAllGroupHeadsCollector

collect, getCollectedGroupHeads, groupHeadsSize, retrieveGroupHeadAndAddIfNotExist, retrieveGroupHeads, retrieveGroupHeads

Methods inherited from class org.apache.lucene.search.SimpleCollector

doSetNextReader, getLeafCollector, setScorer

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.lucene.search.Collector

needsScores

Field Detail

DEFAULT_INITIAL_SIZE

private static final int DEFAULT_INITIAL_SIZE

See Also:

Constant Field Values

groupField

final java.lang.String groupField

groupIndex

SortedDocValues groupIndex

readerContext

LeafReaderContext readerContext

Constructor Detail

TermAllGroupHeadsCollector

protected TermAllGroupHeadsCollector(java.lang.String groupField,
                                     int numberOfSorts)

Method Detail

create

public static AbstractAllGroupHeadsCollector<?> create(java.lang.String groupField,
                                                       Sort sortWithinGroup)

Creates an AbstractAllGroupHeadsCollector instance based on the supplied arguments. This factory method decides with implementation is best suited. Delegates to create(String, org.apache.lucene.search.Sort, int) with an initialSize of 128.

Parameters:

groupField - The field to group by

sortWithinGroup - The sort within each group

Returns:

an AbstractAllGroupHeadsCollector instance based on the supplied arguments

create

public static AbstractAllGroupHeadsCollector<?> create(java.lang.String groupField,
                                                       Sort sortWithinGroup,
                                                       int initialSize)

Creates an AbstractAllGroupHeadsCollector instance based on the supplied arguments. This factory method decides with implementation is best suited.

Parameters:

groupField - The field to group by

sortWithinGroup - The sort within each group

initialSize - The initial allocation size of the internal int set and group list which should roughly match the total number of expected unique groups. Be aware that the heap usage is 4 bytes * initialSize.

Returns:

an AbstractAllGroupHeadsCollector instance based on the supplied arguments

needGeneralImpl

private static boolean needGeneralImpl(SortField sortField)