Spring Cache实践，实现基于注解的Redis缓存功能。

1.简述redis：

1.1 什么是Redis？

• 内存型键值对数据库（支持持久化）
• 支持多种数据结构：String/Hash/List/Set/ZSet等
• 核心特性：高性能、原子操作、分布式支持、丰富的数据类型

1.2 为什么选择Redis作为缓存？

• 毫秒级响应速度（对比磁盘数据库）
• 支持数据过期和自动淘汰策略
• 主从复制与集群模式保障高可用
• 丰富的客户端生态（包括Spring Data Redis）

2.Spring Cache基本概念和注解

2.1 Spring Cache架构设计

        在spring boot项目中，使用缓存技术只需在项目中导入相关缓存技术的依赖包，并在启动类上使用@EnableCaching开启缓存支持即可。例如，使用Redis作为缓存技术，只需要导入Spring data Redis的maven坐标即可。

• 基于AOP的声明式缓存抽象层
• 支持多种存储实现（Redis/Ehcache/Caffeine等）
• 统一缓存操作接口（CacheManager/Cache）
• 需注入的起步依赖（使用redis缓存）：

• <!-- Redis 数据访问依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
  </dependency>
  <!-- Spring Cache 抽象依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-cache</artifactId>
  </dependency>

2.2 核心注解详解

        Spring Cache 提供了 5 个核心注解，覆盖缓存的读取、更新、删除等全生命周期操作。以下表格清晰呈现各注解的核心差异：

        一般经常使用的是@Cacheable，@CachePut和@CacheEvict三大注解。（记得在启动类上加上@EnableCaching注解，开启缓存注解功能）。

下面详细介绍一下这三大注解。

2.2.1@Cacheable：缓存方法结果的最佳注解

        @Cacheable 是最常用的缓存注解，用于标记查询类方法，其核心逻辑是：调用方法时先检查缓存，若缓存命中则直接返回缓存数据，跳过方法执行；若未命中则执行方法，并将方法返回值存入缓存。

代码示例：

    /**
	* Cacheable：在方法执行前spring先查看缓存中是否有数据，
            如果有数据，则直接返回缓存数据；
            若没有数据，则调用方法并将方法返回值放到缓存中
	*/
	@GetMapping
    @Cacheable(cacheNames = "userCache",key="#id")
    public User getById(Long id){
        User user = userMapper.getById(id);
        return user;
    }

        其中的value是缓存的名称，每个缓存名称下面可以有多个key ；key是自定义缓存键，支持 Spring Expression Language (SpEL) 动态生成。例如 key="#id" 表示使用方法参数 id 作为键，key="T(System).currentTimeMillis()" 可结合系统时间生成动态键。

2.2.2 @CachePut：用以确保缓存与数据一致性

        @CachePut 用于更新缓存，与 @Cacheable 的核心区别在于：方法一定会执行，执行后将返回值存入缓存，适用于新增或更新数据的场景，确保缓存与数据库状态一致。

代码示例：

	/**
	* CachePut：将方法返回值放入缓存，用以更新缓存
	*/
	@PostMapping
    @CachePut(value = "userCache", key = "#user.id")//key的生成：userCache::1
    public User save(@RequestBody User user){
        userMapper.insert(user);
        return user;
    }

        其中key的写法多样例如：

  #user.id : #user指的是方法形参的名称, id指的是user的id属性 , 也就是使用user的id属性作为key ;

  #result.id : #result代表方法返回值，该表达式 代表以返回对象的id属性作为key ；等等....

2.2.3 @CacheEvict：用于单个或多个缓存的清理

        @CacheEvict 用于从缓存中删除数据，支持单条删除或全量清空，是保证缓存一致性的重要手段。例如删除用户后，需同步清理缓存中对应的用户数据，避免脏数据读取。

代码示例：

	@DeleteMapping
    @CacheEvict(cacheNames = "userCache",key = "#id")//删除某个key对应的缓存数据
    public void deleteById(Long id){
        userMapper.deleteById(id);
    }

	@DeleteMapping("/delAll")
    @CacheEvict(cacheNames = "userCache",allEntries = true)//删除所有的缓存数据
    public void deleteAll(){
        userMapper.deleteAll();
    }

        其中：key：用于删除指定键；allEntries=true：用于删除缓存中所有数据。

3.总结：

        Spring Cache 注解的威力在于"声明式简洁"与"底层灵活"的平衡，但需遵循以下原则避免常见问题：
缓存键设计：通过 SpEL 确保键唯一性（如结合方法参数、类名），避免不同方法缓存键冲突。
缓存粒度：优先缓存查询频繁、计算昂贵的方法结果，避免缓存细粒度或高频变动数据。
一致性保障：写操作（新增/更新/删除）需配合 @CachePut 或 @CacheEvict，确保缓存与数据库同步。
条件控制：合理使用 condition/unless 过滤无效缓存（如 null 结果、临时数据）。
通过掌握这些注解的使用场景与最佳实践，可以在 Spring Boot 项目中快速构建高效、可靠的缓存体系，轻松应对高并发场景下的性能挑战。