| java.lang.Object | |
| ↳ | org.apache.lucene.util.FieldCacheSanityChecker |
Class Overview
Provides methods for sanity checking that entries in the FieldCache are not wasteful or inconsistent.
Lucene 2.9 Introduced numerous enhancements into how the FieldCache is used by the low levels of Lucene searching (for Sorting and ValueSourceQueries) to improve both the speed for Sorting, as well as reopening of IndexReaders. But these changes have shifted the usage of FieldCache from "top level" IndexReaders (frequently a MultiReader or DirectoryReader) down to the leaf level SegmentReaders. As a result, existing applications that directly access the FieldCache may find RAM usage increase significantly when upgrading to 2.9 or Later. This class provides an API for these applications (or their Unit tests) to check at run time if the FieldCache contains "insane" usages of the FieldCache.
EXPERIMENTAL API: This API is considered extremely advanced and experimental. It may be removed or altered w/o warning in future releases of Lucene.
Summary
| Nested Classes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| FieldCacheSanityChecker.Insanity | Simple container for a collection of related CacheEntry objects that in conjunction with each other represent some "insane" usage of the FieldCache. | ||||||||||
| FieldCacheSanityChecker.InsanityType | An Enumeration of the different types of "insane" behavior that may be detected in a FieldCache. | ||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Tests a CacheEntry[] for indication of "insane" cache usage.
| |||||||||||
Quick and dirty convenience method that instantiates an instance with
"good defaults" and uses it to test the CacheEntrys
| |||||||||||
Quick and dirty convenience method
| |||||||||||
If set, will be used to estimate size for all CacheEntry objects
dealt with.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
Public Constructors
public FieldCacheSanityChecker ()
Public Methods
public Insanity[] check (CacheEntry... cacheEntries)
Tests a CacheEntry[] for indication of "insane" cache usage.
NOTE:FieldCache CreationPlaceholder objects are ignored. (:TODO: is this a bad idea? are we masking a real problem?)
public static Insanity[] checkSanity (CacheEntry... cacheEntries)
Quick and dirty convenience method that instantiates an instance with "good defaults" and uses it to test the CacheEntrys
See Also
public void setRamUsageEstimator (RamUsageEstimator r)
If set, will be used to estimate size for all CacheEntry objects dealt with.