RedisTemplate 的 6 个可配置序列化器属性对比

RedisTemplate 的 6 个可配置序列化器属性对比

RedisTemplate 提供了以下 6 个核心属性,用于分别配置键、值、哈希类型数据的序列化方式:


1. keySerializer
  • 作用 :定义 Redis 键的序列化方式。
  • 默认值 :JdkSerializationRedisSerializer(若未显式配置 stringSerializer)。
  • 推荐序列化器 :
    • StringRedisSerializer:键通常为字符串,推荐使用此序列化器。
  • 适用场景:确保键为可读的字符串格式。
2. valueSerializer
  • 作用 :定义 Redis 值的序列化方式。
  • 默认值 :JdkSerializationRedisSerializer。
  • 推荐序列化器 :
    • GenericJackson2JsonRedisSerializer:复杂对象自动序列化。
    • FastjsonRedisSerializer:高性能 JSON 序列化。
  • 适用场景:存储复杂对象或需要类型信息的场景。
3. hashKeySerializer
  • 作用 :定义 Redis 哈希类型键 (如 hset key field value 中的 field)的序列化方式。
  • 默认值 :与 keySerializer 相同。
  • 推荐序列化器 :
    • StringRedisSerializer:哈希字段通常为字符串。
  • 适用场景:确保哈希键的可读性。
4. hashValueSerializer
  • 作用 :定义 Redis 哈希类型值的序列化方式。
  • 默认值 :与 valueSerializer 相同。
  • 推荐序列化器 :
    • Jackson2JsonRedisSerializer:固定类型值的 JSON 序列化。
  • 适用场景:存储结构化的哈希值(如对象属性)。
5. stringSerializer
  • 作用:基础字符串序列化器,影响其他属性的默认行为。

  • 默认值 :StringRedisSerializer。

  • 推荐配置:

    • 统一设置 stringSerializer 可简化键和值的配置:

      java 复制代码
      template.setKeySerializer(template.getStringSerializer());
  • 适用场景:全局统一字符串处理。

6. defaultSerializer
  • 作用 :当其他属性未显式配置时的默认序列化器。
  • 默认值 :JdkSerializationRedisSerializer。
  • 推荐配置 :
    • 若需统一默认行为,可设置为 GenericJackson2JsonRedisSerializer。
  • 适用场景:快速配置全局序列化方式。

对比表格

属性 作用域 默认值 推荐序列化器 适用场景
keySerializer Redis 键 JdkSerialization StringRedisSerializer 确保键为可读字符串
valueSerializer Redis 值 JdkSerialization GenericJackson2Json Fastjson 复杂对象或需要类型信息的场景
hashKeySerializer 哈希字段(field) 同 keySerializer StringRedisSerializer 确保哈希键可读
hashValueSerializer 哈希值(value) 同 valueSerializer Jackson2Json Fastjson 结构化哈希值(如对象属性)
stringSerializer 基础字符串配置 StringRedisSerializer 无需修改(直接使用) 统一字符串处理
defaultSerializer 全局默认值 JdkSerialization GenericJackson2Json 快速统一序列化配置

配置示例

java 复制代码
@Bean
public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
    RedisTemplate<String, Object> template = new RedisTemplate<>();
    template.setConnectionFactory(factory);
    
    // 1. 键的序列化器(推荐 String)
    template.setKeySerializer(new StringRedisSerializer());
    
    // 2. 值的序列化器(推荐 JSON)
    template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
    
    // 3. 哈希键的序列化器(与 key 保持一致)
    template.setHashKeySerializer(new StringRedisSerializer());
    
    // 4. 哈希值的序列化器(固定类型可选 Jackson2Json)
    template.setHashValueSerializer(new Jackson2JsonRedisSerializer<>(User.class));
    
    // 5. stringSerializer 默认已配置,可继承
    template.setStringSerializer(new StringRedisSerializer());
    
    // 6. defaultSerializer 全局默认(可选)
    template.setDefaultSerializer(new GenericJackson2JsonRedisSerializer());
    
    return template;
}

总结建议

  1. 键和哈希键 :始终使用 StringRedisSerializer,确保可读性。
  2. 值和哈希值 :
    • 复杂对象 → GenericJackson2JsonRedisSerializer(自动类型)。
    • 固定类型 → Jackson2JsonRedisSerializer 或 Fastjson。
  3. 全局配置 :
    • 通过 stringSerializer 统一基础字符串处理。
    • defaultSerializer 用于快速覆盖未显式配置的场景。

根据具体需求选择序列化器,平衡性能、可读性和类型安全性!

相关推荐
Discipline10294 小时前
尼泊尔河流流量:天气驱动的预测与高流量风险
人工智能·算法
XuCoder5 小时前
改一个数,右边全得重算,这题怎么扛住两万次查询
算法
小羊没烦恼!5 小时前
在Scrum中实施敏捷建模
java·开发语言·windows·算法·c#
weixin_307779135 小时前
基于睿擎工业开发平台的预训练视觉模型轻量化适配与低代码部署优化
开发语言·算法
hold?fish:palm6 小时前
45 二叉树的右视图
开发语言·c++·算法
粤鼎恒业6 小时前
惠州工厂电子料回收厂家推荐:从交接单反推筛选标准
大数据·数据库·算法·硬件架构·硬件工程·pcb工艺·材料工程
小爷毛毛(卓寿杰)6 小时前
【Agent 意图识别】输出协议、评估与置信度
人工智能·算法·大模型·prompt·大语言模型·agent
优质酸酸乳6 小时前
力扣100题之21合并两个有序链表
算法·leetcode·链表
旖旎夜光7 小时前
LeetCode 137 : 只出现一次的数字 II(位运算) —— 题解
c++·笔记·学习·算法·leetcode·力控
旋生万物7 小时前
Agent System Prompt 注入螺旋公理:让 AI 推理不跑偏的可复制模板(附完整 Prompt)
人工智能·算法