第 8 节:SpringBoot3 整合 Redis7

第 8 节:SpringBoot3 整合 Redis7

项目:com.zzs.szyt

前置:Redis7 已经安装并启动(本地 Windows / 服务器 Linux 都可以),记住 Redis 的 IP、端口、密码

目标:引入 Redis 依赖、配置 yml、封装 Redis 工具类、写测试接口,实现缓存读写,Postman 测试

1. pom.xml 新增 Redis 依赖

打开 pom.xml,在 <dependencies> 里面添加:

复制代码
<!-- SpringBoot3 Redis 依赖,spring-data-redis -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 连接池 lettuce(SpringBoot3默认用lettuce,不是jedis) -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
</dependency>

添加完,点击 IDEA 右侧 Maven 刷新按钮,拉取依赖。

2. 多环境 yml 配置 Redis

分别修改 application-dev.yml、application-prod.yml

dev(本地开发环境,本地 Redis)

复制代码
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password:  # 本地Redis没密码就空着
      database: 0  # 选第0号库
      lettuce:
        pool:
          max-active: 8
          max-idle: 8
          min-idle: 0
          max-wait: 1000ms

prod(服务器生产环境,改成服务器 Redis 地址 + 密码)

复制代码
spring:
  data:
    redis:
      host: 你的服务器IP
      port: 6379
      password: 你的redis密码
      database: 0
      lettuce:
        pool:
          max-active: 8
          max-idle: 8
          min-idle: 0
          max-wait: 1000ms

⚠️ SpringBoot3 是 spring.data.redis,不是 spring.redis,写错直接连不上!

3. 新建 Redis 配置类(解决序列化乱码问题,必加)

新建包:com.zzs.szyt.config

新建类 RedisConfig.java

复制代码
package com.zzs.szyt.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);

        // key 使用字符串序列化
        StringRedisSerializer stringSerializer = new StringRedisSerializer();
        // value 使用json序列化
        GenericJackson2JsonRedisSerializer jsonSerializer = new GenericJackson2JsonRedisSerializer();

        template.setKeySerializer(stringSerializer);
        template.setHashKeySerializer(stringSerializer);
        template.setValueSerializer(jsonSerializer);
        template.setHashValueSerializer(jsonSerializer);
        template.afterPropertiesSet();
        return template;
    }
}

作用:默认序列化会存二进制乱码,这个配置让 Redis 存可读 JSON,方便可视化工具查看。

4. 封装 Redis 工具类(方便后续业务调用)

新建包:com.zzs.szyt.util

新建 RedisUtil.java

复制代码
package com.zzs.szyt.util;

import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Component;
import javax.annotation.Resource;
import java.util.concurrent.TimeUnit;

@Component
public class RedisUtil {

    @Resource
    private RedisTemplate<String, Object> redisTemplate;

    /**
     * 设置key-value,带过期时间
     * @param key 键
     * @param value 值
     * @param expireTime 过期时长
     * @param unit 时间单位
     */
    public void set(String key, Object value, long expireTime, TimeUnit unit) {
        redisTemplate.opsForValue().set(key, value, expireTime, unit);
    }

    /**
     * 设置key-value,永久不过期
     */
    public void set(String key, Object value) {
        redisTemplate.opsForValue().set(key, value);
    }

    /**
     * 获取值
     */
    public Object get(String key) {
        return redisTemplate.opsForValue().get(key);
    }

    /**
     * 删除key
     */
    public Boolean delete(String key) {
        return redisTemplate.delete(key);
    }

    /**
     * 判断key是否存在
     */
    public Boolean hasKey(String key) {
        return redisTemplate.hasKey(key);
    }
}

5. 写 Redis 测试 Controller

com.zzs.szyt.controller 新建 RedisTestController.java

复制代码
package com.zzs.szyt.controller;

import com.zzs.szyt.util.RedisUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.annotation.Resource;
import java.util.concurrent.TimeUnit;
import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/redis")
public class RedisTestController {

    @Resource
    private RedisUtil redisUtil;

    // 存入字符串
    @GetMapping("/set")
    public Map<String,Object> setRedis(@RequestParam String key, @RequestParam String value){
        redisUtil.set(key, value, 30, TimeUnit.MINUTES);
        Map<String,Object> res = new HashMap<>();
        res.put("msg","存入成功");
        res.put("key",key);
        res.put("value",value);
        return res;
    }

    // 读取
    @GetMapping("/get")
    public Map<String,Object> getRedis(@RequestParam String key){
        Object val = redisUtil.get(key);
        Map<String,Object> res = new HashMap<>();
        res.put("msg","查询成功");
        res.put("key",key);
        res.put("value",val);
        return res;
    }

    // 删除
    @GetMapping("/del")
    public Map<String,Object> delRedis(@RequestParam String key){
        redisUtil.delete(key);
        Map<String,Object> res = new HashMap<>();
        res.put("msg","删除成功");
        res.put("key",key);
        return res;
    }
}

6. 启动项目 + Postman 测试

✅ 先确认:Redis 服务已经启动!

  1. 启动 szyt 项目,观察控制台,没有 Redis 连接报错就是连接成功
  2. Postman 测试接口:
  • 存入:GET http://localhost:8080/redis/set?key=name&value=zhangsan
  • 读取:GET http://localhost:8080/redis/get?key=name
  • 删除:GET http://localhost:8080/redis/del?key=name

7. 本章节验收标准

  1. 项目正常启动,无 Redis 连接异常
  2. Postman 可以正常写入、读取、删除 Redis 数据
  3. 可以用 Redis 可视化工具(Redis Desktop Manager 等)看到存入的数据
相关推荐
Flynn Liang3 小时前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
雪芽蓝域zzs5 小时前
第 3 章:完成 User 完整 CRUD(新增、根据 id 查询、修改、删除、查询全部)
spring boot
她的男孩8 小时前
审批人选了「部门主管」,发起却报 Unknown property:Forge Admin 启动时补齐组织变量
spring boot·低代码·工作流引擎
wno7048 小时前
springboot整合FastDFS
java·spring boot·后端
一起_java17 小时前
技术文章-基于Dify-Agent的智能问答系统设计与实现
java·spring boot·后端·agent·dify
Flynn Liang19 小时前
I/O 密集型高并发实战:Java 服务 10 维优化,从线程打满到 10 万 QPS
java·spring boot·性能优化·高并发·系统设计·虚拟线程·io密集型
Flynt1 天前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
杨凯凡1 天前
Spring Boot 事务提交后消息仍会丢?TransactionalEventListener 与 Outbox 可靠投递实战
java·spring boot
学长毕设2 天前
基于SpringBoot军事纪念馆管理系统设计与实现-附源码
java·spring boot·后端