org.springframework.cache.annotation

Annotation Type Cacheable

@Target(value={METHOD,TYPE})
 @Retention(value=RUNTIME)
 @Inherited
 @Documented
public @interface Cacheable

Annotation indicating that the result of invoking a method (or all methods in a class) can be cached.

Each time an advised method is invoked, caching behavior will be applied, checking whether the method has been already invoked for the given arguments. A sensible default simply uses the method parameters to compute the key, but a SpEL expression can be provided via the key() attribute, or a custom KeyGenerator implementation can replace the default one (see keyGenerator()).

If no value is found in the cache for the computed key, the method is invoked and the returned value is used as the cache value.

Since:

3.1

Author:

Costin Leau, Phillip Webb, Stephane Nicoll, Sam Brannen

See Also:

CacheConfig

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	cacheManager The bean name of the custom CacheManager to use to create a default CacheResolver if none is set already.
String[]	cacheNames Names of the caches in which method invocation results are stored.
String	cacheResolver The bean name of the custom CacheResolver to use.
String	condition Spring Expression Language (SpEL) expression used for making the method caching conditional.
String	key Spring Expression Language (SpEL) expression for computing the key dynamically.
String	keyGenerator The bean name of the custom KeyGenerator to use.
String	unless Spring Expression Language (SpEL) expression used to veto method caching.
String[]	value Alias for cacheNames().

Element Detail

value

@AliasFor(value="cacheNames")
public abstract String[] value

Alias for cacheNames().

Default:

{}

cacheNames

@AliasFor(value="value")
public abstract String[] cacheNames

Names of the caches in which method invocation results are stored.

Names may be used to determine the target cache (or caches), matching the qualifier value or bean name of a specific bean definition.

Since:

4.2

See Also:

value(), CacheConfig.cacheNames()

Default:

{}

key

public abstract String key

Spring Expression Language (SpEL) expression for computing the key dynamically.

Default is "", meaning all method parameters are considered as a key, unless a custom keyGenerator() has been configured.

Default:

""

keyGenerator

public abstract String keyGenerator

The bean name of the custom KeyGenerator to use.

Mutually exclusive with the key() attribute.

See Also:

CacheConfig.keyGenerator()

Default:

""

cacheManager

public abstract String cacheManager

The bean name of the custom CacheManager to use to create a default CacheResolver if none is set already.

Mutually exclusive with the cacheResolver() attribute.

See Also:

SimpleCacheResolver, CacheConfig.cacheManager()

Default:

""

cacheResolver

public abstract String cacheResolver

The bean name of the custom CacheResolver to use.

See Also:

CacheConfig.cacheResolver()

Default:

""

condition

public abstract String condition

Spring Expression Language (SpEL) expression used for making the method caching conditional.

Default is "", meaning the method result is always cached.

Default:

""

unless

public abstract String unless

Spring Expression Language (SpEL) expression used to veto method caching.

Unlike condition(), this expression is evaluated after the method has been called and can therefore refer to the result.

Default is "", meaning that caching is never vetoed.

Since:

3.2

Default:

""