org.apache.solr.util

Class ConcurrentLFUCache<K,V>

java.lang.Object

org.apache.solr.util.ConcurrentLFUCache<K,V>

All Implemented Interfaces:

Cache<K,V>

public class ConcurrentLFUCache<K,V>
extends Object
implements Cache<K,V>

A LFU cache implementation based upon ConcurrentHashMap.

This is not a terribly efficient implementation. The tricks used in the LRU version were not directly usable, perhaps it might be possible to rewrite them with LFU in mind.

This API is experimental and subject to change

Since:

solr 1.6

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ConcurrentLFUCache.EvictionListener<K,V>
static class	ConcurrentLFUCache.Stats

Constructor Summary

Constructors

Constructor and Description
ConcurrentLFUCache(int size, int lowerWatermark)
ConcurrentLFUCache(int upperWaterMark, int lowerWaterMark, int acceptableSize, int initialSize, boolean runCleanupThread, boolean runNewThreadForCleanup, ConcurrentLFUCache.EvictionListener<K,V> evictionListener, boolean timeDecay)

Method Summary

Methods

Modifier and Type	Method and Description
void	clear()
void	destroy()
protected void	finalize()
V	get(K key)
Map<K,V>	getLeastUsedItems(int n) Returns 'n' number of least used entries present in this cache.
Map<Object,org.apache.solr.util.ConcurrentLFUCache.CacheEntry<K,V>>	getMap()
Map<K,V>	getMostUsedItems(int n) Returns 'n' number of most used entries present in this cache.
ConcurrentLFUCache.Stats	getStats()
V	put(K key, V val)
V	remove(K key)
void	setAlive(boolean live)
int	size()

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentLFUCache

public ConcurrentLFUCache(int upperWaterMark,
                  int lowerWaterMark,
                  int acceptableSize,
                  int initialSize,
                  boolean runCleanupThread,
                  boolean runNewThreadForCleanup,
                  ConcurrentLFUCache.EvictionListener<K,V> evictionListener,
                  boolean timeDecay)

ConcurrentLFUCache

public ConcurrentLFUCache(int size,
                  int lowerWatermark)

Method Detail

setAlive

public void setAlive(boolean live)

get

public V get(K key)

Specified by:

get in interface Cache<K,V>

remove

public V remove(K key)

Specified by:

remove in interface Cache<K,V>

put

public V put(K key,
    V val)

Specified by:

put in interface Cache<K,V>

getLeastUsedItems

public Map<K,V> getLeastUsedItems(int n)

Returns 'n' number of least used entries present in this cache.

This uses a TreeSet to collect the 'n' least used items ordered by ascending hitcount and returns a LinkedHashMap containing 'n' or less than 'n' entries.

Parameters:

n - the number of items needed

Returns:

a LinkedHashMap containing 'n' or less than 'n' entries

getMostUsedItems

public Map<K,V> getMostUsedItems(int n)

Returns 'n' number of most used entries present in this cache.

This uses a TreeSet to collect the 'n' most used items ordered by descending hitcount and returns a LinkedHashMap containing 'n' or less than 'n' entries.

Parameters:

n - the number of items needed

Returns:

a LinkedHashMap containing 'n' or less than 'n' entries

size

public int size()

clear

public void clear()

Specified by:

clear in interface Cache<K,V>

getMap

public Map<Object,org.apache.solr.util.ConcurrentLFUCache.CacheEntry<K,V>> getMap()

destroy

public void destroy()

getStats

public ConcurrentLFUCache.Stats getStats()

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable