org.apache.solr.search

Class LFUCache<K,V>

java.lang.Object

org.apache.solr.search.LFUCache<K,V>

All Implemented Interfaces:

AutoCloseable, Accountable, SolrInfoBean, SolrMetricProducer, SolrCache<K,V>

Deprecated.

This cache implementation is deprecated and will be removed in Solr 9.0. Use CaffeineCache instead.

public class LFUCache<K,V>
extends Object
implements SolrCache<K,V>, Accountable

SolrCache based on ConcurrentLFUCache implementation.

This implementation does not use a separate cleanup thread. Instead it uses the calling thread itself to do the cleanup when the size of the cache exceeds certain limits.

Also see SolrCaching

This API is experimental and subject to change

Since:

solr 3.6

See Also:

ConcurrentLFUCache, SolrCache

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.solr.search.SolrCache

SolrCache.State

Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoBean

SolrInfoBean.Category, SolrInfoBean.Group

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACCEPTABLE_SIZE_PARAM Deprecated.
static String	AUTOWARM_COUNT_PARAM Deprecated.
static String	CLEANUP_THREAD_PARAM Deprecated.
static String	INITIAL_SIZE_PARAM Deprecated.
static String	MIN_SIZE_PARAM Deprecated.
static String	SHOW_ITEMS_PARAM Deprecated.
static String	TIME_DECAY_PARAM Deprecated.

Fields inherited from interface org.apache.solr.search.SolrCache

EVICTIONS_PARAM, HIT_RATIO_PARAM, HITS_PARAM, INSERTS_PARAM, LOOKUPS_PARAM, MAX_IDLE_TIME_PARAM, MAX_RAM_MB_PARAM, MAX_SIZE_PARAM, RAM_BYTES_USED_PARAM, SIZE_PARAM

Constructor Summary

Constructors

Constructor and Description
LFUCache() Deprecated.

Method Summary

Modifier and Type	Method and Description
void	clear() Deprecated. :TODO: copy from Map
void	close() Deprecated. Frees any non-memory resources
V	computeIfAbsent(K key, Function<? super K,? extends V> mappingFunction) Deprecated. Get an existing element or atomically compute it if missing.
V	get(K key) Deprecated. :TODO: copy from Map
SolrInfoBean.Category	getCategory() Deprecated. Category of this component
String	getDescription() Deprecated. Simple one or two line description
int	getMaxRamMB() Deprecated. Returns maximum size limit (in MB) if set and supported, -1 otherwise.
int	getMaxSize() Deprecated. Returns maximum size limit (number of items) if set and supported, -1 otherwise.
Set<String>	getMetricNames() Deprecated. Modifiable set of metric names that this component reports (default is null, which means none).
String	getName() Deprecated. Simple common usage name, e.g.
SolrMetricsContext	getSolrMetricsContext() Deprecated. Implementing classes should override this method to provide the context obtained in SolrMetricProducer.initializeMetrics(SolrMetricsContext, String) to ensure proper cleanup of metrics at the end of the life-cycle of this component.
SolrCache.State	getState() Deprecated. Returns the last State set on this instance
Object	init(Map args, Object persistence, CacheRegenerator regenerator) Deprecated. The initialization routine.
void	initializeMetrics(SolrMetricsContext parentContext, String scope) Deprecated. Initialize metrics specific to this producer.
String	name() Deprecated. Name the Cache can be referenced with by SolrRequestHandlers.
V	put(K key, V value) Deprecated. :TODO: copy from Map
long	ramBytesUsed() Deprecated.
V	remove(K key) Deprecated.
void	setMaxRamMB(int maxRamMB) Deprecated. Set maximum size limit (in MB), or -1 for unlimited.
void	setMaxSize(int maxSize) Deprecated. Set maximum size limit (number of items), or -1 for unlimited.
void	setState(SolrCache.State state) Deprecated. Set different cache states.
int	size() Deprecated. :TODO: copy from Map
String	toString() Deprecated.
void	warm(SolrIndexSearcher searcher, SolrCache old) Deprecated. Warm this cache associated with searcher using the old cache object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.solr.core.SolrInfoBean

