当前位置：首页 > news >正文

如何在 SpringBoot 项目使用 Redis 的 Pipeline 功能

news 2025/7/10 17:59:38

在这里插入图片描述

本文是博主在批量存储聊天中用户状态和登陆信息到 Redis 缓存中时，使用到了 Pipeline 功能，并对此做出了整理。

一、Redis Pipeline 是什么

Redis 的 Pipeline 功能可以显著提升 Redis 操作的性能，性能提升的原因在于可以批量执行命令。当我们在存储数据时，会遇到批量存储的情况，在这种情况下，Pipeline 可以很好的处理，它可以是减少网络往返次数，从而显著提高 Redis 操作的性能。

这种情况例如：聊天系统中要统计每个用户的最后的状态，在这个情况下，用户数是一个很大的基体，每秒中会有很多的用户状态变化，变化的过程依赖最后一次使用状态，这就造成了批量的效果。

Redis Pipeline 是一种将多个命令打包发送到 Redis 服务器的技术，避免了逐条发送命令的网络延迟问题。通过 Pipeline，客户端可以一次性发送多个命令，服务器依次处理这些命令并将结果批量返回。

注意：

事务性：Pipeline 并不自动开启事务，它只是将多个命令打包发送，可以结合 Redis 的事务功能。
错误处理：在 Pipeline 中，如果某个命令失败，其他命令仍然会继续执行，需要在代码中处理可能的异常。

二、如何在 SpringBoot 使用

Spring Data Redis 提供了对 Pipeline 的支持，可以通过 RedisTemplate 的 executePipelined 方法实现。

如何在 SpringBoot 创建并连接 Redis 可参考该文章：SpringBoot 框架关于如何创建并使用 Redis 的详细介绍

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

默认情况下，Spring Boot 使用 Lettuce 作为 Redis 客户端，创建一个配置类来定义 RedisTemplate，并设置序列化器。

@Configuration
public class RedisConfig {
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        template.setKeySerializer(new StringRedisSerializer()); // 设置键的序列化器
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer()); // 设置值的序列化器
        return template;
    }
}

创建一个服务类来封装 Pipeline 操作：

@Service
public class RedisPipelineService {

    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    public void executePipeline() {
        // 使用 SessionCallback 来实现 Pipeline
        List<Object> results = redisTemplate.executePipelined(new SessionCallback<Object>() {
            @Override
            public Object execute(RedisOperations operations) {
                // 在此处添加多个命令到 Pipeline 中
                operations.opsForValue().set("key1", "value1");
                operations.opsForValue().set("key2", "value2");
                operations.opsForValue().set("key3", "value3");
                return null;
            }
        });

        // 获取执行结果
        System.out.println("Pipeline 执行结果: " + results);
    }
}

在控制器中调用 Pipeline 方法。

@RestController
public class RedisController {
    @Autowired
    private RedisPipelineService redisPipelineService;

    @GetMapping("/testPipeline")
    public String testPipeline() {
        redisPipelineService.executePipeline();
        return "Pipeline 执行已完成!";
    }
}