Interface Cache<K,V>
-
- Type Parameters:
K- The type of the key.V- The type of the value.
public interface Cache<K,V>
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description booleancontains(K key)ReturnsTrueif the cache contains a entry with the key, orFalseif there is none.Optional<V>get(K key)Returns the value associated withkeyin this cache, or empty if there is no cached value forkey.booleanisEmpty()ReturnsTrueif the cache is empty, orFalseif there's at least a entry stored in cache.voidput(K key, V value)Associates value with key in this cache.voidremove(K key)Discards any cached value for this key.voidremoveAll()Discards all entries in the cache.longsize()Returns the number of entries in this cache.CacheStatsstats()Returns a current snapshot of this cache's cumulative statistics, or a set of default values if the cache is not recording statistics.
-
-
-
Method Detail
-
put
void put(K key, V value)
Associates value with key in this cache.
If the cache previously contained a value associated with key, the old value is replaced by value.- Parameters:
key- The key to be used as index.value- The value to be stored.
-
get
Optional<V> get(K key)
Returns the value associated withkeyin this cache, or empty if there is no cached value forkey.- Parameters:
key- The key to look for.- Returns:
- The value stored in cache if present.
-
remove
void remove(K key)
Discards any cached value for this key.- Parameters:
key- The key to be discarded.
-
removeAll
void removeAll()
Discards all entries in the cache.
-
contains
boolean contains(K key)
ReturnsTrueif the cache contains a entry with the key, orFalseif there is none.- Parameters:
key- The key to be verified.- Returns:
Trueif the key is present.
-
size
long size()
Returns the number of entries in this cache.- Returns:
- The cache size.
-
isEmpty
boolean isEmpty()
ReturnsTrueif the cache is empty, orFalseif there's at least a entry stored in cache.- Returns:
Trueif is empty.
-
stats
CacheStats stats()
Returns a current snapshot of this cache's cumulative statistics, or a set of default values if the cache is not recording statistics. All statistics begin at zero and never decrease over the lifetime of the cache.
-
-