Java 后端 / 系统课时

连接 Redis 与操作常用结构

连接 Redis 与操作常用结构

本课完成 Spring Boot 与 Redis 的最小可运行集成:启动本地 Redis、配置连接与序列化,再用 RedisTemplate 操作 String、Hash、List、Set 和 ZSet,并从控制台与 Redis CLI 双重验证结果。

学习目标

  • 接入 Spring Data Redis 并确认连接可用
  • 为键、普通值和 Hash 字段配置一致的序列化方式
  • 根据业务访问方式选择并操作五种常用 Redis 结构

准备 Redis 与项目依赖

本地没有 Redis 时,可用 Docker 启动一个只用于学习的实例。

bash
docker run --name lesson-redis -p 6379:6379 -d redis:7-alpine

预期输出

text
<ID>

<ID> 是容器 ID,实际值每次不同。已有同名容器时可改名,或执行 docker start lesson-redis。

在现有 Spring Boot 3 项目的 pom.xml 中加入 Redis Starter。Spring Boot 会根据配置创建连接工厂,默认客户端为 Lettuce。

xml
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

在 application.yml 中配置连接。这里允许通过环境变量覆盖地址、端口和密码,未设置时连接本机 6379 端口。

yaml
spring:
  data:
    redis:
      host: ${REDIS_HOST:localhost}
      port: ${REDIS_PORT:6379}
      password: ${REDIS_PASSWORD:}
      timeout: 2s

配置生效后,应用启动时不一定立即访问 Redis,因此真正的连通性要通过后面的读写操作验证。

理解模板与序列化

Redis 最终保存的是字节序列。RedisTemplate 决定 Java 对象如何转换为字节,以及读回时如何恢复对象;写入与读取使用不同序列化器,会出现键看似存在但程序无法正确反序列化的问题。

本课让键和 Hash 字段使用可读的字符串序列化,让普通值和 Hash 值使用 JSON 序列化。这样既方便在 Redis CLI 中定位键,也能保存字符串、数字、集合或普通对象。

RedisTemplate 序列化与常用结构映射

Redis 结构 Spring 操作入口 适合的问题
String opsForValue() 单值缓存、计数器、短期令牌
Hash opsForHash() 按字段读写对象
List opsForList() 保留顺序的任务或消息
Set opsForSet() 去重标签、成员关系
ZSet opsForZSet() 带分数排序、排行榜

配置 RedisTemplate

将以下配置保存为 RedisConfig.java。四类序列化器必须成对设置,避免普通值和 Hash 值采用不一致格式。

java
package com.example.redis;

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
    RedisTemplate<String, Object> redisTemplate(
            RedisConnectionFactory connectionFactory) {

        StringRedisSerializer stringSerializer = new StringRedisSerializer();
        GenericJackson2JsonRedisSerializer jsonSerializer =
            new GenericJackson2JsonRedisSerializer();

        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(connectionFactory);

        // 键保持可读,便于运维定位和统一命名空间
        template.setKeySerializer(stringSerializer);
        template.setHashKeySerializer(stringSerializer);

        // 值统一使用 JSON,避免默认 JDK 序列化产生不可读二进制
        template.setValueSerializer(jsonSerializer);
        template.setHashValueSerializer(jsonSerializer);
        template.afterPropertiesSet();
        return template;
    }
}

该配置不会主动创建数据。验证标准是:应用能完成一次写入和读取,Redis CLI 能看到 demo: 前缀的键,并且重启应用后仍能按同一序列化规则读取。

操作五种常用结构

将以下类保存为 RedisStructureDemo.java。程序每次运行先删除演示键,确保输出不会受上一次执行残留数据影响。

java
package com.example.redis;

import java.time.Duration;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.springframework.boot.CommandLineRunner;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Component;

@Component
public class RedisStructureDemo implements CommandLineRunner {

    private static final String GREETING_KEY = "demo:greeting";
    private static final String USER_KEY = "demo:user:1001";
    private static final String TASKS_KEY = "demo:tasks";
    private static final String ROLES_KEY = "demo:roles";
    private static final String RANKING_KEY = "demo:ranking";

