public class CommonTermsQuery extends Query
added
terms: low-frequency
terms are added to a required boolean clause and high-frequency terms are
added to an optional boolean clause. The optional clause is only executed if
the required "low-frequency" clause matches. Scores produced by this query
will be slightly different than plain BooleanQuery
scorer mainly due to
differences in the number of leaf queries
in the required boolean clause. In most cases, high-frequency terms are
unlikely to significantly contribute to the document score unless at least
one of the low-frequency terms are matched. This query can improve
query execution times significantly if applicable.
CommonTermsQuery
has several advantages over stopword filtering at
index or query time since a term can be "classified" based on the actual
document frequency in the index and can prevent slow queries even across
domains without specialized stopword files.
Note: if the query only contains high-frequency terms the query is rewritten into a plain conjunction query ie. all high-frequency terms need to match in order to match a document.
Constructor and Description |
---|
CommonTermsQuery(BooleanClause.Occur highFreqOccur,
BooleanClause.Occur lowFreqOccur,
float maxTermFrequency)
Creates a new
CommonTermsQuery |
CommonTermsQuery(BooleanClause.Occur highFreqOccur,
BooleanClause.Occur lowFreqOccur,
float maxTermFrequency,
boolean disableCoord)
Creates a new
CommonTermsQuery |
Modifier and Type | Method and Description |
---|---|
void |
add(Term term)
Adds a term to the
CommonTermsQuery |
void |
collectTermContext(IndexReader reader,
List<AtomicReaderContext> leaves,
TermContext[] contextArray,
Term[] queryTerms) |
boolean |
equals(Object obj) |
void |
extractTerms(Set<Term> terms)
Expert: adds all terms occurring in this query to the terms set.
|
float |
getHighFreqMinimumNumberShouldMatch()
Gets the minimum number of the optional high frequent BooleanClauses which must be
satisfied.
|
float |
getLowFreqMinimumNumberShouldMatch()
Gets the minimum number of the optional low frequent BooleanClauses which must be
satisfied.
|
int |
hashCode() |
boolean |
isCoordDisabled()
Returns true iff
Similarity.coord(int,int) is disabled in scoring
for the high and low frequency query instance. |
Query |
rewrite(IndexReader reader)
Expert: called to re-write queries into primitive queries.
|
void |
setHighFreqMinimumNumberShouldMatch(float min)
Specifies a minimum number of the high frequent optional BooleanClauses which must be
satisfied in order to produce a match on the low frequency terms query
part.
|
void |
setLowFreqMinimumNumberShouldMatch(float min)
Specifies a minimum number of the low frequent optional BooleanClauses which must be
satisfied in order to produce a match on the low frequency terms query
part.
|
String |
toString(String field)
Prints a query to a string, with
field assumed to be the
default field and omitted. |
public CommonTermsQuery(BooleanClause.Occur highFreqOccur, BooleanClause.Occur lowFreqOccur, float maxTermFrequency)
CommonTermsQuery
highFreqOccur
- BooleanClause.Occur
used for high frequency termslowFreqOccur
- BooleanClause.Occur
used for low frequency termsmaxTermFrequency
- a value in [0..1) (or absolute number >=1) representing the
maximum threshold of a terms document frequency to be considered a
low frequency term.IllegalArgumentException
- if BooleanClause.Occur.MUST_NOT
is pass as lowFreqOccur or
highFreqOccurpublic CommonTermsQuery(BooleanClause.Occur highFreqOccur, BooleanClause.Occur lowFreqOccur, float maxTermFrequency, boolean disableCoord)
CommonTermsQuery
highFreqOccur
- BooleanClause.Occur
used for high frequency termslowFreqOccur
- BooleanClause.Occur
used for low frequency termsmaxTermFrequency
- a value in [0..1) (or absolute number >=1) representing the
maximum threshold of a terms document frequency to be considered a
low frequency term.disableCoord
- disables Similarity.coord(int,int)
in scoring for the low
/ high frequency sub-queriesIllegalArgumentException
- if BooleanClause.Occur.MUST_NOT
is pass as lowFreqOccur or
highFreqOccurpublic void add(Term term)
CommonTermsQuery
term
- the term to addpublic Query rewrite(IndexReader reader) throws IOException
Query
rewrite
in class Query
IOException
public void collectTermContext(IndexReader reader, List<AtomicReaderContext> leaves, TermContext[] contextArray, Term[] queryTerms) throws IOException
IOException
public boolean isCoordDisabled()
Similarity.coord(int,int)
is disabled in scoring
for the high and low frequency query instance. The top level query will
always disable coords.public void setLowFreqMinimumNumberShouldMatch(float min)
By default no optional clauses are necessary for a match (unless there are no required clauses). If this method is used, then the specified number of clauses is required.
min
- the number of optional clauses that must matchpublic float getLowFreqMinimumNumberShouldMatch()
public void setHighFreqMinimumNumberShouldMatch(float min)
By default no optional clauses are necessary for a match (unless there are no required clauses). If this method is used, then the specified number of clauses is required.
min
- the number of optional clauses that must matchpublic float getHighFreqMinimumNumberShouldMatch()
public void extractTerms(Set<Term> terms)
Query
rewritten
form.extractTerms
in class Query
public String toString(String field)
Query
field
assumed to be the
default field and omitted.Copyright © 2010 - 2020 Adobe. All Rights Reserved