Package org.apache.lucene.search
Interface FieldCache
-
public interface FieldCacheExpert: Maintains caches of term values.Created: May 19, 2004 11:13:14 AM
- Since:
- lucene 1.4
- See Also:
FieldCacheSanityChecker
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interfaceFieldCache.ByteParserInterface to parse bytes from document fields.static classFieldCache.CacheEntryEXPERT: A unique Identifier/Description for each item in the FieldCache.static classFieldCache.CreationPlaceholderstatic interfaceFieldCache.DoubleParserInterface to parse doubles from document fields.static interfaceFieldCache.FloatParserInterface to parse floats from document fields.static interfaceFieldCache.IntParserInterface to parse ints from document fields.static interfaceFieldCache.LongParserInterface to parse long from document fields.static interfaceFieldCache.ParserMarker interface as super-interface to all parsers.static interfaceFieldCache.ShortParserInterface to parse shorts from document fields.static classFieldCache.StringIndexExpert: Stores term text values and document ordering data.
-
Field Summary
Fields Modifier and Type Field Description static FieldCacheDEFAULTExpert: The cache used internally by sorting and range query classes.static FieldCache.ByteParserDEFAULT_BYTE_PARSERThe default parser for byte values, which are encoded byByte.toString(byte)static FieldCache.DoubleParserDEFAULT_DOUBLE_PARSERThe default parser for double values, which are encoded byDouble.toString(double)static FieldCache.FloatParserDEFAULT_FLOAT_PARSERThe default parser for float values, which are encoded byFloat.toString(float)static FieldCache.IntParserDEFAULT_INT_PARSERThe default parser for int values, which are encoded byInteger.toString(int)static FieldCache.LongParserDEFAULT_LONG_PARSERThe default parser for long values, which are encoded byLong.toString(long)static FieldCache.ShortParserDEFAULT_SHORT_PARSERThe default parser for short values, which are encoded byShort.toString(short)static FieldCache.DoubleParserNUMERIC_UTILS_DOUBLE_PARSERA parser instance for double values encoded withNumericUtils, e.g.static FieldCache.FloatParserNUMERIC_UTILS_FLOAT_PARSERA parser instance for float values encoded withNumericUtils, e.g.static FieldCache.IntParserNUMERIC_UTILS_INT_PARSERA parser instance for int values encoded byNumericUtils.intToPrefixCoded(int), e.g.static FieldCache.LongParserNUMERIC_UTILS_LONG_PARSERA parser instance for long values encoded byNumericUtils.longToPrefixCoded(long), e.g.static intSTRING_INDEXIndicator for StringIndex values in the cache.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description byte[]getBytes(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas a single byte and returns an array of sizereader.maxDoc()of the value each document has in the given field.byte[]getBytes(IndexReader reader, String field, FieldCache.ByteParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas bytes and returns an array of sizereader.maxDoc()of the value each document has in the given field.byte[]getBytes(IndexReader reader, String field, FieldCache.ByteParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas bytes and returns an array of sizereader.maxDoc()of the value each document has in the given field.FieldCache.CacheEntry[]getCacheEntries()EXPERT: Generates an array of CacheEntry objects representing all items currently in the FieldCache.BitsgetDocsWithField(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldand returns a bit set at the size ofreader.maxDoc(), with turned on bits for each docid that does have a value for this field.double[]getDoubles(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.double[]getDoubles(IndexReader reader, String field, FieldCache.DoubleParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas doubles and returns an array of sizereader.maxDoc()of the value each document has in the given field.double[]getDoubles(IndexReader reader, String field, FieldCache.DoubleParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas doubles and returns an array of sizereader.maxDoc()of the value each document has in the given field.float[]getFloats(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.float[]getFloats(IndexReader reader, String field, FieldCache.FloatParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.float[]getFloats(IndexReader reader, String field, FieldCache.FloatParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.PrintStreamgetInfoStream()counterpart ofsetInfoStream(PrintStream)int[]getInts(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.int[]getInts(IndexReader reader, String field, FieldCache.IntParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.int[]getInts(IndexReader reader, String field, FieldCache.IntParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.long[]getLongs(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.long[]getLongs(IndexReader reader, String field, FieldCache.LongParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.long[]getLongs(IndexReader reader, String field, FieldCache.LongParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.short[]getShorts(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.short[]getShorts(IndexReader reader, String field, FieldCache.ShortParser parser)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.short[]getShorts(IndexReader reader, String field, FieldCache.ShortParser parser, boolean setDocsWithField)Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.FieldCache.StringIndexgetStringIndex(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found reads the term values infieldand returns an array of them in natural order, along with an array telling which element in the term array each document uses.String[]getStrings(IndexReader reader, String field)Checks the internal cache for an appropriate entry, and if none is found, reads the term values infieldand returns an array of sizereader.maxDoc()containing the value each document has in the given field.voidpurge(IndexReader r)Expert: drops all cache entries associated with this reader.voidpurgeAllCaches()EXPERT: Instructs the FieldCache to forcibly expunge all entries from the underlying caches.voidsetInfoStream(PrintStream stream)If non-null, FieldCacheImpl will warn whenever entries are created that are not sane according toFieldCacheSanityChecker.
-
-
-
Field Detail
-
STRING_INDEX
static final int STRING_INDEX
Indicator for StringIndex values in the cache.- See Also:
- Constant Field Values
-
DEFAULT
static final FieldCache DEFAULT
Expert: The cache used internally by sorting and range query classes.
-
DEFAULT_BYTE_PARSER
static final FieldCache.ByteParser DEFAULT_BYTE_PARSER
The default parser for byte values, which are encoded byByte.toString(byte)
-
DEFAULT_SHORT_PARSER
static final FieldCache.ShortParser DEFAULT_SHORT_PARSER
The default parser for short values, which are encoded byShort.toString(short)
-
DEFAULT_INT_PARSER
static final FieldCache.IntParser DEFAULT_INT_PARSER
The default parser for int values, which are encoded byInteger.toString(int)
-
DEFAULT_FLOAT_PARSER
static final FieldCache.FloatParser DEFAULT_FLOAT_PARSER
The default parser for float values, which are encoded byFloat.toString(float)
-
DEFAULT_LONG_PARSER
static final FieldCache.LongParser DEFAULT_LONG_PARSER
The default parser for long values, which are encoded byLong.toString(long)
-
DEFAULT_DOUBLE_PARSER
static final FieldCache.DoubleParser DEFAULT_DOUBLE_PARSER
The default parser for double values, which are encoded byDouble.toString(double)
-
NUMERIC_UTILS_INT_PARSER
static final FieldCache.IntParser NUMERIC_UTILS_INT_PARSER
A parser instance for int values encoded byNumericUtils.intToPrefixCoded(int), e.g. when indexed viaNumericField/NumericTokenStream.
-
NUMERIC_UTILS_FLOAT_PARSER
static final FieldCache.FloatParser NUMERIC_UTILS_FLOAT_PARSER
A parser instance for float values encoded withNumericUtils, e.g. when indexed viaNumericField/NumericTokenStream.
-
NUMERIC_UTILS_LONG_PARSER
static final FieldCache.LongParser NUMERIC_UTILS_LONG_PARSER
A parser instance for long values encoded byNumericUtils.longToPrefixCoded(long), e.g. when indexed viaNumericField/NumericTokenStream.
-
NUMERIC_UTILS_DOUBLE_PARSER
static final FieldCache.DoubleParser NUMERIC_UTILS_DOUBLE_PARSER
A parser instance for double values encoded withNumericUtils, e.g. when indexed viaNumericField/NumericTokenStream.
-
-
Method Detail
-
getDocsWithField
Bits getDocsWithField(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldand returns a bit set at the size ofreader.maxDoc(), with turned on bits for each docid that does have a value for this field.- Throws:
IOException
-
getBytes
byte[] getBytes(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas a single byte and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the single byte values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getBytes
byte[] getBytes(IndexReader reader, String field, FieldCache.ByteParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas bytes and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the bytes.parser- Computes byte for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getBytes
byte[] getBytes(IndexReader reader, String field, FieldCache.ByteParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas bytes and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the bytes.parser- Computes byte for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getShorts
short[] getShorts(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the shorts.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getShorts
short[] getShorts(IndexReader reader, String field, FieldCache.ShortParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the shorts.parser- Computes short for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getShorts
short[] getShorts(IndexReader reader, String field, FieldCache.ShortParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas shorts and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the shorts.parser- Computes short for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getInts
int[] getInts(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the integers.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getInts
int[] getInts(IndexReader reader, String field, FieldCache.IntParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the integers.parser- Computes integer for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getInts
int[] getInts(IndexReader reader, String field, FieldCache.IntParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the integers.parser- Computes integer for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getFloats
float[] getFloats(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the floats.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getFloats
float[] getFloats(IndexReader reader, String field, FieldCache.FloatParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the floats.parser- Computes float for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getFloats
float[] getFloats(IndexReader reader, String field, FieldCache.FloatParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas floats and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the floats.parser- Computes float for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getLongs
long[] getLongs(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the longs.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getLongs
long[] getLongs(IndexReader reader, String field, FieldCache.LongParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the longs.parser- Computes integer for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getLongs
long[] getLongs(IndexReader reader, String field, FieldCache.LongParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas longs and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the longs.parser- Computes integer for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getDoubles
double[] getDoubles(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas integers and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the doubles.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getDoubles
double[] getDoubles(IndexReader reader, String field, FieldCache.DoubleParser parser) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas doubles and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the doubles.parser- Computes integer for string values.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getDoubles
double[] getDoubles(IndexReader reader, String field, FieldCache.DoubleParser parser, boolean setDocsWithField) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the terms infieldas doubles and returns an array of sizereader.maxDoc()of the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the doubles.parser- Computes integer for string values.setDocsWithField- If true thengetDocsWithField(org.apache.lucene.index.IndexReader, java.lang.String)will also be computed and stored in the FieldCache.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getStrings
String[] getStrings(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found, reads the term values infieldand returns an array of sizereader.maxDoc()containing the value each document has in the given field.- Parameters:
reader- Used to get field values.field- Which field contains the strings.- Returns:
- The values in the given field for each document.
- Throws:
IOException- If any error occurs.
-
getStringIndex
FieldCache.StringIndex getStringIndex(IndexReader reader, String field) throws IOException
Checks the internal cache for an appropriate entry, and if none is found reads the term values infieldand returns an array of them in natural order, along with an array telling which element in the term array each document uses.- Parameters:
reader- Used to get field values.field- Which field contains the strings.- Returns:
- Array of terms and index into the array for each document.
- Throws:
IOException- If any error occurs.
-
getCacheEntries
FieldCache.CacheEntry[] getCacheEntries()
EXPERT: Generates an array of CacheEntry objects representing all items currently in the FieldCache.NOTE: These CacheEntry objects maintain a strong reference to the Cached Values. Maintaining references to a CacheEntry the IndexReader associated with it has garbage collected will prevent the Value itself from being garbage collected when the Cache drops the WeakReference.
- WARNING: This API is experimental and might change in incompatible ways in the next release.
-
purgeAllCaches
void purgeAllCaches()
EXPERT: Instructs the FieldCache to forcibly expunge all entries from the underlying caches. This is intended only to be used for test methods as a way to ensure a known base state of the Cache (with out needing to rely on GC to free WeakReferences). It should not be relied on for "Cache maintenance" in general application code.
- WARNING: This API is experimental and might change in incompatible ways in the next release.
-
purge
void purge(IndexReader r)
Expert: drops all cache entries associated with this reader. NOTE: this reader must precisely match the reader that the cache entry is keyed on. If you pass a top-level reader, it usually will have no effect as Lucene now caches at the segment reader level.
-
setInfoStream
void setInfoStream(PrintStream stream)
If non-null, FieldCacheImpl will warn whenever entries are created that are not sane according toFieldCacheSanityChecker.
-
getInfoStream
PrintStream getInfoStream()
counterpart ofsetInfoStream(PrintStream)
-
-