org.apache.lucene.codecs.lucene40

Class Lucene40PostingsWriter

java.lang.Object

org.apache.lucene.codecs.PostingsConsumer

org.apache.lucene.codecs.PostingsWriterBase

org.apache.lucene.codecs.lucene40.Lucene40PostingsWriter

All Implemented Interfaces:

Closeable, AutoCloseable

public final class Lucene40PostingsWriter
extends PostingsWriterBase

Concrete class that writes the 4.0 frq/prx postings format.

See Also:

Lucene40PostingsFormat

Constructor Summary

Constructors

Constructor and Description
Lucene40PostingsWriter(SegmentWriteState state) Creates a Lucene40PostingsWriter, with the DEFAULT_SKIP_INTERVAL.
Lucene40PostingsWriter(SegmentWriteState state, int skipInterval) Creates a Lucene40PostingsWriter, with the specified skipInterval.

Method Summary

Modifier and Type	Method and Description
void	addPosition(int position, BytesRef payload, int startOffset, int endOffset) Add a new position & payload
void	close()
void	encodeTerm(long[] empty, DataOutput out, FieldInfo fieldInfo, BlockTermState _state, boolean absolute) Encode metadata as long[] and byte[].
void	finishDoc() Called when we are done adding positions & payloads for each doc.
void	finishTerm(BlockTermState _state) Called when we are done adding docs to this term
void	init(IndexOutput termsOut) Called once after startup, before any terms have been added.
BlockTermState	newTermState() Return a newly created empty TermState
int	setField(FieldInfo fieldInfo) Sets the current field for writing, and returns the fixed length of long[] metadata (which is fixed per field), called when the writing switches to another field.
void	startDoc(int docID, int termDocFreq) Adds a new doc in this term.
void	startTerm() Start a new term.

Methods inherited from class org.apache.lucene.codecs.PostingsConsumer

merge

Methods inherited from class java.lang.Object

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

Constructor Detail

Lucene40PostingsWriter

public Lucene40PostingsWriter(SegmentWriteState state)
                       throws IOException

Creates a Lucene40PostingsWriter, with the DEFAULT_SKIP_INTERVAL.

Throws:

IOException

Lucene40PostingsWriter

public Lucene40PostingsWriter(SegmentWriteState state,
                              int skipInterval)
                       throws IOException

Creates a Lucene40PostingsWriter, with the specified skipInterval.

Throws:

IOException

Method Detail

init

public void init(IndexOutput termsOut)
          throws IOException

Description copied from class: PostingsWriterBase

Called once after startup, before any terms have been added. Implementations typically write a header to the provided termsOut.

Specified by:

init in class PostingsWriterBase

Throws:

IOException

newTermState

public BlockTermState newTermState()

Description copied from class: PostingsWriterBase

Return a newly created empty TermState

Specified by:

newTermState in class PostingsWriterBase

startTerm

public void startTerm()

Description copied from class: PostingsWriterBase

Start a new term. Note that a matching call to PostingsWriterBase.finishTerm(BlockTermState) is done, only if the term has at least one document.

Specified by:

startTerm in class PostingsWriterBase

setField

public int setField(FieldInfo fieldInfo)

Description copied from class: PostingsWriterBase

Sets the current field for writing, and returns the fixed length of long[] metadata (which is fixed per field), called when the writing switches to another field.

Specified by:

setField in class PostingsWriterBase

startDoc

public void startDoc(int docID,
                     int termDocFreq)
              throws IOException

Description copied from class: PostingsConsumer

Adds a new doc in this term. freq will be -1 when term frequencies are omitted for the field.

Specified by:

startDoc in class PostingsConsumer

Throws:

IOException

addPosition

public void addPosition(int position,
                        BytesRef payload,
                        int startOffset,
                        int endOffset)
                 throws IOException

Add a new position & payload

Specified by:

addPosition in class PostingsConsumer

Throws:

IOException

finishDoc

public void finishDoc()

Description copied from class: PostingsConsumer

Called when we are done adding positions & payloads for each doc.

Specified by:

finishDoc in class PostingsConsumer

finishTerm

public void finishTerm(BlockTermState _state)
                throws IOException

Called when we are done adding docs to this term

Specified by:

finishTerm in class PostingsWriterBase

Throws:

IOException

encodeTerm

public void encodeTerm(long[] empty,
                       DataOutput out,
                       FieldInfo fieldInfo,
                       BlockTermState _state,
                       boolean absolute)
                throws IOException

Description copied from class: PostingsWriterBase

Encode metadata as long[] and byte[]. absolute controls whether current term is delta encoded according to latest term. Usually elements in longs are file pointers, so each one always increases when a new term is consumed. out is used to write generic bytes, which are not monotonic. NOTE: sometimes long[] might contain "don't care" values that are unused, e.g. the pointer to postings list may not be defined for some terms but is defined for others, if it is designed to inline some postings data in term dictionary. In this case, the postings writer should always use the last value, so that each element in metadata long[] remains monotonic.

Specified by:

encodeTerm in class PostingsWriterBase

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in class PostingsWriterBase

Throws:

IOException