程序包 cn.taketoday.cache.annotation

Annotation Interface Cacheable

@Target({TYPE,METHOD}) @Retention(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 EL 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 target method will be invoked and the returned value will be stored in the associated cache. Note that Optional return types are unwrapped automatically. If an Optional value is present, it will be stored in the associated cache. If an Optional value is not present, null will be stored in the associated cache.

This annotation may be used as a meta-annotation to create custom composed annotations with attribute overrides.

从以下版本开始:
4.0
作者:
Costin Leau, Phillip Webb, Stephane Nicoll, Sam Brannen
另请参阅:

  • 元素详细资料

    • value

      @AliasFor("cacheNames") String[] value
      Alias for cacheNames().
      默认值:
      {}

    • cacheNames

      @AliasFor("value") 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.

      从以下版本开始:
      4.0
      另请参阅:
      默认值:
      {}

    • key

      String key
      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.

      The EL expression evaluates against a dedicated context that provides the following meta-data:

      • #root.method, #root.target, and #root.caches for references to the method, target object, and affected cache(s) respectively.
      • Shortcuts for the method name (#root.methodName) and target class (#root.targetClass) are also available.
      • Method arguments can be accessed by index. For instance the second argument can be accessed via #root.args[1], #p1 or #a1. Arguments can also be accessed by name if that information is available.
      默认值:
      ""

    • keyGenerator

      String keyGenerator
      The bean name of the custom KeyGenerator to use.

      Mutually exclusive with the key() attribute.

      另请参阅:
      默认值:
      ""

    • cacheManager

      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.

      另请参阅:
      默认值:
      ""

    • cacheResolver

      String cacheResolver
      The bean name of the custom CacheResolver to use.
      另请参阅:
      默认值:
      ""

    • condition

      String condition
      Expression Language (SpEL) expression used for making the method caching conditional. Cache the result if the condition evaluates to true.

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

      The SpEL expression evaluates against a dedicated context that provides the following meta-data:

      • #root.method, #root.target, and #root.caches for references to the method, target object, and affected cache(s) respectively.
      • Shortcuts for the method name (#root.methodName) and target class (#root.targetClass) are also available.
      • Method arguments can be accessed by index. For instance the second argument can be accessed via #root.args[1], #p1 or #a1. Arguments can also be accessed by name if that information is available.
      默认值:
      ""

    • unless

      String unless
      Expression Language (SpEL) expression used to veto method caching. Veto caching the result if the condition evaluates to true.

      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.

      The EL expression evaluates against a dedicated context that provides the following meta-data:

      • #result for a reference to the result of the method invocation. For supported wrappers such as Optional, #result refers to the actual object, not the wrapper
      • #root.method, #root.target, and #root.caches for references to the method, target object, and affected cache(s) respectively.
      • Shortcuts for the method name (#root.methodName) and target class (#root.targetClass) are also available.
      • Method arguments can be accessed by index. For instance the second argument can be accessed via #root.args[1], #p1 or #a1. Arguments can also be accessed by name if that information is available.
      从以下版本开始:
      4.0
      默认值:
      ""

    • sync

      boolean sync
      Synchronize the invocation of the underlying method if several threads are attempting to load a value for the same key. The synchronization leads to a couple of limitations:
      1. unless() is not supported
      2. Only one cache may be specified
      3. No other cache-related operation can be combined
      This is effectively a hint and the actual cache provider that you are using may not support it in a synchronized fashion. Check your provider documentation for more details on the actual semantics.
      从以下版本开始:
      4.0
      另请参阅:
      默认值:
      false