org.springframework.cache.annotation

Class AnnotationCacheOperationSource

java.lang.Object

org.springframework.cache.interceptor.AbstractFallbackCacheOperationSource

org.springframework.cache.annotation.AnnotationCacheOperationSource

All Implemented Interfaces:

java.io.Serializable, CacheOperationSource

public class AnnotationCacheOperationSource
extends AbstractFallbackCacheOperationSource
implements java.io.Serializable

Implementation of the CacheOperationSource interface for working with caching metadata in annotation format.

This class reads Spring's Cacheable, CachePut and CacheEvict annotations and exposes corresponding caching operation definition to Spring's cache infrastructure. This class may also serve as base class for a custom CacheOperationSource.

Since:

3.1

Author:

Costin Leau, Juergen Hoeller, Stephane Nicoll

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AnnotationCacheOperationSource.CacheOperationProvider Callback interface providing CacheOperation instance(s) based on a given CacheAnnotationParser.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Set<CacheAnnotationParser>	annotationParsers
private boolean	publicMethodsOnly

Fields inherited from class org.springframework.cache.interceptor.AbstractFallbackCacheOperationSource

logger

Constructor Summary

Constructors

Constructor and Description
AnnotationCacheOperationSource() Create a default AnnotationCacheOperationSource, supporting public methods that carry the Cacheable and CacheEvict annotations.
AnnotationCacheOperationSource(boolean publicMethodsOnly) Create a default AnnotationCacheOperationSource, supporting public methods that carry the Cacheable and CacheEvict annotations.
AnnotationCacheOperationSource(CacheAnnotationParser... annotationParsers) Create a custom AnnotationCacheOperationSource.
AnnotationCacheOperationSource(CacheAnnotationParser annotationParser) Create a custom AnnotationCacheOperationSource.
AnnotationCacheOperationSource(java.util.Set<CacheAnnotationParser> annotationParsers) Create a custom AnnotationCacheOperationSource.

Method Summary

Modifier and Type	Method and Description
protected boolean	allowPublicMethodsOnly() By default, only public methods can be made cacheable.
protected java.util.Collection<CacheOperation>	determineCacheOperations(AnnotationCacheOperationSource.CacheOperationProvider provider) Determine the cache operation(s) for the given AnnotationCacheOperationSource.CacheOperationProvider.
boolean	equals(java.lang.Object other)
protected java.util.Collection<CacheOperation>	findCacheOperations(java.lang.Class<?> clazz) Subclasses need to implement this to return the caching attribute for the given class, if any.
protected java.util.Collection<CacheOperation>	findCacheOperations(java.lang.reflect.Method method) Subclasses need to implement this to return the caching attribute for the given method, if any.
int	hashCode()

Methods inherited from class org.springframework.cache.interceptor.AbstractFallbackCacheOperationSource

getCacheKey, getCacheOperations

Methods inherited from class java.lang.Object

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

Field Detail

publicMethodsOnly

private final boolean publicMethodsOnly

annotationParsers

private final java.util.Set<CacheAnnotationParser> annotationParsers

Constructor Detail

AnnotationCacheOperationSource

public AnnotationCacheOperationSource()

Create a default AnnotationCacheOperationSource, supporting public methods that carry the Cacheable and CacheEvict annotations.

AnnotationCacheOperationSource

public AnnotationCacheOperationSource(boolean publicMethodsOnly)

Create a default AnnotationCacheOperationSource, supporting public methods that carry the Cacheable and CacheEvict annotations.

Parameters:

publicMethodsOnly - whether to support only annotated public methods typically for use with proxy-based AOP), or protected/private methods as well (typically used with AspectJ class weaving)

AnnotationCacheOperationSource

public AnnotationCacheOperationSource(CacheAnnotationParser annotationParser)

Create a custom AnnotationCacheOperationSource.

Parameters:

annotationParser - the CacheAnnotationParser to use

AnnotationCacheOperationSource

public AnnotationCacheOperationSource(CacheAnnotationParser... annotationParsers)

Create a custom AnnotationCacheOperationSource.

Parameters:

annotationParsers - the CacheAnnotationParser to use

AnnotationCacheOperationSource

public AnnotationCacheOperationSource(java.util.Set<CacheAnnotationParser> annotationParsers)

Create a custom AnnotationCacheOperationSource.

Parameters:

annotationParsers - the CacheAnnotationParser to use

Method Detail

findCacheOperations

protected java.util.Collection<CacheOperation> findCacheOperations(java.lang.Class<?> clazz)

Description copied from class: AbstractFallbackCacheOperationSource

Subclasses need to implement this to return the caching attribute for the given class, if any.

Specified by:

findCacheOperations in class AbstractFallbackCacheOperationSource

Parameters:

clazz - the class to retrieve the attribute for

Returns:

all caching attribute associated with this class (or null if none)

findCacheOperations

protected java.util.Collection<CacheOperation> findCacheOperations(java.lang.reflect.Method method)

Description copied from class: AbstractFallbackCacheOperationSource

Subclasses need to implement this to return the caching attribute for the given method, if any.

Specified by:

findCacheOperations in class AbstractFallbackCacheOperationSource

Parameters:

method - the method to retrieve the attribute for

Returns:

all caching attribute associated with this method (or null if none)

determineCacheOperations

protected java.util.Collection<CacheOperation> determineCacheOperations(AnnotationCacheOperationSource.CacheOperationProvider provider)

Determine the cache operation(s) for the given AnnotationCacheOperationSource.CacheOperationProvider.

This implementation delegates to configured CacheAnnotationParsers for parsing known annotations into Spring's metadata attribute class.

Can be overridden to support custom annotations that carry caching metadata.

Parameters:

provider - the cache operation provider to use

Returns:

the configured caching operations, or null if none found

allowPublicMethodsOnly

protected boolean allowPublicMethodsOnly()

By default, only public methods can be made cacheable.

Overrides:

allowPublicMethodsOnly in class AbstractFallbackCacheOperationSource

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object