    <dependencies>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <!--<dependency>
            <groupId>com.alicp.jetcache</groupId>
            <artifactId>jetcache-starter-redis</artifactId>
            <version>2.6.2</version>
        </dependency>-->

        <dependency>
            <groupId>com.alicp.jetcache</groupId>
            <artifactId>jetcache-starter-redis</artifactId>
            <version>2.5.11</version>
        </dependency>

        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>2.9.0</version>
        </dependency>

    </dependencies>

4.3 本地缓存方案

4.3.1 application 配置文件

可以参考git文档进行相关参数配置，下面为基本的配置文件

jetcache:
  statIntervalMinutes: 1 #每过1分钟在控制台汇总一次数据
  areaInCacheName: false
  local:
    default:
      type: linkedhashmap 				#可选值：caffeine/linkedhashmap
      keyConvertor: fastjson 			#可选值 ：fastjson/jackson
      limit: 100						#本地缓存限制的最大个数

4.3.2 新增测试方法

在业务层新增一个查询方法，关于方法上面使用的注解，和springcache上面的很像，有兴趣的同学可以参阅官网文档或相关资料深入了解，在日常开发中，掌握基本的注解参数使用即可，这里需要说明的是，使用本地缓存最关键的地方是注解中的，cacheType这个属性，通过指定CacheType的类型就可以指定是使用本地缓存？远程缓存？还是两种缓存同时使用。

    @Cached(name="book_",key="#id",expire = 3600,cacheType = CacheType.LOCAL)
    public Book getById(Integer id) {
        System.out.println("初次查询走缓存");
        Book book = new Book();
        book.setId(id);
        book.setName("Java全栈工程师");
        book.setDescription("最新上市");
        return book;
    }

4.3.3 新增测试接口

在控制器层增加一个查询接口如下

    //http://localhost:8083/book/getById?id=100
    @GetMapping("/getById")
    public Book getById(int id){
        return bookService.getById(id);
    }

4.3.4 启动类

启动类上需要添加下面的这个注解：EnableCreateCacheAnnotation，表示扫描的包路径下的方法上使用了缓存注解将会生效；

@SpringBootApplication
@EnableMethodCache(basePackages = "com.congge.service")
@EnableCreateCacheAnnotation
public class JetApp {
    public static void main(String[] args) {
        SpringApplication.run(JetApp.class,args);
    }

}

4.3.5 效果测试

启动工程，然后调用接口，第一次调用可以看到控制台输出了下面的日志；

同时接口也返回结果

再次调用接口时，由于缓存尚未失效，可以看到控制台并没有输出日志，而是直接返回了数据；

4.4 远程缓存方案

4.4.1 application 添加如下配置

主要关注remote开头的那部分

jetcache:
  statIntervalMinutes: 1 #每过1分钟在控制台汇总一次数据
  areaInCacheName: false
  local:
    default:
      type: linkedhashmap
      keyConvertor: fastjson
      limit: 100
	
	#远程缓存配置
  remote:
    default:
      type: redis
      host: localhost
      port: 6379
      keyConvertor: fastjson  #fastjson2 #other choose：fastjson/jackson
      valueEncoder: java	   #other choose：kryo/kryo5
      valueDecoder: java	   #other choose：kryo/kryo5
      poolConfig:
        maxTotal: 50
        minIdle: 5
        maxIdle: 20

4.4.2 修改业务层方法注解参数

只需修改注解中的属性cacheType为REMOTE即可；

    @Cached(name="book_",key="#id",expire = 3600,cacheType = CacheType.REMOTE)
    public Book getById(Integer id) {
        System.out.println("初次查询走缓存");
        Book book = new Book();
        book.setId(id);
        book.setName("Java全栈工程师");
        book.setDescription("最新上市");
        return book;
    }

4.4.3 启动服务测试效果

启动redis，启动工程后，调用相同的接口，第一次调用效果如下

再次调用时控制台就没有输出日志了

同时可以到redis中看一下缓存的数据

4.4.4 字段级缓存@CreateCache

在jetcache中存在缓存空间的概念，可以类比命名空间namespace的概念，好处就是可以清晰的区分出不同的业务在不同的缓存空间中进行分类管理，在jetcache中对应为字段级缓存，注解标签为：@CreateCache，注解常用的属性如下：

