org.apache.lucene.search
Class TopDocs

java.lang.Object
  extended by org.apache.lucene.search.TopDocs
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
TopFieldDocs

public class TopDocs
extends Object
implements Serializable

Represents hits returned by Searcher.search(Query,Filter,int) and Searcher.search(Query,int).

See Also:
Serialized Form

Field Summary
 ScoreDoc[] scoreDocs
          The top hits for the query.
 int totalHits
          The total number of hits for the query.
 
Constructor Summary
TopDocs(int totalHits, ScoreDoc[] scoreDocs, float maxScore)
           
 
Method Summary
 float getMaxScore()
          Returns the maximum score value encountered.
static TopDocs merge(Sort sort, int topN, TopDocs[] shardHits)
          Returns a new TopDocs, containing topN results across the provided TopDocs, sorting by the specified Sort.
 void setMaxScore(float maxScore)
          Sets the maximum score value encountered.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

totalHits

public int totalHits
The total number of hits for the query.


scoreDocs

public ScoreDoc[] scoreDocs
The top hits for the query.

Constructor Detail

TopDocs

public TopDocs(int totalHits,
               ScoreDoc[] scoreDocs,
               float maxScore)
Method Detail

getMaxScore

public float getMaxScore()
Returns the maximum score value encountered. Note that in case scores are not tracked, this returns Float.NaN.


setMaxScore

public void setMaxScore(float maxScore)
Sets the maximum score value encountered.


merge

public static TopDocs merge(Sort sort,
                            int topN,
                            TopDocs[] shardHits)
                     throws IOException
Returns a new TopDocs, containing topN results across the provided TopDocs, sorting by the specified Sort. Each of the TopDocs must have been sorted by the same Sort, and sort field values must have been filled (ie, fillFields=true must be passed to TopFieldCollector.create(org.apache.lucene.search.Sort, int, boolean, boolean, boolean, boolean).

Pass sort=null to merge sort by score descending.

Throws:
IOException
WARNING: This API is experimental and might change in incompatible ways in the next release.