org.jsr107.ri.annotations

Class AbstractCacheResultInterceptor<I>

java.lang.Object

org.jsr107.ri.annotations.AbstractCacheInterceptor<I>

org.jsr107.ri.annotations.AbstractKeyedCacheInterceptor<I,CacheResultMethodDetails>

org.jsr107.ri.annotations.AbstractCacheResultInterceptor<I>

Type Parameters:

I - The intercepted method invocation

public abstract class AbstractCacheResultInterceptor<I>
extends AbstractKeyedCacheInterceptor<I,CacheResultMethodDetails>

Interceptor for CacheResult

Since:

1.0

Author:

Rick Hightower, Eric Dalquist

Constructor Summary

Constructors

Constructor and Description
AbstractCacheResultInterceptor()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	cacheException(Cache<Object,Throwable> exceptionCache, GeneratedCacheKey cacheKey, CacheResult cacheResultAnnotation, Throwable t) Cache the exception if exception caching is enabled.
Object	cacheResult(CacheContextSource<I> cacheContextSource, I invocation) Handles the Cache.get(Object) and Cache.put(Object, Object) logic as specified for the CacheResult annotation
protected void	checkForCachedException(Cache<Object,Throwable> exceptionCache, GeneratedCacheKey cacheKey) Check to see if there is a cached exception that needs to be re-thrown
protected Cache<Object,Throwable>	getExceptionCache(InternalCacheKeyInvocationContext<? extends Annotation> cacheKeyInvocationContext, CacheResultMethodDetails methodDetails) Get the exception cache if one is configured

Methods inherited from class org.jsr107.ri.annotations.AbstractKeyedCacheInterceptor

getStaticCacheKeyInvocationContext

Methods inherited from class org.jsr107.ri.annotations.AbstractCacheInterceptor

proceed

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractCacheResultInterceptor

public AbstractCacheResultInterceptor()

Method Detail

cacheResult

public final Object cacheResult(CacheContextSource<I> cacheContextSource,
                 I invocation)
                         throws Throwable

Handles the Cache.get(Object) and Cache.put(Object, Object) logic as specified for the CacheResult annotation

Parameters:

cacheContextSource - The intercepted invocation

invocation - The intercepted invocation

Returns:

The result from AbstractCacheInterceptor.proceed(Object)

Throws:

Throwable - if AbstractCacheInterceptor.proceed(Object) threw

checkForCachedException

protected void checkForCachedException(Cache<Object,Throwable> exceptionCache,
                           GeneratedCacheKey cacheKey)
                                throws Throwable

Check to see if there is a cached exception that needs to be re-thrown

Parameters:

exceptionCache - The exception cache, may be null if no exception caching is being done

cacheKey - The cache key

Throws:

Throwable - The cached exception

cacheException

protected void cacheException(Cache<Object,Throwable> exceptionCache,
                  GeneratedCacheKey cacheKey,
                  CacheResult cacheResultAnnotation,
                  Throwable t)

Cache the exception if exception caching is enabled.

Parameters:

exceptionCache - The exception cache, may be null if no exception caching is being done

cacheKey - The cache key

cacheResultAnnotation - The cache result annotation

t - The exception to cache

getExceptionCache

protected Cache<Object,Throwable> getExceptionCache(InternalCacheKeyInvocationContext<? extends Annotation> cacheKeyInvocationContext,
                                        CacheResultMethodDetails methodDetails)

Get the exception cache if one is configured

Parameters:

cacheKeyInvocationContext - The invocation details

methodDetails - The method details

Returns:

The exception cache, null if exception caching is disabled.