属性	默认值	备注说明
name	无	指定缓存的名称，不是必须的，如果没有指定，会使用类名+方法名。name会被用于远程缓存的key前缀。另外在统计中，一个简短有意义的名字会提高可读性。如果两个`@CreateCache`的`name`和`area`相同，它们会指向同一个`Cache`实例
expire	无	该Cache实例的默认超时时间定义，注解上没有定义的时候会使用全局配置，如果此时全局配置也没有定义，则取无穷大
timeUnit	TimeUnit.SECONDS	指定expire的单位
cacheType	CacheType.REMOTE	缓存的类型，包括CacheType.REMOTE、CacheType.LOCAL、CacheType.BOTH。如果定义为BOTH，会使用LOCAL和REMOTE组合成两级缓存

用法示例：

如下配置文件中，在与default平级的一栏增加一个book打头的配置去，其他的配置和上面保持一致；

server:
  port: 8087

jetcache:
  statIntervalMinutes: 1 #每过1分钟在控制台汇总一次数据
  areaInCacheName: false
  local:
    default:
      type: linkedhashmap
      keyConvertor: fastjson
      limit: 100

  remote:
    default:
      type: redis
      host: localhost
      port: 6379
      keyConvertor: fastjson
      valueEncoder: java
      valueDecoder: java
      poolConfig:
        maxTotal: 50
        minIdle: 5
        maxIdle: 20

    #具体某个命名空间下的配置
    user:
      type: redis
      host: localhost
      port: 6379
      keyConvertor: fastjson
      valueEncoder: java
      valueDecoder: java
      poolConfig:
        maxTotal: 50
        minIdle: 5
        maxIdle: 20

为当前的业务类注入Cache属性，并指定area的属性值为user，说明当前的缓存将归在user缓存空间下

@Service
public class UserService {

    @CreateCache(area = "user",name="jetCache:",expire = 3600,cacheType= CacheType.REMOTE)
    private Cache<Long,User> jetCache;

    //@Cached(name = "userCache:", key = "#id", expire = 1800, cacheType = CacheType.LOCAL)

    public User getById(Long id) {
        if(jetCache != null && jetCache.get(id) != null){
            System.out.println("从缓存直接返回数据");
            return jetCache.get(id);
        }
        System.out.println("初次查询未走缓存");
        User user = new User();
        user.setId(100L);
        user.setName("mike");
        jetCache.put(id,user);
        return user;
    }
}

然后按照同样的方式调用一下接口，并观察控制台输出日志

4.5 同时开启本地缓存和远程缓存

4.5.1 修改配置属性值

基于上一步的基础上只需要将查询方法中的注解中属性值修改为： cacheType = CacheType.BOTH 即可；

    @Cached(name="book_",key="#id",expire = 3600,cacheType = CacheType.BOTH)
    public Book getById(Integer id) {
        System.out.println("初次查询走缓存");
        Book book = new Book();
        book.setId(id);
        book.setName("Java全栈工程师");
        book.setDescription("最新上市");
        return book;
    }

4.5.2 业务层其他方法

下面给出业务实现类中涉及到缓存相关的其他注解

@Service
public class BookService {

    @Cached(name="book_",key="#id",expire = 3600,cacheType = CacheType.BOTH)
    public Book getById(Integer id) {
        System.out.println("初次查询走缓存");
        Book book = new Book();
        book.setId(id);
        book.setName("Java全栈工程师");
        book.setDescription("最新上市");
        return book;
    }

    @CacheUpdate(name="book_",key="#book.id",value="#book")
    public boolean update(Book book) {
        System.out.println("修改数据，同时更新缓存");
        book.setName("最新Python教程");
        return true;
    }

    @CacheInvalidate(name="book_",key = "#id")
    public boolean delete(Integer id) {
        System.out.println("删除书籍，同时删除缓存");
        return true;
    }

    /*@Cached(name="book_",key="#id",expire = 3600,cacheType = CacheType.REMOTE)
    @CacheRefresh(refresh = 5)
    public Book getById(Integer id) {
        return bookDao.selectById(id);
    }
*/

}

4.6 jetcache 核心注解

JetCache方法缓存和SpringCache比较类似，它原生提供了TTL支持，以保证最终一致，并且支持二级缓存。JetCache2.4以后支持基于注解的缓存更新和删除。在spring环境下，使用@Cached注解可以为一个方法添加缓存，@CacheUpdate用于更新缓存，@CacheInvalidate用于移除缓存元素。注解可以加在接口上也可以加在类上，加注解的类必须是一个spring bean。

