- Companion:
- object
Value members
Concrete methods
Returns a view of the entries stored in this cache as a thread-safe map. Modifications made to the map directly affect the cache.
Returns a view of the entries stored in this cache as a thread-safe map. Modifications made to the map directly affect the cache.
- Returns:
a thread-safe view of this cache
Performs any pending maintenance operations needed by the cache. Exactly which activities are performed -- if any -- is implementation-dependent.
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.
- Returns:
the estimated number of mappings
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.
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.
- Value parameters:
- key
key with which the specified value is to be associated
- mappingFunction
the function to compute a value
- Returns:
the current (existing or computed) value associated with the specified key
- Throws:
- 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 the future of 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.
Returns the future of 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.
A single request to the mappingFunction
is performed for all keys which
are not already present in the cache.
- Value parameters:
- keys
the keys whose associated values are to be returned
- mappingFunction
the function to compute the values
- Returns:
an unmodifiable mapping of keys to values for the specified keys in this cache
- Throws:
- 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
in this cache. The
returned map will only contain entries which are already present in the
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.
- Value parameters:
- keys
the keys whose associated values are to be returned
- Returns:
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
.
- Value parameters:
- key
key whose associated value is to be returned
- Returns:
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
.
- Value parameters:
- key
key whose mapping is to be removed from the cache
Discards any cached values for keys keys
.
Discards any cached values for keys keys
.
- Value parameters:
- 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. These operations are optional and dependent on how the cache was constructed and what abilities the implementation exposes.
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.
- Returns:
access to inspect and perform advanced operations based on the cache's characteristics
Associates value
with key
in this cache. If the cache previously
contained a value associated with key
, the old value is replaced by
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
.
- Value parameters:
- key
key with which the specified value is to be associated
- value
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.
- Value parameters:
- map
mappings to be stored in this cache
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.
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.
- Returns:
the current snapshot of the statistics of this cache