|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.lucene.search.Collector org.apache.lucene.search.grouping.AbstractFirstPassGroupingCollector<GROUP_VALUE_TYPE>
public abstract class AbstractFirstPassGroupingCollector<GROUP_VALUE_TYPE>
FirstPassGroupingCollector is the first of two passes necessary to collect grouped hits. This pass gathers the top N sorted groups. Concrete subclasses define what a group is and how it is internally collected.
See org.apache.lucene.search.grouping
for more
details including a full code example.
Field Summary | |
---|---|
protected TreeSet<CollectedSearchGroup<GROUP_VALUE_TYPE>> |
orderedGroups
|
Constructor Summary | |
---|---|
AbstractFirstPassGroupingCollector(Sort groupSort,
int topNGroups)
Create the first pass collector. |
Method Summary | |
---|---|
boolean |
acceptsDocsOutOfOrder()
|
void |
collect(int doc)
|
protected abstract GROUP_VALUE_TYPE |
copyDocGroupValue(GROUP_VALUE_TYPE groupValue,
GROUP_VALUE_TYPE reuse)
Returns a copy of the specified group value by creating a new instance and copying the value from the specified groupValue in the new instance. |
protected abstract GROUP_VALUE_TYPE |
getDocGroupValue(int doc)
Returns the group value for the specified doc. |
Collection<SearchGroup<GROUP_VALUE_TYPE>> |
getTopGroups(int groupOffset,
boolean fillFields)
Returns top groups, starting from offset. |
void |
setNextReader(AtomicReaderContext readerContext)
|
void |
setScorer(Scorer scorer)
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected TreeSet<CollectedSearchGroup<GROUP_VALUE_TYPE>> orderedGroups
Constructor Detail |
---|
public AbstractFirstPassGroupingCollector(Sort groupSort, int topNGroups) throws IOException
groupSort
- The Sort
used to sort the
groups. The top sorted document within each group
according to groupSort, determines how that group
sorts against other groups. This must be non-null,
ie, if you want to groupSort by relevance use
Sort.RELEVANCE.topNGroups
- How many top groups to keep.
IOException
- If I/O related errors occurMethod Detail |
---|
public Collection<SearchGroup<GROUP_VALUE_TYPE>> getTopGroups(int groupOffset, boolean fillFields)
groupOffset
- The offset in the collected groupsfillFields
- Whether to fill to SearchGroup.sortValues
public void setScorer(Scorer scorer) throws IOException
setScorer
in class Collector
IOException
public void collect(int doc) throws IOException
collect
in class Collector
IOException
public boolean acceptsDocsOutOfOrder()
acceptsDocsOutOfOrder
in class Collector
public void setNextReader(AtomicReaderContext readerContext) throws IOException
setNextReader
in class Collector
IOException
protected abstract GROUP_VALUE_TYPE getDocGroupValue(int doc)
doc
- The specified doc
protected abstract GROUP_VALUE_TYPE copyDocGroupValue(GROUP_VALUE_TYPE groupValue, GROUP_VALUE_TYPE reuse)
groupValue
- The group value to copyreuse
- Optionally a reuse instance to prevent a new instance creation
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |