org.apache.lucene.queries

Class TermsQuery

  • All Implemented Interfaces:
    Accountable


    public class TermsQuery
    extends Query
    implements Accountable
    Specialization for a disjunction over many terms that behaves like a ConstantScoreQuery over a BooleanQuery containing only BooleanClause.Occur.SHOULD clauses.

    For instance in the following example, both @{code q1} and q2 would yield the same scores:

     Query q1 = new TermsQuery(new Term("field", "foo"), new Term("field", "bar"));
    
     BooleanQuery bq = new BooleanQuery();
     bq.add(new TermQuery(new Term("field", "foo")), Occur.SHOULD);
     bq.add(new TermQuery(new Term("field", "bar")), Occur.SHOULD);
     Query q2 = new ConstantScoreQuery(bq);
     

    When there are few terms, this query executes like a regular disjunction. However, when there are many terms, instead of merging iterators on the fly, it will populate a bit set with matching docs and return a Scorer over this bit set.

    NOTE: This query produces scores that are equal to its boost