002-spring cache 基于注解的缓存-01-关键注解概述、spel、缓存Key 与 缓存解析器

一、简述

1.1、基础概念、缓存注解

1.2、三个操作缓存注解@Cacheable/@CachePut/@CacheEvict 主要的参数

1.3、上述注解会有条件-SpEL上下文数据

　　Spring Cache提供了一些供我们使用的SpEL上下文数据，下表直接摘自Spring官方文档： 

注意：

　　1.当我们要使用root对象的属性作为key时我们也可以将“#root”省略，因为Spring默认使用的就是root对象的属性。 如

　　@Cacheable(key = "targetClass + methodName +#p0")

　　2.使用方法参数时我们可以直接使用“#参数名”或者“#p参数index”。 如：

　　@Cacheable(value="users", key="#id")

　　@Cacheable(value="users", key="#p0")

 SpEL提供了多种运算符

二、缓存Key 与 缓存解析器

2.1、缓存Key说明

2.1.1、默认Key生成

　　由于缓存本质上是键值存储，因此每次缓存方法的调用都需要转换为适合缓存访问的key。抽象缓存使用一个简单的基于以下算法KeyGenerator：

如果没有给出参数，则返回SimpleKey.EMPTY。 
如果只给出一个参数，则返回该实例。
如果给出了多于一个参数，返回一个包含所有参数的SimpleKey。

　　这种方法适用于大多数使用情况;只要参数具有自然键并实现有效的hashCode（）和equals（）方法。如果情况并非如此，那么战略需要改变。

　　为了提供不同的默认key生成器，需要实现org.springframework.cache.interceptor.KeyGenerator接口。

　　注意：默认的key生成策略随着Spring 4.0的发布而改变。 Spring的早期版本使用了一种key生成策略，对于多个关键参数，只考虑参数的hashCode（）而不考虑equals（）;这可能会导致意外的键碰撞（请参阅SPR-10237的背景）。新的'SimpleKeyGenerator'使用复合键来实现这种场景。

　　如果您想继续使用以前的key策略，则可以配置弃用的org.springframework.cache.interceptor.DefaultKeyGenerator类或创建基于散列的自定义“KeyGenerator”实现。

2.1.2、自定义key生成策略

　　由于缓存是通用的，因此目标方法很可能具有不能简单映射到缓存结构顶部的各种签名。当目标方法有多个参数，其中只有一些适用于缓存（而其余的仅由方法逻辑使用）时，这会变得很明显。例如：

@Cacheable("books")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

　　对于这种情况，@Cacheable注解允许用户指定如何通过其关键属性生成key。开发人员可以使用SpEL来选择感兴趣的参数（或它们的嵌套属性），执行操作甚至调用任意方法，而无需编写任何代码或实现任何接口。这是对默认生成器的推荐方法，因为方法与代码库增长的方式在签名方面往往有很大不同;而默认策略可能适用于某些方法，但对于所有方法都很少。

@Cacheable(cacheNames="books", key="#isbn")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

@Cacheable(cacheNames="books", key="#isbn.rawNumber")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

@Cacheable(cacheNames="books", key="T(someType).hash(#isbn)")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

　　上面的代码片段显示了选择某个参数，它的一个属性，甚至是一个任意的（静态）方法是多么简单。

　　如果负责生成key的算法过于具体或者需要共享，您可以在操作中定义一个自定义keyGenerator。为此，请指定要使用的KeyGenerator bean实现的名称：

@Cacheable(cacheNames="books", keyGenerator="myKeyGenerator")
public Book findBook(ISBN isbn, boolean checkWarehouse, boolean includeUsed)

　　注意：key和keyGenerator参数是互斥的，指定两者的操作将导致异常。

2.2、缓存解析器

2.2.1、默认缓存解析器

　　缓存抽象使用一个简单的CacheResolver，它使用配置的CacheManager检索在操作级别定义的缓存。

　　要提供不同的默认缓存解析器，需要实现org.springframework.cache.interceptor.CacheResolver接口。

2.2.2、自定义缓存解析器

　　默认的缓存解析非常适合使用单个CacheManager并且不需要复杂的缓存解析要求的应用程序。对于使用多个缓存管理器的应用程序，可以将cacheManager设置为使用每个操作：

@Cacheable(cacheNames="books", cacheManager="anotherCacheManager")
public Book findBook(ISBN isbn) {...}

　　也可以完全以与key生成类似的方式替换CacheResolver。该解决方案针对每个缓存操作进行请求，给予实现基于运行时参数实际解析要使用的缓存的机会：

@Cacheable(cacheResolver="runtimeCacheResolver")
public Book findBook(ISBN isbn) {...}

　　注意：自Spring 4.1以来，缓存注释的值属性不再是强制性的，因为无论注释的内容如何，​​CacheResolver都可以提供此特定信息。

　　与key和keyGenerator类似，cacheManager和cacheResolver参数是互斥的，指定两者的操作将导致出现异常，因为CacheResolver实现将忽略自定义CacheManager。这可能不是你所期望的。