org.apache.solr.uninverting

Class UninvertingReader

java.lang.Object

org.apache.lucene.index.IndexReader

org.apache.lucene.index.LeafReader

org.apache.lucene.index.FilterLeafReader

org.apache.solr.uninverting.UninvertingReader

All Implemented Interfaces:

Closeable, AutoCloseable

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.FieldCacheStats Return information about the backing cache
static class	UninvertingReader.Type Specifies the type of uninversion to apply for the field.

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.IndexReader

IndexReader.CacheHelper, IndexReader.CacheKey, IndexReader.ClosedListener

Field Summary

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

in

Method Summary

Modifier and Type	Method and Description
BinaryDocValues	getBinaryDocValues(String field)
IndexReader.CacheHelper	getCoreCacheHelper()
FieldInfos	getFieldInfos()
NumericDocValues	getNumericDocValues(String field)
IndexReader.CacheHelper	getReaderCacheHelper()
SortedDocValues	getSortedDocValues(String field)
SortedSetDocValues	getSortedSetDocValues(String field)
static UninvertingReader.FieldCacheStats	getUninvertedStats() Return information about the backing cache
static int	getUninvertedStatsSize()
String	toString()
static DirectoryReader	wrap(DirectoryReader in, Function<String,UninvertingReader.Type> mapper) Wraps a provided DirectoryReader.
static DirectoryReader	wrap(DirectoryReader reader, Map<String,UninvertingReader.Type> mapping)
static LeafReader	wrap(LeafReader in, Function<String,UninvertingReader.Type> mapping) Create a new UninvertingReader with the specified mapping, wrapped around the input.

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

checkIntegrity, doClose, document, getDelegate, getLiveDocs, getMetaData, getNormValues, getPointValues, getSortedNumericDocValues, getTermVectors, maxDoc, numDocs, terms, unwrap

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

docFreq, getContext, getDocCount, getSumDocFreq, getSumTotalTermFreq, postings, postings, totalTermFreq

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

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

Methods inherited from class java.lang.Object

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

Method Detail

wrap

public static DirectoryReader wrap(DirectoryReader reader,
                                   Map<String,UninvertingReader.Type> mapping)
                            throws IOException

Throws:

IOException

See Also:

wrap(DirectoryReader, Function)

wrap

public static DirectoryReader wrap(DirectoryReader in,
                                   Function<String,UninvertingReader.Type> mapper)
                            throws IOException

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.

Parameters:

in - input directory reader

mapper - function to map a field name to an uninversion type. A Null result means to not uninvert.

Returns:

a wrapped directory reader

Throws:

IOException

wrap

public static LeafReader wrap(LeafReader in,
                              Function<String,UninvertingReader.Type> mapping)

Create a new UninvertingReader with the specified mapping, wrapped around the input. It may be deemed that there is no mapping to do, in which case the input is returned.

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

NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.

getFieldInfos

public FieldInfos getFieldInfos()

Overrides:

getFieldInfos in class FilterLeafReader

getNumericDocValues

public NumericDocValues getNumericDocValues(String field)
                                     throws IOException

Overrides:

getNumericDocValues in class FilterLeafReader

Throws:

IOException

getBinaryDocValues

public BinaryDocValues getBinaryDocValues(String field)
                                   throws IOException

Overrides:

getBinaryDocValues in class FilterLeafReader

Throws:

IOException

getSortedDocValues

public SortedDocValues getSortedDocValues(String field)
                                   throws IOException

Overrides:

getSortedDocValues in class FilterLeafReader

Throws:

IOException

getSortedSetDocValues

public SortedSetDocValues getSortedSetDocValues(String field)
                                         throws IOException

Overrides:

getSortedSetDocValues in class FilterLeafReader

Throws:

IOException

getCoreCacheHelper

public IndexReader.CacheHelper getCoreCacheHelper()

Specified by:

getCoreCacheHelper in class LeafReader

getReaderCacheHelper

public IndexReader.CacheHelper getReaderCacheHelper()

Specified by:

getReaderCacheHelper in class IndexReader

toString

public String toString()

Overrides:

toString in class FilterLeafReader

getUninvertedStats

public static UninvertingReader.FieldCacheStats getUninvertedStats()

Return information about the backing cache

NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.

getUninvertedStatsSize

public static int getUninvertedStatsSize()