此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Framework 6.2.0! |
JCache (JSR-107) 注解
从 4.1 版开始, Spring 的缓存抽象完全支持 JCache 标准
(JSR-107) 注释:@CacheResult
,@CachePut
,@CacheRemove
和@CacheRemoveAll
以及@CacheDefaults
,@CacheKey
和@CacheValue
同伴。
即使不将缓存存储迁移到 JSR-107,也可以使用这些注释。
内部实现使用 Spring 的缓存抽象,并提供默认的CacheResolver
和KeyGenerator
符合
规范。换句话说,如果您已经在使用 Spring 的缓存抽象,
您可以切换到这些标准注释,而无需更改缓存存储
(或配置)。
功能摘要
对于那些熟悉 Spring 缓存 Comments 的人来说,下表 描述了 Spring 注解与其 JSR-107 之间的主要区别 同行:
Spring | JSR-107 规范 | 备注 |
---|---|---|
|
|
相当相似。 |
|
|
虽然 Spring 使用方法调用的结果更新缓存,但 JCache
要求将其作为参数传递,该参数带有 |
|
|
相当相似。 |
|
|
看 |
|
|
允许您以类似的方式配置相同的概念。 |
JCache 有javax.cache.annotation.CacheResolver
,它是相同的
到 Spring 的CacheResolver
接口,但 JCache 仅支持单个
缓存。默认情况下,一个简单的实现会根据
name 声明的 NAME 的注释。需要注意的是,如果没有缓存名称是
在注释上指定,则会自动生成默认值。请参阅 javadoc
之@CacheResult#cacheName()
了解更多信息。
CacheResolver
实例由CacheResolverFactory
.这是可能的
为每个缓存作自定义工厂,如下例所示:
@CacheResult(cacheNames="books", cacheResolverFactory=MyCacheResolverFactory.class) (1)
public Book findBook(ISBN isbn)
1 | 为此作自定义工厂。 |
对于所有引用的类, Spring 尝试查找具有给定类型的 bean。 如果存在多个匹配项,则会创建一个新实例,并且可以使用常规的 Bean 生命周期回调,例如依赖项注入。 |
键由javax.cache.annotation.CacheKeyGenerator
为
与 Spring 的KeyGenerator
.默认情况下,所有方法参数都被采用
到帐户中,除非至少有一个参数被注释为@CacheKey
.这是
类似于 Spring 的 custom key generation declaration 。例如,以下是相同的作,一个使用
Spring 的抽象和另一个使用 JCache 的抽象:
@Cacheable(cacheNames="books", key="#isbn")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)
@CacheResult(cacheName="books")
public Book findBook(@CacheKey ISBN isbn, boolean checkWarehouse, boolean includeUsed)
您还可以指定CacheKeyResolver
在作上,类似于您可以
指定CacheResolverFactory
.
JCache 可以管理带注释的方法引发的异常。这可以防止
缓存,但它也可以缓存异常作为失败的指示器,而不是
再次调用该方法。假设InvalidIsbnNotFoundException
如果
ISBN 的结构无效。这是一个永久性的失败(没有一本书可能是
使用此类参数检索)。以下内容缓存异常,以便进一步
具有相同无效 ISBN 的调用直接引发缓存的异常,而不是
再次调用该方法:
@CacheResult(cacheName="books", exceptionCacheName="failures"
cachedExceptions = InvalidIsbnNotFoundException.class)
public Book findBook(ISBN isbn)
启用 JSR-107 支持
您无需执行任何特定作即可启用 JSR-107 支持以及 Spring 的
声明性注释支持。双@EnableCaching
和cache:annotation-driven
如果 JSR-107 API 和spring-context-support
module 都存在于 Classpath 中。
根据您的使用案例,选择权基本上在您手中。您甚至可以混合和 通过在某些服务上使用 JSR-107 API 并在 Spring 上使用 Spring 自己的注释来匹配服务 别人。但是,如果这些服务影响相同的缓存,则应使用一致的 和相同的密钥生成实现。 |