此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Framework 6.2.0spring-doc.cadn.net.cn

JCache (JSR-107) 注解

从 4.1 版开始, Spring 的缓存抽象完全支持 JCache 标准 (JSR-107) 注释:@CacheResult,@CachePut,@CacheRemove@CacheRemoveAll以及@CacheDefaults,@CacheKey@CacheValue同伴。 即使不将缓存存储迁移到 JSR-107,也可以使用这些注释。 内部实现使用 Spring 的缓存抽象,并提供默认的CacheResolverKeyGenerator符合 规范。换句话说,如果您已经在使用 Spring 的缓存抽象, 您可以切换到这些标准注释,而无需更改缓存存储 (或配置)。spring-doc.cadn.net.cn

功能摘要

对于那些熟悉 Spring 缓存 Comments 的人来说,下表 描述了 Spring 注解与其 JSR-107 之间的主要区别 同行:spring-doc.cadn.net.cn

表 1.Spring 与 JSR-107 缓存注释
Spring JSR-107 规范 备注

@Cacheablespring-doc.cadn.net.cn

@CacheResultspring-doc.cadn.net.cn

相当相似。@CacheResult可以缓存特定的异常并强制 执行该方法,而不考虑缓存的内容。spring-doc.cadn.net.cn

@CachePutspring-doc.cadn.net.cn

@CachePutspring-doc.cadn.net.cn

虽然 Spring 使用方法调用的结果更新缓存,但 JCache 要求将其作为参数传递,该参数带有@CacheValue. 由于这种差异, JCache 允许在 实际方法调用。spring-doc.cadn.net.cn

@CacheEvictspring-doc.cadn.net.cn

@CacheRemovespring-doc.cadn.net.cn

相当相似。@CacheRemove支持条件驱逐,当 方法调用会导致异常。spring-doc.cadn.net.cn

@CacheEvict(allEntries=true)spring-doc.cadn.net.cn

@CacheRemoveAllspring-doc.cadn.net.cn

@CacheRemove.spring-doc.cadn.net.cn

@CacheConfigspring-doc.cadn.net.cn

@CacheDefaultsspring-doc.cadn.net.cn

允许您以类似的方式配置相同的概念。spring-doc.cadn.net.cn

JCache 有javax.cache.annotation.CacheResolver,它是相同的 到 Spring 的CacheResolver接口,但 JCache 仅支持单个 缓存。默认情况下,一个简单的实现会根据 name 声明的 NAME 的注释。需要注意的是,如果没有缓存名称是 在注释上指定,则会自动生成默认值。请参阅 javadoc 之@CacheResult#cacheName()了解更多信息。spring-doc.cadn.net.cn

CacheResolver实例由CacheResolverFactory.这是可能的 为每个缓存作自定义工厂,如下例所示:spring-doc.cadn.net.cn

@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 的抽象:spring-doc.cadn.net.cn

@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.spring-doc.cadn.net.cn

JCache 可以管理带注释的方法引发的异常。这可以防止 缓存,但它也可以缓存异常作为失败的指示器,而不是 再次调用该方法。假设InvalidIsbnNotFoundException如果 ISBN 的结构无效。这是一个永久性的失败(没有一本书可能是 使用此类参数检索)。以下内容缓存异常,以便进一步 具有相同无效 ISBN 的调用直接引发缓存的异常,而不是 再次调用该方法:spring-doc.cadn.net.cn

@CacheResult(cacheName="books", exceptionCacheName="failures"
			cachedExceptions = InvalidIsbnNotFoundException.class)
public Book findBook(ISBN isbn)

启用 JSR-107 支持

您无需执行任何特定作即可启用 JSR-107 支持以及 Spring 的 声明性注释支持。双@EnableCachingcache:annotation-driven如果 JSR-107 API 和spring-context-supportmodule 都存在于 Classpath 中。spring-doc.cadn.net.cn

根据您的使用案例,选择权基本上在您手中。您甚至可以混合和 通过在某些服务上使用 JSR-107 API 并在 Spring 上使用 Spring 自己的注释来匹配服务 别人。但是,如果这些服务影响相同的缓存,则应使用一致的 和相同的密钥生成实现。

APP信息