getMetricRegistry, getMetricsSnapshot, registerMetricName

Methods inherited from interface org.apache.solr.metrics.SolrMetricProducer

getUniqueMetricTag, initializeMetrics

Methods inherited from interface org.apache.lucene.util.Accountable

getChildResources

Field Detail

TIME_DECAY_PARAM

public static final String TIME_DECAY_PARAM

Deprecated.

See Also:

Constant Field Values

CLEANUP_THREAD_PARAM

public static final String CLEANUP_THREAD_PARAM

Deprecated.

See Also:

Constant Field Values

INITIAL_SIZE_PARAM

public static final String INITIAL_SIZE_PARAM

Deprecated.

See Also:

Constant Field Values

MIN_SIZE_PARAM

public static final String MIN_SIZE_PARAM

Deprecated.

See Also:

Constant Field Values

ACCEPTABLE_SIZE_PARAM

public static final String ACCEPTABLE_SIZE_PARAM

Deprecated.

See Also:

Constant Field Values

AUTOWARM_COUNT_PARAM

public static final String AUTOWARM_COUNT_PARAM

Deprecated.

See Also:

Constant Field Values

SHOW_ITEMS_PARAM

public static final String SHOW_ITEMS_PARAM

Deprecated.

See Also:

Constant Field Values

Constructor Detail

LFUCache

public LFUCache()

Deprecated.

Method Detail

init

public Object init(Map args,
                   Object persistence,
                   CacheRegenerator regenerator)

Deprecated.

Description copied from interface: SolrCache

The initialization routine. Instance specific arguments are passed in the args map.

The persistence object will exist across different lifetimes of similar caches. For example, all filter caches will share the same persistence object, sometimes at the same time (it must be thread-safe). If null is passed, then the cache implementation should create and return a new persistence object. If not null, the passed in object should be returned again.

Since it will exist across the lifetime of many caches, care should be taken to not reference any particular cache instance and prevent it from being garbage collected (no using inner classes unless they are static).

The persistence object is designed to be used as a way for statistics to accumulate across all instances of the same type of cache, however the object may be of any type desired by the cache implementation.

The CacheRegenerator is what the cache uses during auto-warming to regenerate an item in the new cache from an entry in the old cache.

Specified by:

init in interface SolrCache<K,V>

name

public String name()

Deprecated.

Description copied from interface: SolrCache

Name the Cache can be referenced with by SolrRequestHandlers. This method must return the identifier that the Cache instance expects SolrRequestHandlers to use when requesting access to it from the SolrIndexSearcher. It is strongly recommended that this method return the value of the "name" parameter from the init args. :TODO: verify this.

Specified by:

name in interface SolrCache<K,V>

size

public int size()

Deprecated.

Description copied from interface: SolrCache

:TODO: copy from Map

Specified by:

size in interface SolrCache<K,V>

put

public V put(K key,
             V value)

Deprecated.

Description copied from interface: SolrCache

:TODO: copy from Map

Specified by:

put in interface SolrCache<K,V>

remove

public V remove(K key)

Deprecated.

Specified by:

remove in interface SolrCache<K,V>

computeIfAbsent

public V computeIfAbsent(K key,
                         Function<? super K,? extends V> mappingFunction)

Deprecated.

Description copied from interface: SolrCache

Get an existing element or atomically compute it if missing.

Specified by:

computeIfAbsent in interface SolrCache<K,V>

Parameters:

key - key

mappingFunction - function to compute the element. If the function returns a null result the cache mapping will not be created. NOTE: this function must NOT attempt to modify any mappings in the cache.

Returns:

