org.apache.lucene.uninverting

Class UninvertingReader

java.lang.Object

org.apache.lucene.index.IndexReader

org.apache.lucene.index.LeafReader

org.apache.lucene.index.FilterLeafReader

org.apache.lucene.uninverting.UninvertingReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

Deprecated.

This will be removed in Lucene 7.0.

@Deprecated
public class UninvertingReader
extends FilterLeafReader

A FilterReader that exposes indexed values as if they also had docvalues.

This is accomplished by "inverting the inverted index" or "uninversion".

The uninversion process happens lazily: upon the first request for the field's docvalues (e.g. via LeafReader.getNumericDocValues(String) or similar), it will create the docvalues on-the-fly if needed and cache it, based on the core cache key of the wrapped LeafReader.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UninvertingReader.Type Deprecated. Specifies the type of uninversion to apply for the field.
(package private) static class	UninvertingReader.UninvertingDirectoryReader Deprecated.

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

FilterLeafReader.FilterFields, FilterLeafReader.FilterPostingsEnum, FilterLeafReader.FilterTerms, FilterLeafReader.FilterTermsEnum

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) FieldInfos	fieldInfos Deprecated.
(package private) java.util.Map<java.lang.String,UninvertingReader.Type>	mapping Deprecated.

Fields inherited from class org.apache.lucene.index.FilterLeafReader

in

Constructor Summary

Constructors

Constructor and Description
UninvertingReader(LeafReader in, java.util.Map<java.lang.String,UninvertingReader.Type> mapping) Deprecated. Create a new UninvertingReader with the specified mapping

Method Summary

Modifier and Type	Method and Description
BinaryDocValues	getBinaryDocValues(java.lang.String field) Deprecated. Returns BinaryDocValues for this field, or null if no BinaryDocValues were indexed for this field.
java.lang.Object	getCombinedCoreAndDeletesKey() Deprecated. Expert: Returns a key for this IndexReader that also includes deletions, so CachingWrapperFilter can find it again.
java.lang.Object	getCoreCacheKey() Deprecated. Expert: Returns a key for this IndexReader, so CachingWrapperFilter can find it again.
Bits	getDocsWithField(java.lang.String field) Deprecated. 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.
FieldInfos	getFieldInfos() Deprecated. Get the FieldInfos describing all fields in this reader.
NumericDocValues	getNumericDocValues(java.lang.String field) Deprecated. Returns NumericDocValues for this field, or null if no NumericDocValues were indexed for this field.
SortedDocValues	getSortedDocValues(java.lang.String field) Deprecated. Returns SortedDocValues for this field, or null if no SortedDocValues were indexed for this field.
SortedSetDocValues	getSortedSetDocValues(java.lang.String field) Deprecated. Returns SortedSetDocValues for this field, or null if no SortedSetDocValues were indexed for this field.
private UninvertingReader.Type	getType(java.lang.String field) Deprecated. Returns the field's uninversion type, or null if the field doesn't exist or doesn't have a mapping.
static java.lang.String[]	getUninvertedStats() Deprecated. Return information about the backing cache
java.lang.String	toString() Deprecated.
static DirectoryReader	wrap(DirectoryReader in, java.util.Map<java.lang.String,UninvertingReader.Type> mapping) Deprecated. Wraps a provided DirectoryReader.

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

addCoreClosedListener, checkIntegrity, doClose, document, fields, getDelegate, getLiveDocs, getNormValues, getPointValues, getSortedNumericDocValues, getTermVectors, maxDoc, numDocs, removeCoreClosedListener, unwrap

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

addCoreClosedListenerAsReaderClosedListener, docFreq, getContext, getDocCount, getSumDocFreq, getSumTotalTermFreq, postings, postings, removeCoreClosedListenerAsReaderClosedListener, terms, totalTermFreq

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

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

Methods inherited from class java.lang.Object

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

Field Detail

mapping

final java.util.Map<java.lang.String,UninvertingReader.Type> mapping

Deprecated.

fieldInfos

final FieldInfos fieldInfos

Deprecated.

Constructor Detail

UninvertingReader

public UninvertingReader(LeafReader in,
                         java.util.Map<java.lang.String,UninvertingReader.Type> mapping)

Deprecated.

Create a new UninvertingReader with the specified mapping

Expert: This should almost never be used. Use wrap(DirectoryReader, Map) instead.

Method Detail

wrap

public static DirectoryReader wrap(DirectoryReader in,
                                   java.util.Map<java.lang.String,UninvertingReader.Type> mapping)
                            throws java.io.IOException

Deprecated.

Wraps a provided DirectoryReader. Note that for convenience, the returned reader can be used normally (e.g. passed to DirectoryReader.openIfChanged(DirectoryReader)) and so on.

Throws:

java.io.IOException

getFieldInfos

public FieldInfos getFieldInfos()

Deprecated.

Description copied from class: LeafReader

Get the FieldInfos describing all fields in this reader.

Overrides:

getFieldInfos in class FilterLeafReader

getNumericDocValues

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

Deprecated.

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.

Overrides:

getNumericDocValues in class FilterLeafReader

Throws:

java.io.IOException

getBinaryDocValues

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

Deprecated.

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.

Overrides:

getBinaryDocValues in class FilterLeafReader

Throws:

java.io.IOException

getSortedDocValues

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

Deprecated.

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.

Overrides:

getSortedDocValues in class FilterLeafReader

Throws:

java.io.IOException

getSortedSetDocValues

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

Deprecated.

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.

Overrides:

getSortedSetDocValues in class FilterLeafReader

Throws:

java.io.IOException

getDocsWithField

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

Deprecated.

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

Overrides:

getDocsWithField in class FilterLeafReader

Throws:

java.io.IOException

getType

private UninvertingReader.Type getType(java.lang.String field)

Deprecated.

Returns the field's uninversion type, or null if the field doesn't exist or doesn't have a mapping.

getCoreCacheKey

public java.lang.Object getCoreCacheKey()

Deprecated.

Description copied from class: IndexReader

Expert: Returns a key for this IndexReader, so CachingWrapperFilter can find it again. This key must not have equals()/hashCode() methods, so "equals" means "identical".

Overrides:

getCoreCacheKey in class IndexReader

getCombinedCoreAndDeletesKey

public java.lang.Object getCombinedCoreAndDeletesKey()

Deprecated.

Description copied from class: IndexReader

Expert: Returns a key for this IndexReader that also includes deletions, so CachingWrapperFilter can find it again. This key must not have equals()/hashCode() methods, so "equals" means "identical".

Overrides:

getCombinedCoreAndDeletesKey in class IndexReader

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class FilterLeafReader

getUninvertedStats

public static java.lang.String[] getUninvertedStats()

Deprecated.

Return information about the backing cache