Class LFUCache<K,​V>

  • All Implemented Interfaces:
    AutoCloseable, org.apache.lucene.util.Accountable, SolrInfoBean, SolrMetricProducer, SolrCache<K,​V>

    public class LFUCache<K,​V>
    extends Object
    implements SolrCache<K,​V>, org.apache.lucene.util.Accountable
    Deprecated.
    This cache implementation is deprecated and will be removed in Solr 9.0. Use CaffeineCache instead.
    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
    • 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>
      • 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>
      • 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
      • 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
      • ramBytesUsed

        public long ramBytesUsed()
        Deprecated.
        Specified by:
        ramBytesUsed in interface org.apache.lucene.util.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>