4.6.1 @Cached注解

该注解主要用作查询业务中缓存查询数据，具体来说包括：

在方法上添加 @Cached 注解，指定缓存的 key 和过期时间等参数；
当方法被调用时，JetCache 会先从缓存中查找对应的数据；
如果缓存中存在数据，则直接返回缓存中的数据，不再执行方法体；
如果缓存中不存在数据，则执行方法体，并将方法的返回值存入缓存中；
后续调用该方法时，将直接从缓存中获取数据，不再执行方法体；
缓存的过期时间到达后，缓存数据将被自动清除，下次调用该方法将重新执行方法体并更新缓存数据；

JetCache 支持多种缓存类型，包括本地内存缓存、Redis 缓存、Caffeine 缓存等，可以根据实际需求进行配置。同时，JetCache 还提供了缓存预热、缓存穿透、缓存雪崩等解决方案，以提高缓存的效率和稳定性。

@Cached注解和@CreateCache的属性非常类似，但是多几个：

属性	默认值	备注
area	“default”	如果在配置中配置了多个缓存area，在这里指定使用哪个area
name	无	指定缓存的唯一名称，不是必须的，如果没有指定，会使用类名+方法名。name会被用于远程缓存的key前缀。另外在统计中，一个简短有意义的名字会提高可读性。
key	无	使用SpEL指定key，如果没有指定会根据所有参数自动生成。
expire	无	超时时间。如果注解上没有定义，会使用全局配置，如果此时全局配置也没有定义，则为无穷大
timeUnit	TimeUnit.SECONDS	指定expire的单位
cacheType	CacheType.REMOTE	缓存的类型，包括CacheType.REMOTE、CacheType.LOCAL、CacheType.BOTH。如果定义为BOTH，会使用LOCAL和REMOTE组合成两级缓存
localLimit	无	1、如果cacheType为LOCAL或BOTH，这个参数指定本地缓存的最大元素数量，以控制内存占用； 2、如果注解上没有定义，会使用全局配置，如果此时全局配置也没有定义，则为100，参数 localLimit 表示本地缓存的最大条目限制； 3、当使用 JetCache 的本地缓存功能时，localLimit 参数可以控制本地缓存中最多缓存的条目数量，如果超过了这个数量，将会按照 LRU（Least Recently Used）算法删除最近最少使用的缓存条目，以保持缓存的大小在限制范围内； 4、localLimit 默认值为 100条，可以通过设置该值来优化缓存性能和内存使用； 5、当type为LOCAL时，配置localLimit，当key值超出限制条件，会删除最少使用的条目，重新请求缓存过的，会走到db再缓存一次； 6、当type为BOTH时，虽然配置了localLimit 当key值超出限制条件，本地会删除使用最少得条目，但是远程还有缓存，查询缓存时是优先查询本地，没有再去远程，都没有再走db，将查询结果进行一次缓存； 7、如果配置BOTH时，可以配置该项减少本地内存使用，但是不影响缓存整体使用因为有远程兜底；
localExpire	无	仅当cacheType为BOTH时适用，为内存中的Cache指定一个不一样的超时时间，通常应该小于expire
serialPolicy	未定义	指定远程缓存的序列化方式。可选值为SerialPolicy.JAVA和SerialPolicy.KRYO。如果注解上没有定义，会使用全局配置，如果此时全局配置也没有定义，则为SerialPolicy.JAVA
keyConvertor	无	指定KEY的转换方式，用于将复杂的KEY类型转换为缓存实现可以接受的类型，当前支持KeyConvertor.FASTJSON和KeyConvertor.NONE。NONE表示不转换，FASTJSON可以将复杂对象KEY转换成String。如果注解上没有定义，会使用全局配置。
enabled	true	是否激活缓存。例如某个dao方法上加缓存注解，由于某些调用场景下不能有缓存，所以可以设置enabled为false，正常调用不会使用缓存，在需要的地方可使用CacheContext.enableCache在回调中激活缓存，缓存激活的标记在ThreadLocal上，该标记被设置后，所有enable=false的缓存都被激活。
cacheNullValue	false	当方法返回值为null的时候是否要缓存
condition	无	使用SpEL指定条件，如果表达式返回true的时候才去缓存中查询
postCondition	无	使用SpEL指定条件，如果表达式返回true的时候才更新缓存，该评估在方法执行后进行，因此可以访问到#result

