Class BoundedLocalCache.BoundedLocalAsyncLoadingCache.AsyncLoader<K,V>

java.lang.Object

com.github.benmanes.caffeine.cache.BoundedLocalCache.BoundedLocalAsyncLoadingCache.AsyncLoader<K,V>

All Implemented Interfaces:

AsyncCacheLoader<K,V>, CacheLoader<K,V>

Enclosing class:

BoundedLocalCache.BoundedLocalAsyncLoadingCache<K,V>

static final class BoundedLocalCache.BoundedLocalAsyncLoadingCache.AsyncLoader<K,V>
extends Object
implements CacheLoader<K,V>

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final Executor	executor
(package private) final AsyncCacheLoader<? super K, V>	loader

Constructor Summary

Constructors

Constructor	Description
AsyncLoader(AsyncCacheLoader<? super K, V> loader, Caffeine<?,?> builder)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<V>	asyncReload(K key, V oldValue, Executor executor)	Asynchronously computes or retrieves a replacement value corresponding to an already-cached key.
V	load(K key)	Computes or retrieves the value corresponding to key.
V	reload(K key, V oldValue)	Computes or retrieves a replacement value corresponding to an already-cached key.

Methods inherited from class Object

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

Methods inherited from interface CacheLoader

asyncLoad, asyncLoadAll, loadAll

Field Details

loader

final AsyncCacheLoader<? super K, V> loader

executor

final Executor executor

Constructor Details

AsyncLoader

AsyncLoader(AsyncCacheLoader<? super K, V> loader,
 Caffeine<?,?> builder)

Method Details

load

public V load(K key)

Description copied from interface: CacheLoader

Computes or retrieves the value corresponding to key.

Warning: loading must not attempt to update any mappings of this cache directly.

Specified by:

load in interface CacheLoader<K,V>

Parameters:

key - the non-null key whose value should be loaded

Returns:

the value associated with key or null if not found

reload

public V reload(K key,
 V oldValue)

Description copied from interface: CacheLoader

Computes or retrieves a replacement value corresponding to an already-cached key. If the replacement value is not found then the mapping will be removed if null is returned. This method is called when an existing cache entry is refreshed by Caffeine.refreshAfterWrite(Duration), or through a call to LoadingCache.refresh(K).

Note: all exceptions thrown by this method will be logged and then swallowed.

Specified by:

reload in interface CacheLoader<K,V>

Parameters:

key - the non-null key whose value should be loaded

oldValue - the non-null old value corresponding to key

Returns:

the new value associated with key, or null if the mapping is to be removed

asyncReload

public CompletableFuture<V> asyncReload(K key,
 V oldValue,
 Executor executor)

Description copied from interface: CacheLoader

Asynchronously computes or retrieves a replacement value corresponding to an already-cached key. If the replacement value is not found then the mapping will be removed if null is computed. This method is called when an existing cache entry is refreshed by Caffeine.refreshAfterWrite(Duration), or through a call to LoadingCache.refresh(K).

Note: all exceptions thrown by this method will be logged and then swallowed.

Specified by:

asyncReload in interface AsyncCacheLoader<K,V>

Specified by:

asyncReload in interface CacheLoader<K,V>

Parameters:

key - the non-null key whose value should be loaded

oldValue - the non-null old value corresponding to key

executor - the executor with which the entry is asynchronously loaded

Returns:

a future containing the new value associated with key, or containing null if the mapping is to be removed