org.apache.lucene.search.suggest.document

Class CompletionQuery

java.lang.Object

org.apache.lucene.search.Query

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

Direct Known Subclasses:

ContextQuery, PrefixCompletionQuery, RegexCompletionQuery

public abstract class CompletionQuery
extends Query

Abstract Query that match documents containing terms with a specified prefix filtered by BitsProducer. This should be used to query against any SuggestFields or ContextSuggestFields of documents.

Use SuggestIndexSearcher.suggest(CompletionQuery, int, boolean) to execute any query that provides a concrete implementation of this query. Example below shows using this query to retrieve the top 5 documents.

  SuggestIndexSearcher searcher = new SuggestIndexSearcher(reader);
  TopSuggestDocs suggestDocs = searcher.suggest(query, 5);
 

This query rewrites to an appropriate CompletionQuery depending on the type (SuggestField or ContextSuggestField) of the field the query is run against.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CompletionQuery(Term term, BitsProducer filter) Creates a base Completion query against a term with a filter to scope the documents

Method Summary

Modifier and Type	Method and Description
java.lang.String	getField() Returns the field name this query should be run against
BitsProducer	getFilter() Returns a BitsProducer.
Term	getTerm() Returns the term to be queried against
Query	rewrite(IndexReader reader) Expert: called to re-write queries into primitive queries.
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 org.apache.lucene.search.Query

classHash, createWeight, equals, hashCode, sameClassAs, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

CompletionQuery

protected CompletionQuery(Term term,
                          BitsProducer filter)

Creates a base Completion query against a term with a filter to scope the documents

Method Detail

getFilter

public BitsProducer getFilter()

Returns a BitsProducer. Only suggestions matching the returned bits will be returned.

getField

public java.lang.String getField()

Returns the field name this query should be run against

getTerm

public Term getTerm()

Returns the term to be queried against

rewrite

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

Description copied from class: Query

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

Overrides:

rewrite in class Query

Throws:

java.io.IOException

toString

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

Description copied from class: Query

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

Specified by:

toString in class Query