4.6.2 @CacheUpdate注解

该注解常用于方法的修改，用户更新缓存数据

属性	默认值	备注
area	"default"	如果在配置中配置了多个缓存area，在这里指定使用哪个area，指向对应的@Cached定义。
name	无	指定缓存的唯一名称，指向对应的@Cached定义。
key	无	使用SpEL指定key
value	无	使用SpEL指定value
condition	无	使用SpEL指定条件，如果表达式返回true才执行更新，可访问方法结果#result

4.6.3 @CacheInvalidate注解

该注解用于删除方法中让缓存失效

属性	默认值	备注
area	"default"	如果在配置中配置了多个缓存area，在这里指定使用哪个area，指向对应的@Cached定义。
name	无	指定缓存的唯一名称，指向对应的@Cached定义。
key	无	使用SpEL指定key
condition	无	使用SpEL指定条件，如果表达式返回true才执行删除，可访问方法结果#result

4.6.4 @CacheRefresh注解

该注解用于强制刷新缓存，即便缓存还未到达失效时间

属性	默认值	备注
refresh	无	刷新间隔
timeUnit	TimeUnit.SECONDS	时间单位
stopRefreshAfterLastAccess	无	指定该key多长时间没有访问就停止刷新，如果不指定会一直刷新
refreshLockTimeout	60秒	类型为BOTH/REMOTE的缓存刷新时，同时只会有一台服务器在刷新，这台服务器会在远程缓存放置一个分布式锁，此配置指定该锁的超时时间

4.6.5 @CachePenetrationProtect注解

当缓存访问未命中的情况下，对并发进行的加载行为进行保护。当前版本实现的是单JVM内的保护，即同一个JVM中同一个key只有一个线程去加载，其它线程等待结果。

对于以上未定义默认值的参数，如果没有指定，将使用yml中指定的全局配置，全局配置请参考配置说明

4.7 jetcache使用总结

关于jetcache的使用，结合实际经验做如下几点总结：

JetCache 适用于标准的查询单条数据或者查询列表数据的接口进行完整的缓存，这就要求接口的入参必须包含唯一健，且返回值必须是DTO对象。同时对于分页查询的接口无法实现缓存，也没有意义；
JetCache 默认使用的是 JDK 提供的序列化，JDK序列化性能差，可读性差。在目前项目开发过程中，一般 Redis 缓存都使用 JSON 格式对 Value 进行序列化；
JetCache 最大的优势是实现了本地和远程的二级缓存，相较于使用 Redis 缓存，使用本地缓存能够提供更高的吞吐量；
注意数据进入远程缓存时的类型转换问题；
jetcache提供有简单的缓存信息命中报表方便开发者即时监控缓存数据命中情况；

五、写在文末

jetcache的出现让开发者减少并降低了在使用二级缓存时的复杂性和难度，同时也给架构设计带了更多的可拓展性，一种新的技术组件的出现要么是提高解决问题的效率，要么是为程序设计带来更多便捷性的思路，这一点或许就是做中间件或SDK的妙处，本篇到此结束，感谢观看。

【分布式缓存】springboot整合jetcache使用详解

一、前言

二、多级缓存问题

2.1 缓存分类

2.1.1 本地缓存

2.1.2 分布式缓存

2.2 独立缓存的问题

2.2.1 缓存雪崩问题

2.2.2 对宽带压力大

2.2.3 运行效率低

2.3 多级缓存方案

2.3.1 多级缓存实践方案推荐

三、jetcache介绍

3.1 jetcache概述

3.2 jetcache 特性

3.3 jetcache 应用场景

3.3.1 热点数据缓存

3.3.2 多级缓存融合

3.3.3 支撑高并发读写

3.3.4 高速访问查询

3.4 JetCache API使用

3.4.1 缓存管理

3.4.2 注解支持

3.4.3 缓存类型

3.4.4 Spring 集成支持

四、jetcache与springboot整合应用

4.1 缓存支持类型

4.1.1 本地缓存类型

4.1.2 远程缓存支持类型

4.2 maven 依赖