跳到主要内容

类型支持

Redis 按键和原生数据结构组织数据。下表列出常用命令结果对应的 Java 类型。Java/JDBC 类型见 Java/JDBC 类型关系。

类型映射​

Redis 数据类型Java 类型说明
StringStringGET 结果通常读取为 String；格式约定明确时可选 Long、Boolean、java.sql.Date 或 Instant。
StringMap / List / Bean保存 JSON 文本时，配置方式见 JSON 字段映射。
StringEnum保存枚举名称；指定具体枚举类，并保证字段值与枚举常量一致。
StringBigDecimal保存十进制文本，按 BigDecimal 读取时保留精度。
StringBigInteger保存整数文本，按 BigInteger 读取。
String（二进制内容）byte[]SET 接受字节数组；GET 的键参数使用 byte[]，读取原始字节。
HashStringHGETALL 的每行键和值均按 String 读取。
ListStringLRANGE 的每个结果行包含一个 String 元素。
SetStringSMEMBERS 的每个结果行包含一个 String 元素。
Sorted SetDouble带分数查询的分值；属于近似数值，不用于要求十进制精确计算的金额。

基础类型​

保存空字符串请使用 SET/HSET 等原生命令；构造器 API 不提供 Redis 的实体插入。

支持数字、布尔、字符和空字符串读写，但不能将 SQL NULL 保存为 Redis 值。需要表示未填写时删除键，见缺失值处理。

时间类型​

非空日期、时间可以通过类型处理器转换。不能把 Java null 保存为 Redis 值；需要清空时删除键，见缺失值处理。

枚举类型​

非空枚举名称、编码和数值可以通过对应处理器转换。空枚举不能作为 Redis 值保存，见缺失值处理。

JSON 序列化​

支持将对象和集合保存为 JSON 文本，不支持 SQL NULL 的写入与往返读取。JSON 文本 null 不等于 Redis 缺失值；需要表示不存在时，见缺失值处理。

二进制类型​

支持非空字节数组读写，不支持保存 null 字节数组。需要清空时见缺失值处理。

文本键按 UTF-8 编码后仍是同一个 Redis 键。读取时绑定字节数组键，选择原始字节结果，避免文本解码损坏数据。

import java.nio.charset.StandardCharsets;

String key = "demo:binary";
byte[] content = new byte[] { 0, (byte) 255, (byte) 128 };
jdbc.executeUpdate("SET ? ?", new Object[] { key, content });
byte[] loaded = jdbc.queryForObject("GET ?",
        new Object[] { key.getBytes(StandardCharsets.UTF_8) }, byte[].class);

普通字符串键的 GET 保持文本结果；SET 的键或值为 byte[] 时使用二进制写入，SET ... GET 同时返回旧值的原始字节。

使用限制​

  • 精确小数使用 SET／GET 存取，不通过浮点数增量命令计算。
  • Redis List／Set 是原生结构，不是 JDBC ARRAY。

数组类型​

Redis List、Set 不通过 JDBC ARRAY 映射读写。集合应使用列表、集合命令，或按JSON 字段映射保存。

缺失值​

Redis 不保存 SQL NULL，空枚举、空字节数组也不能作为值保存。需要表示不存在时删除键或 Hash 字段，见空值参数。