TopDocsCollector
A base class for all collectors that return a TopDocs output. This collector allows easy extension by providing a single constructor which accepts a PriorityQueue as well as protected members for that priority queue and a counter of the number of total hits.
Extending classes can override any of the methods to provide their own implementation, as well as avoid the use of the priority queue entirely by passing null to .TopDocsCollector. In that case however, you might want to consider overriding all methods, in order to avoid a NullPointerException.
Inheritors
Properties
Set the Weight that will be used to produce scorers that will feed [ ]s. This is typically useful to have access to Weight.count from .
Functions
Create a new collector to collect the given context.
Returns the top docs that were collected by this collector.
Returns the documents in the range [start .. pq.size()) that were collected by this collector. Note that if start >= pq.size(), an empty TopDocs is returned.
This method is convenient to call if the application always asks for the last results, starting from the last 'page'.
NOTE: you cannot call this method more than once for each search execution. If you need to call it more than once, passing each time a different start, you should call .topDocs and work with the returned TopDocs object, which will contain all the results this search execution collected.
Returns the documents in the range [start .. start+howMany) that were collected by this collector. Note that if start >= pq.size(), an empty TopDocs is returned, and if pq.size() - start < howMany, then only the available documents in [start .. pq.size()) are returned.
This method is useful to call in case pagination of search results is allowed by the search application, as well as it attempts to optimize the memory used by allocating only as much as requested by howMany.
NOTE: you cannot call this method more than once for each search execution. If you need to call it more than once, passing each time a different range, you should call .topDocs and work with the returned TopDocs object, which will contain all the results this search execution collected.