Apache
/
lucene
mirror of https://github.com/apache/lucene.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

LUCENE-6553: Fixes to Weight's javadoc. 

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1687586 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Adrien Grand 2015-06-25 17:21:08 +00:00
parent b91dff5b5f
commit 4a85c3dd03
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
lucene/core/src/java/org/apache/lucene/search/Weight.java
View File

@ -21,6 +21,7 @@ import java.io.IOException;
import java.util.Set; import java.util.Set;
import org.apache.lucene.index.IndexReaderContext; import org.apache.lucene.index.IndexReaderContext;
import org.apache.lucene.index.LeafReader;
import org.apache.lucene.index.LeafReaderContext; import org.apache.lucene.index.LeafReaderContext;
import org.apache.lucene.index.Term; import org.apache.lucene.index.Term;
import org.apache.lucene.search.similarities.Similarity; import org.apache.lucene.search.similarities.Similarity;
@ -97,11 +98,14 @@ public abstract class Weight {
public abstract void normalize(float norm, float topLevelBoost); public abstract void normalize(float norm, float topLevelBoost);
/** /**
* Returns a {@link Scorer} which scores documents in/out-of order according * Returns a {@link Scorer} which can iterate in order over all matching
* to <code>scoreDocsInOrder</code>. * documents and assign them a score.
* <p> * <p>
* <b>NOTE:</b> null can be returned if no documents will be scored by this * <b>NOTE:</b> null can be returned if no documents will be scored by this
* query. * query.
* <p>
* <b>NOTE</b>: The returned {@link Scorer} does not have
* {@link LeafReader#getLiveDocs()} applied, they need to be checked on top.
* *
* @param context * @param context
* the {@link org.apache.lucene.index.LeafReaderContext} for which to return the {@link Scorer}. * the {@link org.apache.lucene.index.LeafReaderContext} for which to return the {@link Scorer}.
@ -117,7 +121,7 @@ public abstract class Weight {
* Only queries that have a different top-level approach * Only queries that have a different top-level approach
* need to override this; the default implementation * need to override this; the default implementation
* pulls a normal {@link Scorer} and iterates and * pulls a normal {@link Scorer} and iterates and
* collects the resulting hits. * collects the resulting hits which are not marked as deleted.
* *
* @param context * @param context
* the {@link org.apache.lucene.index.LeafReaderContext} for which to return the {@link Scorer}. * the {@link org.apache.lucene.index.LeafReaderContext} for which to return the {@link Scorer}.