software.amazon.jdbc.util

Class SlidingExpirationCache<K,V>

java.lang.Object

software.amazon.jdbc.util.SlidingExpirationCache<K,V>

public class SlidingExpirationCache<K,V>
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SlidingExpirationCache.ItemDisposalFunc<V> An optional function defining extra cleanup steps to take when a cache item is cleaned up.
static interface	SlidingExpirationCache.ShouldDisposeFunc<V> An optional function defining the conditions under which an expired entry should be cleaned up at cleanup time.

Constructor Summary

Constructors

Constructor and Description
SlidingExpirationCache() A cache that periodically cleans up expired entries.
SlidingExpirationCache(SlidingExpirationCache.ShouldDisposeFunc<V> shouldDisposeFunc, SlidingExpirationCache.ItemDisposalFunc<V> itemDisposalFunc) A cache that periodically cleans up expired entries.

Method Summary

Modifier and Type	Method and Description
void	clear() Remove and dispose of all entries in the cache.
V	computeIfAbsent(K key, java.util.function.Function<? super K,? extends V> mappingFunction, long itemExpirationNano) In addition to performing the logic defined by Map.computeIfAbsent(K, java.util.function.Function<? super K, ? extends V>), cleans up expired entries if we have hit cleanup time.
java.util.Map<K,V>	getEntries() Get a map copy of all entries in the cache, including expired entries.
void	remove(K key) Cleanup expired entries if we have hit the cleanup time, then remove and dispose the value associated with the given key.
void	setCleanupIntervalNanos(long cleanupIntervalNanos) Set the cleanup interval for the cache.
int	size() Get the current size of the cache, including expired entries.

Methods inherited from class java.lang.Object

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

Constructor Detail

SlidingExpirationCache

public SlidingExpirationCache()

A cache that periodically cleans up expired entries. Fetching an expired entry marks that entry as not-expired and renews its expiration time.

SlidingExpirationCache

public SlidingExpirationCache(SlidingExpirationCache.ShouldDisposeFunc<V> shouldDisposeFunc,
                              SlidingExpirationCache.ItemDisposalFunc<V> itemDisposalFunc)

A cache that periodically cleans up expired entries. Fetching an expired entry marks that entry as not-expired and renews its expiration time.

Parameters:

shouldDisposeFunc - a function defining the conditions under which an expired entry should be cleaned up when we hit the cleanup time

itemDisposalFunc - a function that will be called on any item that meets the cleanup criteria at cleanup time. The criteria for cleanup is that the item is both expired and marked for cleanup via a call to shouldDisposeFunc.

Method Detail

computeIfAbsent

public V computeIfAbsent(K key,
                         java.util.function.Function<? super K,? extends V> mappingFunction,
                         long itemExpirationNano)

In addition to performing the logic defined by Map.computeIfAbsent(K, java.util.function.Function<? super K, ? extends V>), cleans up expired entries if we have hit cleanup time. If an expired entry is requested and we have not hit cleanup time or SlidingExpirationCache.ShouldDisposeFunc indicated the entry should not be closed, the entry will be marked as non-expired.

Parameters:

key - the key with which the specified value is to be associated

mappingFunction - the function to compute a value

itemExpirationNano - the expiration time of the new or renewed entry

Returns:

the current (existing or computed) value associated with the specified key, or null if the computed value is null

remove

public void remove(K key)

Cleanup expired entries if we have hit the cleanup time, then remove and dispose the value associated with the given key.

Parameters:

key - the key associated with the value to be removed/disposed

clear

public void clear()

Remove and dispose of all entries in the cache.

getEntries

public java.util.Map<K,V> getEntries()

Get a map copy of all entries in the cache, including expired entries.

Returns:

a map copy of all entries in the cache, including expired entries

size

public int size()

Get the current size of the cache, including expired entries.

Returns:

the current size of the cache, including expired entries.

setCleanupIntervalNanos

public void setCleanupIntervalNanos(long cleanupIntervalNanos)

Set the cleanup interval for the cache. At cleanup time, expired entries marked for cleanup via SlidingExpirationCache.ShouldDisposeFunc (if defined) are disposed.

Parameters:

cleanupIntervalNanos - the time interval defining when we should clean up expired entries marked for cleanup, in nanoseconds