Module org.apache.lucene.core

Package org.apache.lucene.search

Class Weight.DefaultBulkScorer

java.lang.Object

org.apache.lucene.search.BulkScorer

org.apache.lucene.search.Weight.DefaultBulkScorer

Enclosing class:

Weight

protected static class Weight.DefaultBulkScorer
extends BulkScorer

Just wraps a Scorer and performs top scoring using it.

Field Summary

Fields

Modifier and Type	Field	Description
private final DocIdSetIterator	iterator
private final Scorer	scorer
private final TwoPhaseIterator	twoPhase

Constructor Summary

Constructors

Constructor	Description
DefaultBulkScorer(Scorer scorer)	Sole constructor.

Method Summary

Modifier and Type	Method	Description
long	cost()	Same as DocIdSetIterator.cost() for bulk scorers.
int	score(LeafCollector collector, Bits acceptDocs, int min, int max)	Collects matching documents in a range and return an estimation of the next matching document which is on or after max.
(package private) static void	scoreAll(LeafCollector collector, DocIdSetIterator iterator, TwoPhaseIterator twoPhase, Bits acceptDocs)	Specialized method to bulk-score all hits; we separate this from scoreRange(org.apache.lucene.search.LeafCollector, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.search.TwoPhaseIterator, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.util.Bits, int, int) to help out hotspot.
(package private) static int	scoreRange(LeafCollector collector, DocIdSetIterator iterator, TwoPhaseIterator twoPhase, DocIdSetIterator competitiveIterator, Bits acceptDocs, int min, int max)	Specialized method to bulk-score a range of hits; we separate this from scoreAll(org.apache.lucene.search.LeafCollector, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.search.TwoPhaseIterator, org.apache.lucene.util.Bits) to help out hotspot.

Methods inherited from class org.apache.lucene.search.BulkScorer

score

Methods inherited from class java.lang.Object

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

Field Details

scorer

private final Scorer scorer

iterator

private final DocIdSetIterator iterator

twoPhase

private final TwoPhaseIterator twoPhase

Constructor Details

DefaultBulkScorer

public DefaultBulkScorer(Scorer scorer)

Sole constructor.

Method Details

cost

public long cost()

Description copied from class: BulkScorer

Same as DocIdSetIterator.cost() for bulk scorers.

Specified by:

cost in class BulkScorer

score

public int score(LeafCollector collector,
 Bits acceptDocs,
 int min,
 int max)
          throws IOException

Description copied from class: BulkScorer

Collects matching documents in a range and return an estimation of the next matching document which is on or after max.

The return value must be:

• >= max,
• DocIdSetIterator.NO_MORE_DOCS if there are no more matches,
• <= the first matching document that is >= max otherwise.

min is the minimum document to be considered for matching. All documents strictly before this value must be ignored.

Although max would be a legal return value for this method, higher values might help callers skip more efficiently over non-matching portions of the docID space.

For instance, a Scorer-based implementation could look like below:

 private final Scorer scorer; // set via constructor

 public int score(LeafCollector collector, Bits acceptDocs, int min, int max) throws IOException {
   collector.setScorer(scorer);
   int doc = scorer.docID();
   if (doc < min) {
     doc = scorer.advance(min);
   }
   while (doc < max) {
     if (acceptDocs == null || acceptDocs.get(doc)) {
       collector.collect(doc);
     }
     doc = scorer.nextDoc();
   }
   return doc;
 }
 

Specified by:

score in class BulkScorer

Parameters:

collector - The collector to which all matching documents are passed.

acceptDocs - Bits that represents the allowed documents to match, or null if they are all allowed to match.

min - Score starting at, including, this document

max - Score up to, but not including, this doc

Returns:

an under-estimation of the next matching doc after max

Throws:

IOException

scoreRange

static int scoreRange(LeafCollector collector,
 DocIdSetIterator iterator,
 TwoPhaseIterator twoPhase,
 DocIdSetIterator competitiveIterator,
 Bits acceptDocs,
 int min,
 int max)
               throws IOException

Specialized method to bulk-score a range of hits; we separate this from scoreAll(org.apache.lucene.search.LeafCollector, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.search.TwoPhaseIterator, org.apache.lucene.util.Bits) to help out hotspot. See LUCENE-5487

Throws:

IOException

scoreAll

static void scoreAll(LeafCollector collector,
 DocIdSetIterator iterator,
 TwoPhaseIterator twoPhase,
 Bits acceptDocs)
              throws IOException

Specialized method to bulk-score all hits; we separate this from scoreRange(org.apache.lucene.search.LeafCollector, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.search.TwoPhaseIterator, org.apache.lucene.search.DocIdSetIterator, org.apache.lucene.util.Bits, int, int) to help out hotspot. See LUCENE-5487

Throws:

IOException