Returns a view of the entries stored in this cache as a thread-safe map.
Returns a view of the entries stored in this cache as a thread-safe map. Modifications made to the map directly affect the cache.
a thread-safe view of this cache
Performs any pending maintenance operations needed by the cache.
Performs any pending maintenance operations needed by the cache. Exactly which activities are performed -- if any -- is implementation-dependent.
Returns the approximate number of entries in this cache.
Returns the approximate number of entries in this cache.
the estimated number of mappings
Returns the value associated with key
in this cache, obtaining that value from
loader
if necessary.
Returns the value associated with key
in this cache, obtaining that value from
loader
if necessary.
If another call to this method is currently loading the value for key
, this thread
simply waits for that thread to finish and returns its loaded value. Note that multiple threads
can concurrently load values for distinct keys.
key with which the specified value is to be associated
the current (existing or computed) value associated with the specified key
java.lang.IllegalArgumentException
if the computation detectably attempts a recursive update to this
cache that would otherwise never complete
java.lang.RuntimeException
or Error if the CacheLoader
does so, in which case the mapping
is left unestablished
java.util.concurrent.CompletionException
if a checked exception was thrown while loading the value
Returns the value associated with key
in this cache, obtaining that value from
mappingFunction
if necessary.
Returns the value associated with key
in this cache, obtaining that value from
mappingFunction
if necessary. This method provides a simple substitute for the
conventional "if cached, return; otherwise create, cache and return" pattern.
key with which the specified value is to be associated
the function to compute a value
the current (existing or computed) value associated with the specified key
java.lang.IllegalStateException
if the computation detectably attempts a recursive update to this
cache that would otherwise never complete
java.lang.RuntimeException
or Error if the mappingFunction does so, in which case the mapping is
left unestablished
Returns a map of the values associated with keys
, creating or retrieving those values
if necessary.
Returns a map of the values associated with keys
, creating or retrieving those values
if necessary. The returned map contains entries that were already cached, combined with newly
loaded entries.
the keys whose associated values are to be returned
the mapping of keys to values for the specified keys in this cache
java.lang.RuntimeException
or Error if the loader
does so
java.util.concurrent.CompletionException
if a checked exception was thrown while loading the value
Returns a map of the values associated with keys
in this cache.
Returns a map of the values associated with keys
in this cache. The returned map will
only contain entries which are already present in the cache.
the keys whose associated values are to be returned
the mapping of keys to values for the specified keys found in this cache
Returns the value associated with key
in this cache, or None
if there is no
cached value for key
.
Returns the value associated with key
in this cache, or None
if there is no
cached value for key
.
key whose associated value is to be returned
an option value containing the value to which the specified key is mapped,
or None
if this map contains no mapping for the key
Discards any cached value for key key
.
Discards any cached value for key key
.
key whose mapping is to be removed from the cache
Discards all entries in the cache.
Discards all entries in the cache.
Discards any cached values for keys keys
.
Discards any cached values for keys keys
.
the keys whose associated values are to be removed
Returns access to inspect and perform low-level operations on this cache based on its runtime characteristics.
Returns access to inspect and perform low-level operations on this cache based on its runtime characteristics. These operations are optional and dependent on how the cache was constructed and what abilities the implementation exposes.
access to inspect and perform advanced operations based on the cache's characteristics
Associates value
with key
in this cache.
Associates value
with key
in this cache. If the cache previously contained a
value associated with key
, the old value is replaced by value
.
key with which the specified value is to be associated
value to be associated with the specified key
Copies all of the mappings from the specified map to the cache.
Copies all of the mappings from the specified map to the cache.
mappings to be stored in this cache
Loads a new value for the key
, asynchronously.
Loads a new value for the key
, asynchronously. While the new value is loading the
previous value (if any) will continue to be returned by get(key)
unless it is evicted.
key with which a value may be associated
Returns a current snapshot of this cache's cumulative statistics.
Returns a current snapshot of this cache's cumulative statistics. All statistics are initialized to zero, and are monotonically increasing over the lifetime of the cache.
the current snapshot of the statistics of this cache