org.apache.lucene.search

Class Scorer

java.lang.Object

org.apache.lucene.search.Scorer

Direct Known Subclasses:

ReqExclScorer, ReqOptSumScorer, SpanScorer

public abstract class Scorer
extends java.lang.Object

Expert: Common scoring functionality for different types of queries.

A Scorer either iterates over documents matching a query in increasing order of doc Id, or provides an explanation of the score for a query for a given document.

Document scores are computed using a given Similarity implementation.

See Also:

BooleanQuery.setAllowDocsOutOfOrder(boolean)

Method Summary

Modifier and Type	Method and Description
abstract int	doc() Returns the current document number matching the query.
abstract Explanation	explain(int doc) Returns an explanation of the score for a document.
Similarity	getSimilarity() Returns the Similarity implementation used by this scorer.
abstract boolean	next() Advances to the document matching this Scorer with the lowest doc Id greater than the current value of doc() (or to the matching document with the lowest doc Id if next has never been called on this Scorer).
abstract float	score() Returns the score of the current document matching the query.
void	score(HitCollector hc) Scores and collects all matching documents.
abstract boolean	skipTo(int target) Skips to the document matching this Scorer with the lowest doc Id greater than or equal to a given target.

Methods inherited from class java.lang.Object

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

Method Detail

getSimilarity

public Similarity getSimilarity()

Returns the Similarity implementation used by this scorer.

score

public void score(HitCollector hc)
           throws java.io.IOException

Scores and collects all matching documents.

Parameters:

hc - The collector to which all matching documents are passed through HitCollector.collect(int, float).
When this method is used the explain(int) method should not be used.

Throws:

java.io.IOException

next

public abstract boolean next()
                      throws java.io.IOException

Advances to the document matching this Scorer with the lowest doc Id greater than the current value of doc() (or to the matching document with the lowest doc Id if next has never been called on this Scorer).

When this method is used the explain(int) method should not be used.

Returns:

true iff there is another document matching the query.

Throws:

java.io.IOException

See Also:

BooleanQuery.setAllowDocsOutOfOrder(boolean)

doc

public abstract int doc()

Returns the current document number matching the query. Initially invalid, until next() is called the first time.

score

public abstract float score()
                     throws java.io.IOException

Returns the score of the current document matching the query. Initially invalid, until next() or skipTo(int) is called the first time.

Throws:

java.io.IOException

skipTo

public abstract boolean skipTo(int target)
                        throws java.io.IOException

Skips to the document matching this Scorer with the lowest doc Id greater than or equal to a given target.

The behavior of this method is undefined if the target specified is less than or equal to the current value of doc().

Behaves as if written:

   boolean skipTo(int target) {
     do {
       if (!next())
             return false;
     } while (target > doc());
     return true;
   }
 

Most implementations are considerably more efficient than that.

When this method is used the explain(int) method should not be used.

Parameters:

target - The target document number.

Returns:

true iff there is such a match.

Throws:

java.io.IOException

See Also:

BooleanQuery.setAllowDocsOutOfOrder(boolean)

explain

public abstract Explanation explain(int doc)
                             throws java.io.IOException

Returns an explanation of the score for a document.
When this method is used, the next(), skipTo(int) and score(HitCollector) methods should not be used.

Parameters:

doc - The document number for the explanation.

Throws:

java.io.IOException