CodecReader

abstract class CodecReader : LeafReader

LeafReader implemented by codec APIs.

Inheritors

Properties

Link copied to clipboard
open override val context: LeafReaderContext

Expert: Returns the root IndexReaderContext for this IndexReader's sub-reader tree.

Link copied to clipboard

Optional method: Return a IndexReader.CacheHelper that can be used to cache based on the content of this leaf regardless of deletions. Two readers that have the same data but different sets of deleted documents or doc values updates may be considered equal. Consider using .getReaderCacheHelper if you need deletions or dv updates to be taken into account.

Link copied to clipboard

Expert: retrieve underlying DocValuesProducer

Link copied to clipboard
abstract val fieldInfos: FieldInfos

Get the FieldInfos describing all fields in this reader.

Link copied to clipboard

Expert: retrieve underlying StoredFieldsReader

Link copied to clipboard
abstract val liveDocs: Bits?

Returns the Bits representing live (not deleted) docs. A set bit indicates the doc ID has not been deleted. If this method returns null it means there are no deleted documents (all documents are live).

Link copied to clipboard
abstract val metaData: LeafMetaData

Return metadata about this leaf.

Link copied to clipboard
abstract val normsReader: NormsProducer?

Expert: retrieve underlying NormsProducer

Link copied to clipboard
abstract val pointsReader: PointsReader?

Expert: retrieve underlying PointsReader

Link copied to clipboard

Expert: retrieve underlying FieldsProducer

Link copied to clipboard

Optional method: Return a CacheHelper that can be used to cache based on the content of this reader. Two readers that have different data or different sets of deleted documents will be considered different.

Link copied to clipboard

Expert: retrieve underlying TermVectorsReader

Link copied to clipboard

Expert: retrieve underlying VectorReader

Functions

Link copied to clipboard
open override fun checkIntegrity()

Checks consistency of this reader.

Link copied to clipboard
open override fun close()

Closes files associated with this index. Also saves any new deletions to disk. No other methods should be called after this has been called.

Link copied to clipboard
fun decRef()

Expert: decreases the refCount of this IndexReader instance. If the refCount drops to 0, then this reader is closed. If an exception is hit, the refCount is unchanged.

Link copied to clipboard
open override fun docFreq(term: Term): Int

Returns the number of documents containing the term. This method returns 0 if the term or field does not exists. This method does not take into account deleted documents that have not yet been merged away.

Link copied to clipboard
open override fun doClose()

Implements close.

Link copied to clipboard

Throws AlreadyClosedException if this IndexReader or any of its child readers is closed, otherwise returns.

Link copied to clipboard
open operator override fun equals(obj: Any?): Boolean

{@inheritDoc}

Link copied to clipboard

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

Link copied to clipboard

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

Link copied to clipboard
open override fun getDocCount(field: String): Int

Returns the number of documents that have at least one term for this field. Note that, just like other term measures, this measure does not take deleted documents into account.

Link copied to clipboard

Returns a DocValuesSkipper allowing skipping ranges of doc IDs that are not of interest, or null if a skip index was not indexed. The returned instance should be confined to the thread that created it.

Link copied to clipboard

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

Link copied to clipboard
override fun getNormValues(field: String): NumericDocValues?

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

Link copied to clipboard

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

Link copied to clipboard
override fun getPointValues(field: String): PointValues?

Returns the PointValues used for numeric or spatial searches for the given field, or null if there are no point fields.

Link copied to clipboard

Expert: returns the current refCount for this reader

Link copied to clipboard

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.

Link copied to clipboard

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

Link copied to clipboard

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.

Link copied to clipboard
open override fun getSumDocFreq(field: String): Long

Returns the sum of TermsEnum.docFreq for all terms in this field. Note that, just like other term measures, this measure does not take deleted documents into account.

Link copied to clipboard
open override fun getSumTotalTermFreq(field: String): Long

Returns the sum of TermsEnum.totalTermFreq for all terms in this field. Note that, just like other term measures, this measure does not take deleted documents into account.

Link copied to clipboard

Returns true if any documents have been deleted. Implementers should consider overriding this method if .maxDoc or .numDocs are not constant-time operations.

Link copied to clipboard
open override fun hashCode(): Int

{@inheritDoc}

Link copied to clipboard
fun incRef()

Expert: increments the refCount of this IndexReader instance. RefCounts are used to determine when a reader can be closed safely, i.e. as soon as there are no more references. Be sure to always call a corresponding .decRef, in a finally clause; otherwise the reader may never be closed. Note that .close simply calls decRef(), which means that the IndexReader will not really be closed until .decRef has been called for all outstanding references.

Link copied to clipboard

Returns the reader's leaves, or itself if this reader is atomic. This is a convenience method calling this.getContext().leaves().

Link copied to clipboard
abstract fun maxDoc(): Int

Returns one greater than the largest possible document number. This may be used to, e.g., determine how big to allocate an array which will have an element for every document number in an index.

Link copied to clipboard

Returns the number of deleted documents.

Link copied to clipboard
abstract fun numDocs(): Int

Returns the number of documents in this index.

Link copied to clipboard

Returns PostingsEnum for the specified term with PostingsEnum.FREQS.

fun postings(term: Term, flags: Int): PostingsEnum?

Returns PostingsEnum for the specified term. This will return null if either the field or term does not exist.

Link copied to clipboard

Expert: This method is called by IndexReaders which wrap other readers (e.g. [ ] or FilterLeafReader) to register the parent at the child (this reader) on construction of the parent. When this reader is closed, it will mark all registered parents as closed, too. The references to parent readers are weak only, so they can be GCed once they are no longer in use.

Link copied to clipboard
override fun searchNearestVectors(field: String, target: ByteArray, knnCollector: KnnCollector, acceptDocs: Bits?)
override fun searchNearestVectors(field: String, target: FloatArray, knnCollector: KnnCollector, acceptDocs: Bits?)
fun searchNearestVectors(field: String, target: ByteArray, k: Int, acceptDocs: Bits?, visitedLimit: Int): TopDocs
fun searchNearestVectors(field: String, target: FloatArray, k: Int, acceptDocs: Bits?, visitedLimit: Int): TopDocs

Return the k nearest neighbor documents as determined by comparison of their vector values for this field, to the given vector, by the field's similarity function. The score of each document is derived from the vector similarity in a way that ensures scores are positive and that a larger score corresponds to a higher ranking.

Link copied to clipboard
override fun storedFields(): StoredFields

Returns a StoredFields reader for the stored fields of this index.

Link copied to clipboard
override fun terms(field: String?): Terms?

Returns the Terms index for this field, or null if it has none.

Link copied to clipboard
override fun termVectors(): TermVectors

Returns a TermVectors reader for the term vectors of this index.

Link copied to clipboard
open override fun totalTermFreq(term: Term): Long

Returns the number of documents containing the term t. This method returns 0 if the term or field does not exists. This method does not take into account deleted documents that have not yet been merged away.

Link copied to clipboard

Expert: increments the refCount of this IndexReader instance only if the IndexReader has not been closed yet and returns true iff the refCount was successfully incremented, otherwise false. If this method returns false the reader is either already closed or is currently being closed. Either way this reader instance shouldn't be used by an application unless true is returned.