public abstract class Scorer extends Object
Scorer
either iterates over documents matching a query,
or provides an explanation of the score for a query for a given document.
Similarity
implementation.Modifier | Constructor and Description |
---|---|
protected |
Scorer(Similarity similarity)
Constructs a Scorer.
|
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 next document matching the query.
|
abstract float |
score()
Returns the score of the current document matching the query.
|
void |
score(HitCollector hc)
Scores and collects all matching documents.
|
protected boolean |
score(HitCollector hc,
int max)
Expert: Collects matching documents in a range.
|
abstract boolean |
skipTo(int target)
Skips to the first match beyond the current whose document number is
greater than or equal to a given target.
|
protected Scorer(Similarity similarity)
similarity
- The Similarity
implementation used by this scorer.public Similarity getSimilarity()
public void score(HitCollector hc) throws IOException
hc
- The collector to which all matching documents are passed through
HitCollector.collect(int, float)
.
explain(int)
method should not be used.IOException
protected boolean score(HitCollector hc, int max) throws IOException
next()
must be called once before this method is called
for the first time.hc
- The collector to which all matching documents are passed through
HitCollector.collect(int, float)
.max
- Do not score documents past this.IOException
public abstract boolean next() throws IOException
explain(int)
method should not be used.IOException
public abstract int doc()
next()
is called the first time.public abstract float score() throws IOException
next()
or skipTo(int)
is called the first time.IOException
public abstract boolean skipTo(int target) throws IOException
explain(int)
method should not be used.target
- The target document number.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.
IOException
public abstract Explanation explain(int doc) throws IOException
next()
, skipTo(int)
and
score(HitCollector)
methods should not be used.doc
- The document number for the explanation.IOException
Copyright © 2000-2013 Apache Software Foundation. All Rights Reserved.