org.apache.lucene.index

Class CodecReader

java.lang.Object

org.apache.lucene.index.IndexReader

org.apache.lucene.index.LeafReader

org.apache.lucene.index.CodecReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Accountable

Direct Known Subclasses:

FilterCodecReader, SegmentReader

public abstract class CodecReader
extends LeafReader
implements Accountable

LeafReader implemented by codec APIs.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.lucene.index.LeafReader

LeafReader.CoreClosedListener

Nested classes/interfaces inherited from class org.apache.lucene.index.IndexReader

IndexReader.ReaderClosedListener

Field Summary

Fields

Modifier and Type	Field and Description
(package private) CloseableThreadLocal<java.util.Map<java.lang.String,Bits>>	docsWithFieldLocal
(package private) CloseableThreadLocal<java.util.Map<java.lang.String,java.lang.Object>>	docValuesLocal
(package private) CloseableThreadLocal<java.util.Map<java.lang.String,NumericDocValues>>	normsLocal

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CodecReader() Sole constructor.

Method Summary

Modifier and Type	Method and Description
private void	checkBounds(int docID)
void	checkIntegrity() Checks consistency of this reader.
protected void	doClose() Implements close.
void	document(int docID, StoredFieldVisitor visitor) Expert: visits the fields of a stored document, for custom processing/loading of each field.
Fields	fields() Returns Fields for this reader.
BinaryDocValues	getBinaryDocValues(java.lang.String field) Returns BinaryDocValues for this field, or null if no BinaryDocValues were indexed for this field.
java.util.Collection<Accountable>	getChildResources() Returns nested resources of this class.
Bits	getDocsWithField(java.lang.String field) Returns a Bits at the size of reader.maxDoc(), with turned on bits for each docid that does have a value for this field, or null if no DocValues were indexed for this field.
abstract DocValuesProducer	getDocValuesReader() Expert: retrieve underlying DocValuesProducer
private FieldInfo	getDVField(java.lang.String field, DocValuesType type)
abstract StoredFieldsReader	getFieldsReader() Expert: retrieve thread-private StoredFieldsReader
abstract NormsProducer	getNormsReader() Expert: retrieve underlying NormsProducer
NumericDocValues	getNormValues(java.lang.String field) Returns NumericDocValues representing norms for this field, or null if no NumericDocValues were indexed.
NumericDocValues	getNumericDocValues(java.lang.String field) Returns NumericDocValues for this field, or null if no NumericDocValues were indexed for this field.
abstract PointsReader	getPointsReader() Expert: retrieve underlying PointsReader
abstract FieldsProducer	getPostingsReader() Expert: retrieve underlying FieldsProducer
SortedDocValues	getSortedDocValues(java.lang.String field) Returns SortedDocValues for this field, or null if no SortedDocValues were indexed for this field.
SortedNumericDocValues	getSortedNumericDocValues(java.lang.String field) Returns SortedNumericDocValues for this field, or null if no SortedNumericDocValues were indexed for this field.
SortedSetDocValues	getSortedSetDocValues(java.lang.String field) Returns SortedSetDocValues for this field, or null if no SortedSetDocValues were indexed for this field.
Fields	getTermVectors(int docID) Retrieve term vectors for this document, or null if term vectors were not indexed.
abstract TermVectorsReader	getTermVectorsReader() Expert: retrieve thread-private TermVectorsReader
long	ramBytesUsed() Return the memory usage of this object in bytes.

Methods inherited from class org.apache.lucene.index.LeafReader

addCoreClosedListener, addCoreClosedListenerAsReaderClosedListener, docFreq, getContext, getDocCount, getFieldInfos, getLiveDocs, getPointValues, getSumDocFreq, getSumTotalTermFreq, postings, postings, removeCoreClosedListener, removeCoreClosedListenerAsReaderClosedListener, terms, totalTermFreq

Methods inherited from class org.apache.lucene.index.IndexReader

addReaderClosedListener, close, decRef, document, document, ensureOpen, equals, getCombinedCoreAndDeletesKey, getCoreCacheKey, getRefCount, getTermVector, hasDeletions, hashCode, incRef, leaves, maxDoc, numDeletedDocs, numDocs, registerParentReader, removeReaderClosedListener, tryIncRef

Methods inherited from class java.lang.Object

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

Field Detail

docValuesLocal

final CloseableThreadLocal<java.util.Map<java.lang.String,java.lang.Object>> docValuesLocal

docsWithFieldLocal

final CloseableThreadLocal<java.util.Map<java.lang.String,Bits>> docsWithFieldLocal

normsLocal

final CloseableThreadLocal<java.util.Map<java.lang.String,NumericDocValues>> normsLocal

Constructor Detail

CodecReader

protected CodecReader()

Sole constructor. (For invocation by subclass constructors, typically implicit.)

Method Detail

getFieldsReader

public abstract StoredFieldsReader getFieldsReader()

Expert: retrieve thread-private StoredFieldsReader

getTermVectorsReader

public abstract TermVectorsReader getTermVectorsReader()

Expert: retrieve thread-private TermVectorsReader

getNormsReader

public abstract NormsProducer getNormsReader()

Expert: retrieve underlying NormsProducer

getDocValuesReader

public abstract DocValuesProducer getDocValuesReader()

Expert: retrieve underlying DocValuesProducer

getPostingsReader

public abstract FieldsProducer getPostingsReader()

Expert: retrieve underlying FieldsProducer

getPointsReader

public abstract PointsReader getPointsReader()

Expert: retrieve underlying PointsReader

document

public final void document(int docID,
                           StoredFieldVisitor visitor)
                    throws java.io.IOException

Description copied from class: IndexReader

Expert: visits the fields of a stored document, for custom processing/loading of each field. If you simply want to load all fields, use IndexReader.document(int). If you want to load a subset, use DocumentStoredFieldVisitor.

Specified by:

document in class IndexReader

Throws:

java.io.IOException

getTermVectors

public final Fields getTermVectors(int docID)
                            throws java.io.IOException

Description copied from class: IndexReader

Retrieve term vectors for this document, or null if term vectors were not indexed. The returned Fields instance acts like a single-document inverted index (the docID will be 0).

Specified by:

getTermVectors in class IndexReader

Throws:

java.io.IOException

checkBounds

private void checkBounds(int docID)

fields

public final Fields fields()

Description copied from class: LeafReader

Returns Fields for this reader. This method will not return null.

Specified by:

fields in class LeafReader

getDVField

private FieldInfo getDVField(java.lang.String field,
                             DocValuesType type)

getNumericDocValues

public final NumericDocValues getNumericDocValues(java.lang.String field)
                                           throws java.io.IOException

Description copied from class: LeafReader

Returns NumericDocValues for this field, or null if no NumericDocValues were indexed for this field. The returned instance should only be used by a single thread.

Specified by:

getNumericDocValues in class LeafReader

Throws:

java.io.IOException

getDocsWithField

public final Bits getDocsWithField(java.lang.String field)
                            throws java.io.IOException

Description copied from class: LeafReader

Returns a Bits at the size of reader.maxDoc(), with turned on bits for each docid that does have a value for this field, or null if no DocValues were indexed for this field. The returned instance should only be used by a single thread

Specified by:

getDocsWithField in class LeafReader

Throws:

java.io.IOException

getBinaryDocValues

public final BinaryDocValues getBinaryDocValues(java.lang.String field)
                                         throws java.io.IOException

Description copied from class: LeafReader

Returns BinaryDocValues for this field, or null if no BinaryDocValues were indexed for this field. The returned instance should only be used by a single thread.

Specified by:

getBinaryDocValues in class LeafReader

Throws:

java.io.IOException

getSortedDocValues

public final SortedDocValues getSortedDocValues(java.lang.String field)
                                         throws java.io.IOException

Description copied from class: LeafReader

Returns SortedDocValues for this field, or null if no SortedDocValues were indexed for this field. The returned instance should only be used by a single thread.

Specified by:

getSortedDocValues in class LeafReader

Throws:

java.io.IOException

getSortedNumericDocValues

public final SortedNumericDocValues getSortedNumericDocValues(java.lang.String field)
                                                       throws java.io.IOException

Description copied from class: LeafReader

Returns SortedNumericDocValues for this field, or null if no SortedNumericDocValues were indexed for this field. The returned instance should only be used by a single thread.

Specified by:

getSortedNumericDocValues in class LeafReader

Throws:

java.io.IOException

getSortedSetDocValues

public final SortedSetDocValues getSortedSetDocValues(java.lang.String field)
                                               throws java.io.IOException

Description copied from class: LeafReader

Returns SortedSetDocValues for this field, or null if no SortedSetDocValues were indexed for this field. The returned instance should only be used by a single thread.

Specified by:

getSortedSetDocValues in class LeafReader

Throws:

java.io.IOException

getNormValues

public final NumericDocValues getNormValues(java.lang.String field)
                                     throws java.io.IOException

Description copied from class: LeafReader

Returns NumericDocValues representing norms for this field, or null if no NumericDocValues were indexed. The returned instance should only be used by a single thread.

Specified by:

getNormValues in class LeafReader

Throws:

java.io.IOException

doClose

protected void doClose()
                throws java.io.IOException

Description copied from class: IndexReader

Implements close.

Specified by:

doClose in class IndexReader

Throws:

java.io.IOException

ramBytesUsed

public long ramBytesUsed()

Description copied from interface: Accountable

Return the memory usage of this object in bytes. Negative values are illegal.

Specified by:

ramBytesUsed in interface Accountable

getChildResources

public java.util.Collection<Accountable> getChildResources()

Description copied from interface: Accountable

Returns nested resources of this class. The result should be a point-in-time snapshot (to avoid race conditions).

Specified by:

getChildResources in interface Accountable

See Also:

Accountables

checkIntegrity

public void checkIntegrity()
                    throws java.io.IOException

Description copied from class: LeafReader

Checks consistency of this reader.

Note that this may be costly in terms of I/O, e.g. may involve computing a checksum value against large data files.

Specified by:

checkIntegrity in class LeafReader

Throws:

java.io.IOException