manifold.util.concurrent

Class Cache<K,V>

java.lang.Object

manifold.util.concurrent.Cache<K,V>

public class Cache<K,V>
extends java.lang.Object

static var MY_CACHE = new Cache( 1000, \ foo -> getBar( foo ) )

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Cache.Loader<L,W>

Constructor Summary

Constructors

Constructor and Description
Cache(java.lang.String name, int size, Cache.Loader<K,V> loader) This will create a new cache

Method Summary

Modifier and Type	Method and Description
void	clear()
V	evict(K key) This will evict a specific key from the cache.
V	get(K key) This will get a specific entry, it will call the missHandler if it is not found.
java.lang.Iterable<V>	getCachedValues()
int	getConfiguredSize()
double	getHitRate()
int	getHits()
int	getMisses()
int	getRequests()
int	getUtilizedSize()
Cache<K,V>	logEveryNSeconds(int seconds, ILogger logger) Sets up a recurring task every n seconds to report on the status of this cache.
static <K,V> Cache<K,V>	make(java.lang.String name, int size, Cache.Loader<K,V> handler)
V	put(K key, V value) This will put a specific entry in the cache
void	stopLogging()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Cache

public Cache(java.lang.String name,
             int size,
             Cache.Loader<K,V> loader)

This will create a new cache

Parameters:

name - the name of the cache for logging

size - the maximum size of the log

loader - loads values into the cache, this is required not to be null

Method Detail

evict

public V evict(K key)

This will evict a specific key from the cache.

Parameters:

key - the key to evict

Returns:

the current value for that key

put

public V put(K key,
             V value)

This will put a specific entry in the cache

Parameters:

key - this is the key

value - this is the value

Returns:

the old value for this key

get

public V get(K key)

This will get a specific entry, it will call the missHandler if it is not found.

Parameters:

key - the object to find

Returns:

the found object (may be null)

getCachedValues

public java.lang.Iterable<V> getCachedValues()

getConfiguredSize

public int getConfiguredSize()

getUtilizedSize

public int getUtilizedSize()

getRequests

public int getRequests()

getMisses

public int getMisses()

getHits

public int getHits()

getHitRate

public double getHitRate()

logEveryNSeconds

public Cache<K,V> logEveryNSeconds(int seconds,
                                   ILogger logger)

Sets up a recurring task every n seconds to report on the status of this cache. This can be useful if you are doing exploratory caching and wish to monitor the performance of this cache with minimal fuss. Consider

Parameters:

seconds - how often to log the entry

logger - the logger to use

Returns:

this

stopLogging

public void stopLogging()

clear

public void clear()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

make

public static <K,V> Cache<K,V> make(java.lang.String name,
                                    int size,
                                    Cache.Loader<K,V> handler)