    private final RedisTemplate<String, Object> redisTemplate;

    public RedisStructureDemo(RedisTemplate<String, Object> redisTemplate) {
        this.redisTemplate = redisTemplate;
    }

    @Override
    public void run(String... args) {
        redisTemplate.delete(List.of(
            GREETING_KEY, USER_KEY, TASKS_KEY, ROLES_KEY, RANKING_KEY
        ));

        // String:保存单值并设置 10 分钟过期时间
        redisTemplate.opsForValue()
            .set(GREETING_KEY, "hello", Duration.ofMinutes(10));

        // Hash:对象字段可独立读取和更新
        redisTemplate.opsForHash().putAll(
            USER_KEY,
            Map.of("name", "Ada", "level", 5)
        );

        // List、Set、ZSet 分别演示顺序、去重和按分数排序
        redisTemplate.opsForList()
            .rightPushAll(TASKS_KEY, "review", "deploy");
        redisTemplate.opsForSet()
            .add(ROLES_KEY, "ADMIN", "AUDITOR", "ADMIN");
        redisTemplate.opsForZSet()
            .add(RANKING_KEY, "alice", 98.5);

        Object greeting = redisTemplate.opsForValue().get(GREETING_KEY);
        Object userName = redisTemplate.opsForHash().get(USER_KEY, "name");
        List<Object> tasks =
            redisTemplate.opsForList().range(TASKS_KEY, 0, -1);
        Long roleCount = redisTemplate.opsForSet().size(ROLES_KEY);
        Boolean hasAdmin =
            redisTemplate.opsForSet().isMember(ROLES_KEY, "ADMIN");
        Set<Object> topOne =
            redisTemplate.opsForZSet().reverseRange(RANKING_KEY, 0, 0);

        System.out.println("greeting=" + greeting);
        System.out.println("user.name=" + userName);
        System.out.println("tasks=" + tasks);
        System.out.printf(
            "roleCount=%d, hasAdmin=%s%n", roleCount, hasAdmin
        );
        System.out.println("top1=" + topOne);
    }
}

运行应用。

bash
./mvnw spring-boot:run

预期输出

text
greeting=hello
user.name=Ada
tasks=[review, deploy]
roleCount=2, hasAdmin=true
top1=[alice]

Set 中重复写入的 ADMIN 只保留一份,因此成员数为 2;ZSet 按分数排序,本例只有 alice 一个成员。

用 Redis CLI 复核

下面的命令从 Redis 侧检查结构类型、过期时间和集合大小,不依赖 Java 日志。

bash
docker exec lesson-redis redis-cli TYPE demo:greeting
docker exec lesson-redis redis-cli TTL demo:greeting
docker exec lesson-redis redis-cli LLEN demo:tasks
docker exec lesson-redis redis-cli SCARD demo:roles
docker exec lesson-redis redis-cli ZREVRANGE demo:ranking 0 0

预期输出

text
string
<TTL_SECONDS>
2
2
alice

<TTL_SECONDS> 会从接近 600 持续递减。若第一条返回 none,优先检查应用是否真的执行了演示类、Redis 地址是否一致,以及容器端口是否正确映射。

处理序列化与结构边界

序列化规则一旦修改,历史数据可能无法按新规则读取。生产环境应给键增加稳定命名空间和版本,例如 user:v1:<ID>,升级格式时使用新版本前缀或安排数据迁移,不要直接让新旧格式混用。

数据结构应由访问方式决定。需要按字段更新时选 Hash,需要去重时选 Set,需要分数排序时选 ZSet;不要因为 Java 中使用了 List,就机械地把整个对象序列化进 Redis List。

所有临时缓存都应明确 TTL。批量扫描生产键空间时使用 SCAN 思路,不要用会阻塞 Redis 的全量 KEYS 查询作为业务逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

连接 Redis 与操作常用结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通