org.apache.lucene.search.suggest.document

Class RegexCompletionQuery

java.lang.Object

org.apache.lucene.search.Query

org.apache.lucene.search.suggest.document.CompletionQuery

org.apache.lucene.search.suggest.document.RegexCompletionQuery

public class RegexCompletionQuery
extends CompletionQuery

A CompletionQuery which takes a regular expression as the prefix of the query term.

Example usage of querying a prefix of 'sug' and 'sub' as a regular expression against a suggest field 'suggest_field':

  CompletionQuery query = new RegexCompletionQuery(new Term("suggest_field", "su[g|b]"));
 

See RegExp for the supported regular expression syntax

Constructor Summary

Constructors

Constructor and Description
RegexCompletionQuery(Term term) Calls RegexCompletionQuery(Term, BitsProducer) with no filter
RegexCompletionQuery(Term term, BitsProducer filter) Calls RegexCompletionQuery(Term, int, int, BitsProducer) enabling all optional regex syntax and maxDeterminizedStates of
RegexCompletionQuery(Term term, int flags, int maxDeterminizedStates) Calls RegexCompletionQuery(Term, int, int, BitsProducer) with no filter
RegexCompletionQuery(Term term, int flags, int maxDeterminizedStates, BitsProducer filter) Constructs a regular expression completion query

Method Summary

Modifier and Type	Method and Description
Weight	createWeight(IndexSearcher searcher, boolean needsScores, float boost) Expert: Constructs an appropriate Weight implementation for this query.
boolean	equals(java.lang.Object o) Override and implement query instance equivalence properly in a subclass.
int	getFlags() Get the regex flags
int	getMaxDeterminizedStates() Get the maximum number of states permitted in the determinized automaton
int	hashCode() Override and implement query hash code properly in a subclass.

Methods inherited from class org.apache.lucene.search.suggest.document.CompletionQuery

getField, getFilter, getTerm, rewrite, toString

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

classHash, sameClassAs, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RegexCompletionQuery

public RegexCompletionQuery(Term term)

Calls RegexCompletionQuery(Term, BitsProducer) with no filter

RegexCompletionQuery

public RegexCompletionQuery(Term term,
                            BitsProducer filter)

Calls RegexCompletionQuery(Term, int, int, BitsProducer) enabling all optional regex syntax and maxDeterminizedStates of

RegexCompletionQuery

public RegexCompletionQuery(Term term,
                            int flags,
                            int maxDeterminizedStates)

Calls RegexCompletionQuery(Term, int, int, BitsProducer) with no filter

RegexCompletionQuery

public RegexCompletionQuery(Term term,
                            int flags,
                            int maxDeterminizedStates,
                            BitsProducer filter)

Constructs a regular expression completion query

Parameters:

term - query is run against Term.field() and Term.text() is interpreted as a regular expression

flags - used as syntax_flag in RegExp(String, int)

maxDeterminizedStates - used in RegExp.toAutomaton(int)

filter - used to query on a sub set of documents

Method Detail

createWeight

public Weight createWeight(IndexSearcher searcher,
                           boolean needsScores,
                           float boost)
                    throws java.io.IOException

Description copied from class: Query

Expert: Constructs an appropriate Weight implementation for this query.

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

Overrides:

createWeight in class Query

needsScores - True if document scores (Scorer.score()) are needed.

boost - The boost that is propagated by the parent queries.

Throws:

java.io.IOException

getFlags

public int getFlags()

Get the regex flags

getMaxDeterminizedStates

public int getMaxDeterminizedStates()

Get the maximum number of states permitted in the determinized automaton

equals

public boolean equals(java.lang.Object o)

Description copied from class: Query

Override and implement query instance equivalence properly in a subclass. This is required so that QueryCache works properly. Typically a query will be equal to another only if it's an instance of the same class and its document-filtering properties are identical that other instance. Utility methods are provided for certain repetitive code.

Specified by:

equals in class Query

See Also:

Query.sameClassAs(Object), Query.classHash()

hashCode

public int hashCode()

Description copied from class: Query

Override and implement query hash code properly in a subclass. This is required so that QueryCache works properly.

Specified by:

hashCode in class Query

See Also:

Query.equals(Object)