org.terrier.structures.postings.bit

Class BasicIterablePosting

java.lang.Object

org.terrier.structures.postings.BasicPostingImpl

org.terrier.structures.postings.bit.BasicIterablePosting

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable, org.apache.hadoop.io.Writable, IterablePosting, Posting, WritablePosting

Direct Known Subclasses:

BasicIterablePostingDocidOnly, BlockFieldIterablePosting, BlockIterablePosting, FieldIterablePosting

public class BasicIterablePosting
extends BasicPostingImpl
implements IterablePosting

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected BitIn	bitFileReader
protected DocumentIndex	doi
protected int	numEntries

Fields inherited from class org.terrier.structures.postings.BasicPostingImpl

dl, id, tf

Fields inherited from interface org.terrier.structures.postings.IterablePosting

END_OF_LIST, EOL

Constructor Summary

Constructors

Constructor and Description
BasicIterablePosting() Empty constructor used ONLY for reflection
BasicIterablePosting(BitIn _bitFileReader, int _numEntries, DocumentIndex _doi) Constructor

Method Summary

Modifier and Type	Method and Description
WritablePosting	asWritablePosting() Copies this posting to one free of an iterator.
void	close()
boolean	endOfPostings() Status method to see if this posting list iterator has been finished
int	getDocumentLength() Returns 0
int	next() Move this iterator to the next posting.
int	next(int target) Move this iterator to the posting with specified id, or next posting after that.
String	toString() Makes a human readable form of this posting

Methods inherited from class org.terrier.structures.postings.BasicPostingImpl

getFrequency, getId, readFields, setDocumentLength, setId, setTf, write

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.terrier.structures.postings.Posting

getFrequency, getId, setId

Field Detail

numEntries

protected int numEntries

bitFileReader

protected BitIn bitFileReader

doi

protected DocumentIndex doi

Constructor Detail

BasicIterablePosting

public BasicIterablePosting()

Empty constructor used ONLY for reflection

BasicIterablePosting

public BasicIterablePosting(BitIn _bitFileReader,
                            int _numEntries,
                            DocumentIndex _doi)
                     throws IOException

Constructor

Parameters:

_bitFileReader - The bit file where we read the postings from

_numEntries - Total number of postings to read before returning EOL

_doi - The document index to get the doc length of the current docid

Throws:

IOException

Method Detail

endOfPostings

public boolean endOfPostings()

Description copied from interface: IterablePosting

Status method to see if this posting list iterator has been finished

Specified by:

endOfPostings in interface IterablePosting

Returns:

true if next() or next(int) would return EOL or have returned EOL.

getDocumentLength

public int getDocumentLength()

Description copied from class: BasicPostingImpl

Returns 0

Specified by:

getDocumentLength in interface Posting

Overrides:

getDocumentLength in class BasicPostingImpl

Returns:

length of the document of the current posting in tokens.

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

asWritablePosting

public WritablePosting asWritablePosting()

Description copied from class: BasicPostingImpl

Copies this posting to one free of an iterator. Kind of like a clone.

Specified by:

asWritablePosting in interface Posting

Overrides:

asWritablePosting in class BasicPostingImpl

Returns:

an identical posting, but which can be maniulated free of this iterator

toString

public String toString()

Description copied from class: BasicPostingImpl

Makes a human readable form of this posting

Overrides:

toString in class BasicPostingImpl

next

public int next()
         throws IOException

Description copied from interface: IterablePosting

Move this iterator to the next posting.

Specified by:

next in interface IterablePosting

Returns:

id of next posting, or EOL if end of posting list

Throws:

IOException

next

public int next(int target)
         throws IOException

Description copied from interface: IterablePosting

Move this iterator to the posting with specified id, or next posting after that. This is usually implemented internally by next(), but more efficient implementations can override this behaviour.

Specified by:

next in interface IterablePosting

Parameters:

target - id of the posting to find in this posting list.

Returns:

id of the posting found, or EOL if end of posting list.

Throws:

IOException