在 Spring Boot 项目中集成 tools-redis 实现分布式缓存,整体流程极为简洁,仅需几个关键配置与少量代码即可快速运行。下面我将逐步拆解,带您直接上手操作。
1. 在 pom 中引入依赖
首先,在 pom.xml 中添加以下依赖:

cn.gjing tools-redis 1.0.0
2. 在 application.properties 中配置 Redis 连接
接着,配置 Redis 连接参数,以下均为默认值,您可根据实际环境调整:
#redis数据库链接配置spring.redis.host=127.0.0.1spring.redis.port=6379spring.redis.password=spring.redis.database=0
3. 在 DemoApplication 启动类上启用二级缓存
在启动类添加注解,开启二级缓存支持:
@EnableSecondCache
4. 编写 DemoController 控制器
创建一个简单的 REST 接口,用于触发缓存逻辑:
@RestControllerpublic class DemoController {@Autowiredprivate DemoService demoService;@GetMapping("demo")public boolean demo(@RequestParam("id")Integer id){return demoService.demo(id);}}
5. 编写 DemoService 服务层
核心缓存逻辑位于服务层。注意 condition 参数,它控制仅在 id 大于 10 时才启用缓存,否则直接查询数据库——这在真实项目中非常实用,能避免小数据量场景下缓存带来的额外开销:
@Servicepublic class DemoService {/** * 当id大于10时使用缓存 * 当id小于或等于10时不使用缓存 * @param id * @return */@Cacheable(value = "id",key = "#id",condition = "#id>10")public boolean demo(Integer id){System.out.println("使用了数据库");if(id==20){ return true;}return false;}}
6. 测试验证缓存效果
启动服务后,访问以下地址即可验证缓存是否生效:
https://127.0.0.1:1111/demo?id=20
实际运行测试会发现,当传入 id=20(大于 10)时,第二次请求会命中缓存,控制台不再打印“使用了数据库”;而传入 id=5(小于等于 10)时,每次请求都会打印数据库调用信息,说明缓存条件正确生效。整个核心配置极为简单,开箱即用,非常适合在 Spring Boot 项目中快速搭建分布式缓存体系。
