org.cache2k

Interface CacheOperationCompletionListener

All Superinterfaces:

EventListener

public interface CacheOperationCompletionListener
extends EventListener

A listener implemented by the cache client to get notification about the completion of a load or prefetch operation.

Author:

Jens Wilke

See Also:

Cache.loadAll(Iterable, CacheOperationCompletionListener), AdvancedKeyValueSource.prefetchAll(Iterable, CacheOperationCompletionListener)

Method Summary

Modifier and Type	Method and Description
void	onCompleted() Signals the completion of a Cache.loadAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener), Cache.reloadAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener) or Cache.prefetchAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener) operation.
void	onException(Throwable exception) The operation could not completed, because of an error.

Method Detail

onCompleted

void onCompleted()

Signals the completion of a Cache.loadAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener), Cache.reloadAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener) or Cache.prefetchAll(java.lang.Iterable<? extends K>, org.cache2k.CacheOperationCompletionListener) operation.

onException

void onException(Throwable exception)

The operation could not completed, because of an error.

In the current implementation, there is no condition which raises a call to this method. Errors while loading a value, will be delayed and propagated when the respective key is accessed. This is subject to the resilience configuration.

The method may be used in the future for some general failure condition during load. Applications should propagate the exception properly and not only log it.