RedisTemplate 两种序列化实践方案

RedisTemplate 两种序列化实践方案

方案一:自定义 RedisTemplate

修改 RedisTemplate 的序列化方式为 GenericJackson2JsonRedisSerializer。

配置类

java 复制代码
@Configuration
public class RedisConfig {

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

        // 使用 GenericJackson2JsonRedisSerializer 序列化 value
        GenericJackson2JsonRedisSerializer jsonSerializer = new GenericJackson2JsonRedisSerializer();

        // key 使用 String 序列化
        template.setKeySerializer(new StringRedisSerializer());
        template.setHashKeySerializer(new StringRedisSerializer());

        // value 使用 JSON 序列化
        template.setValueSerializer(jsonSerializer);
        template.setHashValueSerializer(jsonSerializer);

        template.afterPropertiesSet();
        return template;
    }
}

使用示例

java 复制代码
@Service
public class UserService {

    @Autowired
    private RedisTemplate<String, Object> redisTemplate;

    // 写入(自动序列化为 JSON)
    public void saveUser(User user) {
        redisTemplate.opsForValue().set("user:" + user.getId(), user, 30, TimeUnit.MINUTES);
    }

    // 读取(自动反序列化为对象)
    public User getUser(Long id) {
        return (User) redisTemplate.opsForValue().get("user:" + id);
    }
}

优缺点

优点 缺点
读写无需手动序列化/反序列化 JSON 中会存储类的全限定名,占用额外空间
代码简洁 类名变更后旧数据无法反序列化
支持复杂对象类型 与其他语言客户端兼容性较差

方案二:使用 StringRedisTemplate + 手动序列化

写入时手动将对象序列化为 JSON,读取时手动将 JSON 反序列化为对象。

配置依赖

引入 Jackson(Spring Boot 默认已包含):

xml 复制代码
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
</dependency>

使用示例

java 复制代码
@Service
public class UserService {

    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @Autowired
    private ObjectMapper objectMapper;

    // 写入:手动序列化为 JSON 字符串
    public void saveUser(User user) throws JsonProcessingException {
        String json = objectMapper.writeValueAsString(user);
        stringRedisTemplate.opsForValue().set("user:" + user.getId(), json, 30, TimeUnit.MINUTES);
    }

    // 读取:手动反序列化为对象
    public User getUser(Long id) throws JsonProcessingException {
        String json = stringRedisTemplate.opsForValue().get("user:" + id);
        if (json == null) {
            return null;
        }
        return objectMapper.readValue(json, User.class);
    }
}

优缺点

优点 缺点
JSON 数据干净,无多余类型信息 每次读写需手动处理序列化
跨语言兼容性好 代码相对繁琐
数据可读性强,便于调试 需要处理 JsonProcessingException

方案对比总结

对比项 方案一(自定义 RedisTemplate) 方案二(StringRedisTemplate)
使用便捷性 高,自动处理 低,手动处理
存储内容 含类型信息的 JSON 纯净 JSON
跨语言兼容 差 好
适用场景 纯 Java 项目 多语言、对数据格式有要求的项目

推荐:对于纯 Java 项目且不需要跨语言访问,优先选择方案一 ;若需要与其他语言共享缓存数据,选择方案二。

相关推荐
西西弗Sisyphus几秒前
C++ explicit 关键字工程实践
开发语言·c++
Forget the Dream1 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
bksczm1 小时前
Redis Cluster 分片集群详解:槽路由、故障判定与扩缩容
数据库·redis·分布式
郝学胜-神的一滴1 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
feixing_fx2 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
wuyk5552 小时前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel
黑十2 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
神明不懂浪漫3 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记
用户54817845909503 小时前
Java 与 Python 在大模型与智能体领域的选型
java·python
文丑颜不良啊3 小时前
LeetCode3341~3360题目解析
java·leetcode