Package org.apache.lucene.search

Class Query

java.lang.Object

org.apache.lucene.search.Query

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

BooleanQuery, ConstantScoreQuery, DisjunctionMaxQuery, FilteredQuery, MatchAllDocsQuery, MultiPhraseQuery, MultiTermQuery, PhraseQuery, SpanQuery, TermQuery

public abstract class Query
extends java.lang.Object
implements java.lang.Cloneable

The abstract base class for queries.

Instantiable subclasses are:

• TermQuery
• BooleanQuery
• WildcardQuery
• PhraseQuery
• PrefixQuery
• MultiPhraseQuery
• FuzzyQuery
• RegexpQuery
• TermRangeQuery
• NumericRangeQuery
• ConstantScoreQuery
• DisjunctionMaxQuery
• MatchAllDocsQuery

See also the family of Span Queries and additional queries available in the Queries module

Constructor Summary

Constructors

Constructor	Description
Query()

Method Summary

Modifier and Type	Method	Description
Query	clone()	Returns a clone of this query.
Weight	createWeight(IndexSearcher searcher)	Expert: Constructs an appropriate Weight implementation for this query.
boolean	equals(java.lang.Object obj)
void	extractTerms(java.util.Set<Term> terms)	Expert: adds all terms occurring in this query to the terms set.
float	getBoost()	Gets the boost for this clause.
int	hashCode()
Query	rewrite(IndexReader reader)	Expert: called to re-write queries into primitive queries.
void	setBoost(float b)	Sets the boost for this query clause to b.
java.lang.String	toString()	Prints a query to a string.
abstract java.lang.String	toString(java.lang.String field)	Prints a query to a string, with field assumed to be the default field and omitted.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Query

public Query()

Method Detail

setBoost

public void setBoost(float b)

Sets the boost for this query clause to b. Documents matching this clause will (in addition to the normal weightings) have their score multiplied by b.

getBoost

public float getBoost()

Gets the boost for this clause. Documents matching this clause will (in addition to the normal weightings) have their score multiplied by b. The boost is 1.0 by default.

toString

public abstract java.lang.String toString(java.lang.String field)

Prints a query to a string, with field assumed to be the default field and omitted.

toString

public java.lang.String toString()

Prints a query to a string.

Overrides:

toString in class java.lang.Object

createWeight

public Weight createWeight(IndexSearcher searcher)
                    throws java.io.IOException

Expert: Constructs an appropriate Weight implementation for this query.

Only implemented by primitive queries, which re-write to themselves.

Throws:

java.io.IOException

rewrite

public Query rewrite(IndexReader reader)
              throws java.io.IOException

Expert: called to re-write queries into primitive queries. For example, a PrefixQuery will be rewritten into a BooleanQuery that consists of TermQuerys.

Throws:

java.io.IOException

extractTerms

public void extractTerms(java.util.Set<Term> terms)

Expert: adds all terms occurring in this query to the terms set. Only works if this query is in its rewritten form.

Throws:

java.lang.UnsupportedOperationException - if this query is not yet rewritten

clone

public Query clone()

Returns a clone of this query.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object