org.cache2k

Interface CacheEntry<K,V>

All Known Subinterfaces:

MutableCacheEntry<K,V>

public interface CacheEntry<K,V>

Object representing a cache entry. With the cache entry, it can be checked whether a mapping in the cache is present, even if the cache contains null or contains an exception. Entries can be retrieved by Cache.peekEntry(Object) or Cache.getEntry(Object) or via iterated via Cache.entries().

After retrieved, the entry instance does not change its values, even if the value for its key is updated in the cache.

Design note: The cache is generally also aware of the time the object will be refreshed next or when it will expire. This is not exposed to applications by intention.

Author:

Jens Wilke

See Also:

Cache.peekEntry(Object), Cache.getEntry(Object), Cache.entries()

Method Summary

Modifier and Type	Method and Description
Throwable	getException() The exception happened when the value was loaded and the exception could not be suppressed.
K	getKey() Key associated with this entry.
long	getLastModification() Time in millis the entry was last modified.
V	getValue() Value of the entry.

Method Detail

getKey

K getKey()

Key associated with this entry.

getValue

V getValue()

Value of the entry. The value may be null if nulls are permitted. If the entry had a loader exception which is not suppressed, this exception will be propagated.

Throws:

CacheLoaderException - if the loading produced an exception .

getException

Throwable getException()

The exception happened when the value was loaded and the exception could not be suppressed. null if no exception happened or it was suppressed. If null then getValue() returns a value and does not throw an exception.

getLastModification

long getLastModification()

Time in millis the entry was last modified.