javax.cache.expiry

Class EternalExpiryPolicy<K>

java.lang.Object

javax.cache.expiry.EternalExpiryPolicy<K>

Type Parameters:

K - the type of cache keys

All Implemented Interfaces:

Serializable, ExpiryPolicy<K>

public final class EternalExpiryPolicy<K>
extends Object
implements ExpiryPolicy<K>, Serializable

The eternal ExpiryPolicy specifies that Cache Entries won't expire. This however doesn't mean they won't be expired if an underlying implementation needs to free-up resources where by it may choose to expire entries that are not due to expire.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static long	serialVersionUID The serialVersionUID required for Serializable.

Constructor Summary

Constructors

Constructor and Description
EternalExpiryPolicy()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object other)
static <K> Factory<ExpiryPolicy<? super K>>	factoryOf() Obtains a Factory for an Eternal ExpiryPolicy.
<L extends K> Duration	getExpiryForAccessedEntry(L key) Gets the duration before the accessed Cache.Entry is considered expired.
<L extends K> Duration	getExpiryForCreatedEntry(L key) Gets the duration before the newly Cache.Entry is considered expired.
<L extends K> Duration	getExpiryForModifiedEntry(L key) Gets the duration before the modified Cache.Entry is considered expired.
int	hashCode()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

serialVersionUID

public static final long serialVersionUID

The serialVersionUID required for Serializable.

See Also:

Constant Field Values

Constructor Detail

EternalExpiryPolicy

public EternalExpiryPolicy()

Method Detail

factoryOf

public static <K> Factory<ExpiryPolicy<? super K>> factoryOf()

Obtains a Factory for an Eternal ExpiryPolicy.

Returns:

a Factory for an Eternal ExpiryPolicy.

getExpiryForCreatedEntry

public <L extends K> Duration getExpiryForCreatedEntry(L key)

Gets the duration before the newly Cache.Entry is considered expired.

This method is called by the caching implementation after a Cache.Entry is created, but before the said entry is added to a cache, to determine the Duration before the said entry expires. If a Duration.ZERO is returned the Cache.Entry is considered to be already expired and will not be added to the Cache.

Should an exception occur while determining the Duration, an implementation specific default Duration will be used.

Specified by:

getExpiryForCreatedEntry in interface ExpiryPolicy<K>

Parameters:

key - the key of the cache entry that was created

Returns:

the new duration until the entry expires

getExpiryForAccessedEntry

public <L extends K> Duration getExpiryForAccessedEntry(L key)

Gets the duration before the accessed Cache.Entry is considered expired.

This method is called by the caching implementation after a Cache.Entry is accessed to determine the Duration before the said entry expires in the future. If a Duration.ZERO is returned the Cache.Entry will be considered expired for future access. Returning null will result in no change to the previously understood expiry Duration.

Should an exception occur while determining the Duration, an implementation specific default Duration will be used.

Specified by:

getExpiryForAccessedEntry in interface ExpiryPolicy<K>

Parameters:

key - the key of the cache entry that was accessed

Returns:

the new duration until the entry expires

getExpiryForModifiedEntry

public <L extends K> Duration getExpiryForModifiedEntry(L key)

Gets the duration before the modified Cache.Entry is considered expired.

This method is called by the caching implementation after a Cache.Entry is modified to determine the Duration before the updated entry expires. If a Duration.ZERO is returned the Cache.Entry is considered already expired. Returning null will result in no change to the previously understood expiry Duration.

Should an exception occur while determining the Duration, an implementation specific default Duration will be used.

Specified by:

getExpiryForModifiedEntry in interface ExpiryPolicy<K>

Parameters:

key - the key of the cache entry that was modified

Returns:

the new duration until the entry expires

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object