org.cache2k.integration

Class CacheLoaderException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.cache2k.CacheException

org.cache2k.CustomizationException

org.cache2k.integration.CacheLoaderException

All Implemented Interfaces:

Serializable

public class CacheLoaderException
extends CustomizationException

Exception to wrap a loader exception. When an exception is thrown by the loader and rethrown to the application it is wrapped in this exception.

It is possible to register a custom behavior how exceptions are rethrown (propagated) with the ExceptionPropagator.

A single loader exception may be thrown multiple times to the application, if the exception is cached. On the other hand, it is possible to suppress a loader exception if the cache still contains data. This is controlled by the ResiliencePolicy or various configuration parameters (see the references). In case a cached exception is thrown, it contains the string expiry=<timestamp>

As a general rule, throwing this exception is delayed as long as possible, when an associated value for a specific key is requested that has caused the exception. For example Cache.getEntry(K) will not throw this exception but CacheEntry.getValue() will. For bulk methods for example Cache.getAll(java.lang.Iterable<? extends K>) the exception will be thrown when the respective value is accessed from the returned map. In case of a general error, for example the loader produces an exception for every key, exceptions may be thrown as soon as possible (fail fast principle).

Author:

Jens Wilke

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CacheLoaderException(String _message, Throwable ex)
CacheLoaderException(Throwable ex)

Method Summary

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

CacheLoaderException

public CacheLoaderException(String _message,
                            Throwable ex)

CacheLoaderException

public CacheLoaderException(Throwable ex)