org.apache.lucene.search.suggest

Class DocumentDictionary.DocumentInputIterator

java.lang.Object

org.apache.lucene.search.suggest.DocumentDictionary.DocumentInputIterator

All Implemented Interfaces:

InputIterator, BytesRefIterator

Enclosing class:

DocumentDictionary

protected class DocumentDictionary.DocumentInputIterator
extends Object
implements InputIterator

Implements InputIterator from stored fields.

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.lucene.search.suggest.InputIterator

InputIterator.InputIteratorWrapper

Field Summary

Fields inherited from interface org.apache.lucene.search.suggest.InputIterator

EMPTY

Constructor Summary

Constructors

Constructor and Description
DocumentDictionary.DocumentInputIterator(boolean hasPayloads, boolean hasContexts) Creates an iterator over term, weight and payload fields from the lucene index.

Method Summary

Methods

Modifier and Type	Method and Description
Set<BytesRef>	contexts() A term's contexts context can be used to filter suggestions.
Comparator<BytesRef>	getComparator() Return the BytesRef Comparator used to sort terms provided by the iterator.
protected long	getWeight(Document doc, int docId) Returns the value of the weightField for the current document.
boolean	hasContexts() Returns true if the iterator has contexts
boolean	hasPayloads() Returns true if the iterator has payloads
BytesRef	next() Increments the iteration to the next BytesRef in the iterator.
BytesRef	payload() An arbitrary byte[] to record per suggestion.
long	weight() A term's weight, higher numbers mean better suggestions.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DocumentDictionary.DocumentInputIterator

public DocumentDictionary.DocumentInputIterator(boolean hasPayloads,
                                        boolean hasContexts)
                                         throws IOException

Creates an iterator over term, weight and payload fields from the lucene index. setting withPayload to false, implies an iterator over only term and weight.

Throws:

IOException

Method Detail

weight

public long weight()

Description copied from interface: InputIterator

A term's weight, higher numbers mean better suggestions.

Specified by:

weight in interface InputIterator

getComparator

public Comparator<BytesRef> getComparator()

Description copied from interface: BytesRefIterator

Return the BytesRef Comparator used to sort terms provided by the iterator. This may return null if there are no items or the iterator is not sorted. Callers may invoke this method many times, so it's best to cache a single instance & reuse it.

Specified by:

getComparator in interface BytesRefIterator

next

public BytesRef next()
              throws IOException

Description copied from interface: BytesRefIterator

Increments the iteration to the next BytesRef in the iterator. Returns the resulting BytesRef or null if the end of the iterator is reached. The returned BytesRef may be re-used across calls to next. After this method returns null, do not call it again: the results are undefined.

Specified by:

next in interface BytesRefIterator

Returns:

the next BytesRef in the iterator or null if the end of the iterator is reached.

Throws:

IOException - If there is a low-level I/O error.

payload

public BytesRef payload()

Description copied from interface: InputIterator

An arbitrary byte[] to record per suggestion. See Lookup.LookupResult.payload to retrieve the payload for each suggestion.

Specified by:

payload in interface InputIterator

hasPayloads

public boolean hasPayloads()

Description copied from interface: InputIterator

Returns true if the iterator has payloads

Specified by:

hasPayloads in interface InputIterator

getWeight

protected long getWeight(Document doc,
             int docId)

Returns the value of the weightField for the current document. Retrieves the value for the weightField if its stored (using doc) or if its indexed as NumericDocValues (using docId) for the document. If no value is found, then the weight is 0.

contexts

public Set<BytesRef> contexts()

Description copied from interface: InputIterator

A term's contexts context can be used to filter suggestions. May return null, if suggest entries do not have any context

Specified by:

contexts in interface InputIterator

hasContexts

public boolean hasContexts()

Description copied from interface: InputIterator

Returns true if the iterator has contexts

Specified by:

hasContexts in interface InputIterator