FacetsCollector (Lucene 5.2.1 API)

java.lang.Object
- org.apache.lucene.search.SimpleCollector
- - org.apache.lucene.facet.FacetsCollector

All Implemented Interfaces:

Collector, LeafCollector

Direct Known Subclasses:

RandomSamplingFacetsCollector
```
public class FacetsCollector
extends SimpleCollector
implements Collector
```
Collects hits for subsequent faceting. Once you've run a search and collect hits into this, instantiate one of the Facets subclasses to do the facet counting. Use the search utility methods to perform an "ordinary" search but also collect into a Collector.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`FacetsCollector.Docs` Used during collection to record matching docs and then return a `DocIdSet` that contains them.
`static class`	`FacetsCollector.MatchingDocs` Holds the documents that were matched in the `LeafReaderContext`.

Constructor Summary

Constructors
Constructor and Description
`FacetsCollector()` Default constructor
`FacetsCollector(boolean keepScores)` Create this; if `keepScores` is true then a float[] is allocated to hold score of all hits.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`collect(int doc)`
`protected FacetsCollector.Docs`	`createDocs(int maxDoc)` Creates a `FacetsCollector.Docs` to record hits.
`protected void`	`doSetNextReader(LeafReaderContext context)`
`boolean`	`getKeepScores()` True if scores were saved.
`List<FacetsCollector.MatchingDocs>`	`getMatchingDocs()` Returns the documents matched by the query, one `FacetsCollector.MatchingDocs` per visited segment.
`boolean`	`needsScores()`
`static TopDocs`	`search(IndexSearcher searcher, Query q, Filter filter, int n, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopFieldDocs`	`search(IndexSearcher searcher, Query q, Filter filter, int n, Sort sort, boolean doDocScores, boolean doMaxScore, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopFieldDocs`	`search(IndexSearcher searcher, Query q, Filter filter, int n, Sort sort, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopDocs`	`search(IndexSearcher searcher, Query q, int n, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopDocs`	`searchAfter(IndexSearcher searcher, ScoreDoc after, Query q, Filter filter, int n, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopDocs`	`searchAfter(IndexSearcher searcher, ScoreDoc after, Query q, Filter filter, int n, Sort sort, boolean doDocScores, boolean doMaxScore, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`static TopDocs`	`searchAfter(IndexSearcher searcher, ScoreDoc after, Query q, Filter filter, int n, Sort sort, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`TopDocs`	`searchAfter(IndexSearcher searcher, ScoreDoc after, Query q, int n, Collector fc)` Utility method, to search and also collect all hits into the provided `Collector`.
`void`	`setScorer(Scorer scorer)`

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

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
getLeafCollector

Constructor Detail
- FacetsCollector
```
public FacetsCollector()
```
  Default constructor
- FacetsCollector
```
public FacetsCollector(boolean keepScores)
```
  Create this; if keepScores is true then a float[] is allocated to hold score of all hits.

Method Detail

createDocs
```
protected FacetsCollector.Docs createDocs(int maxDoc)
```
Creates a FacetsCollector.Docs to record hits. The default uses FixedBitSet to record hits and you can override to e.g. record the docs in your own DocIdSet.

getKeepScores
```
public final boolean getKeepScores()
```
True if scores were saved.

getMatchingDocs
```
public List<FacetsCollector.MatchingDocs> getMatchingDocs()
```
Returns the documents matched by the query, one FacetsCollector.MatchingDocs per visited segment.

collect
```
public final void collect(int doc)
                   throws IOException
```
Specified by:

collect in interface LeafCollector

Specified by:

collect in class SimpleCollector

Throws:

IOException

needsScores
```
public boolean needsScores()
```
Specified by:

needsScores in interface Collector

setScorer
```
public final void setScorer(Scorer scorer)
                     throws IOException
```
Specified by:

setScorer in interface LeafCollector

Overrides:

setScorer in class SimpleCollector

Throws:

IOException

doSetNextReader

protected void doSetNextReader(LeafReaderContext context)
                        throws IOException

Overrides:: doSetNextReader in class SimpleCollector
Throws:: IOException