existing or newly computed value, null if there was no existing value and it was not possible to compute a new value (in which case the new mapping won't be created).

get

public V get(K key)

Deprecated.

Description copied from interface: SolrCache

:TODO: copy from Map

Specified by:

get in interface SolrCache<K,V>

clear

public void clear()

Deprecated.

Description copied from interface: SolrCache

:TODO: copy from Map

Specified by:

clear in interface SolrCache<K,V>

setState

public void setState(SolrCache.State state)

Deprecated.

Description copied from interface: SolrCache

Set different cache states. The state a cache is in can have an effect on how statistics are kept. The cache user (SolrIndexSearcher) will take care of switching cache states.

Specified by:

setState in interface SolrCache<K,V>

getState

public SolrCache.State getState()

Deprecated.

Description copied from interface: SolrCache

Returns the last State set on this instance

Specified by:

getState in interface SolrCache<K,V>

See Also:

SolrCache.setState(org.apache.solr.search.SolrCache.State)

warm

public void warm(SolrIndexSearcher searcher,
                 SolrCache old)

Deprecated.

Description copied from interface: SolrCache

Warm this cache associated with searcher using the old cache object. this and old will have the same concrete type.

Specified by:

warm in interface SolrCache<K,V>

close

public void close()
           throws Exception

Deprecated.

Description copied from interface: SolrCache

Frees any non-memory resources

Specified by:

close in interface AutoCloseable

Specified by:

close in interface SolrMetricProducer

Specified by:

close in interface SolrCache<K,V>

Throws:

Exception

getName

public String getName()

Deprecated.

Description copied from interface: SolrInfoBean

Simple common usage name, e.g. BasicQueryHandler, or fully qualified class name.

Specified by:

getName in interface SolrInfoBean

getDescription

public String getDescription()

Deprecated.

Description copied from interface: SolrInfoBean

Simple one or two line description

Specified by:

getDescription in interface SolrInfoBean

getCategory

public SolrInfoBean.Category getCategory()

Deprecated.

Description copied from interface: SolrInfoBean

Category of this component

Specified by:

getCategory in interface SolrInfoBean

getSolrMetricsContext

public SolrMetricsContext getSolrMetricsContext()

Deprecated.

Description copied from interface: SolrMetricProducer

Implementing classes should override this method to provide the context obtained in SolrMetricProducer.initializeMetrics(SolrMetricsContext, String) to ensure proper cleanup of metrics at the end of the life-cycle of this component.

Specified by:

getSolrMetricsContext in interface SolrMetricProducer

initializeMetrics

public void initializeMetrics(SolrMetricsContext parentContext,
                              String scope)

Deprecated.

Description copied from interface: SolrMetricProducer

Initialize metrics specific to this producer.

Specified by:

initializeMetrics in interface SolrMetricProducer

Parameters:

parentContext - parent metrics context. If this component has the same life-cycle as the parent it can simply use the parent context, otherwise it should obtain a child context using SolrMetricsContext.getChildContext(Object) passing this as the child.

scope - component scope

getMetricNames

public Set<String> getMetricNames()

Deprecated.

Description copied from interface: SolrInfoBean

Modifiable set of metric names that this component reports (default is null, which means none). If not null then this set is used by SolrInfoBean.registerMetricName(String) to capture what metrics names are reported from this component.

NOTE: this set has to allow iteration under modifications.

Specified by:

getMetricNames in interface SolrInfoBean

toString

public String toString()

Deprecated.

Overrides:

toString in class Object

ramBytesUsed

public long ramBytesUsed()

Deprecated.

Specified by:

ramBytesUsed in interface Accountable

getMaxSize

public int getMaxSize()

Deprecated.

Description copied from interface: SolrCache

Returns maximum size limit (number of items) if set and supported, -1 otherwise.

Specified by:

getMaxSize in interface SolrCache<K,V>

setMaxSize

public void setMaxSize(int maxSize)

Deprecated.

Description copied from interface: SolrCache

Set maximum size limit (number of items), or -1 for unlimited. Note: this has effect only on implementations that support it, it's a no-op otherwise

Specified by:

setMaxSize in interface SolrCache<K,V>

getMaxRamMB

public int getMaxRamMB()

Deprecated.

Description copied from interface: SolrCache

Returns maximum size limit (in MB) if set and supported, -1 otherwise.

Specified by:

getMaxRamMB in interface SolrCache<K,V>

setMaxRamMB

public void setMaxRamMB(int maxRamMB)

Deprecated.

Description copied from interface: SolrCache

Set maximum size limit (in MB), or -1 for unlimited. Note: this has effect only on implementations that support it, it's a no-op otherwise.

Specified by:

setMaxRamMB in interface SolrCache<K,V>