org.cache2k.integration

Interface ExceptionInformation

public interface ExceptionInformation

Relevant information of load attempt that generated an exception. This is used by the exception propagator and the resilience policy.

Compatibility: This interface is not intended for implementation or extension by a client and may get additional methods in a new minor release.

Rationale: The information does not contain the time of the original expiry of the cache value. This is intentional. There is no information field to record the time of expiry past the expiry itself. The expiry time information is reset as soon as the expiry time is reached. To produce no overhead, the information provided by this interface is captured only in case an exception happens.

Author:

Jens Wilke

See Also:

ExceptionPropagator, ResiliencePolicy

Method Summary

Modifier and Type	Method and Description
Throwable	getException() The original exception generated by the last recent loader call.
long	getLoadTime() Start time of the load operation that generated the recent exception.
int	getRetryCount() Number of retry attempts to load the value for the requested key.
long	getSinceTime() Start time of the load that generated the first exception.
long	getUntil() Time in millis until the next retry attempt.

Method Detail

getException

Throwable getException()

The original exception generated by the last recent loader call.

getRetryCount

int getRetryCount()

Number of retry attempts to load the value for the requested key. The value is starting 0 for the first load attempt that yields an exception. The counter is incremented for each consecutive loader exception. After a successful attempt to load the value the counter is reset.

Returns:

counter starting at 0 for the first load attempt that yields an exception.

getSinceTime

long getSinceTime()

Start time of the load that generated the first exception.

Returns:

time in millis since epoch

getLoadTime

long getLoadTime()

Start time of the load operation that generated the recent exception.

Returns:

time in millis since epoch

getUntil

long getUntil()

Time in millis until the next retry attempt. This property is only set in the context of the ExceptionPropagator.

Returns:

time in millis since epoch