ch.bind.philib.cache
Interface Cache<K,V>

All Known Implementing Classes:

SimpleCache, StagedCache, SyncCache

public interface Cache<K,V>

The base interface for a cache implementation.

Author:

Philipp Meinen

Field Summary

static int

DEFAULT_CACHE_CAPACITY The default capacity of an object cache.

Method Summary

void	add(K key, V value) Add a key-value-pair to the cache.
int	capacity()
void	clear() Remove all elements from the cache.
V	get(K key) Query a value from the cache by its key.
void	remove(K key) Remove a key-value-pair from the cache.

Field Detail

DEFAULT_CACHE_CAPACITY

static final int DEFAULT_CACHE_CAPACITY

The default capacity of an object cache.

See Also:

Constant Field Values

Method Detail

add

void add(K key,
         V value)

Add a key-value-pair to the cache.

Throws:

IllegalArgumentException - if the key is null.

get

V get(K key)

Query a value from the cache by its key.

Returns:

null if no value for the given key was found. Otherwise the value for this key.

Throws:

IllegalArgumentException - if the key is null.

remove

void remove(K key)

Remove a key-value-pair from the cache.

Throws:

IllegalArgumentException - if the key is null.

capacity

int capacity()

Returns:

the capacity of this cache.

clear

void clear()

Remove all elements from the cache.