Spring Data JDBC 如何映射 PostgreSQL jsonb 字段为 Java POJO
核心结论
这种操作完全可行,且没有超出Spring Data JDBC的支持范围,Spring Data JDBC 从早期版本就提供了自定义类型转换的扩展点,不需要额外引入重型ORM框架,通过少量配置即可实现jsonb字段到Java POJO的自动映射。
实现步骤
1. 依赖准备
因为你的Address类已经使用了Jackson的@JsonProperty注解做字段映射,直接复用Spring容器中默认配置的ObjectMapper即可,不需要重复引入额外的JSON处理库,常规Spring Boot工程已经自带该依赖。
2. 实现双向类型转换器
需要实现两套转换逻辑,分别覆盖读库、写库的场景:
- 写库转换器:将Java端的
Address对象,序列化后转为PostgreSQL可识别的jsonb类型参数@WritingConverter public class AddressToJsonbConverter implements Converter<Address, PGobject> { private final ObjectMapper objectMapper; public AddressToJsonbConverter(ObjectMapper objectMapper) { this.objectMapper = objectMapper; } @Override public PGobject convert(Address source) { try { PGobject pgObject = new PGobject(); pgObject.setType("jsonb"); pgObject.setValue(objectMapper.writeValueAsString(source)); return pgObject; } catch (JsonProcessingException | SQLException e) { throw new TypeConversionException("Address对象转jsonb格式失败", e); } } } - 读库转换器:将数据库查询返回的jsonb字符串,反序列化为
Address类型的Java对象@ReadingConverter public class JsonbToAddressConverter implements Converter<PGobject, Address> { private final ObjectMapper objectMapper; public JsonbToAddressConverter(ObjectMapper objectMapper) { this.objectMapper = objectMapper; } @Override public Address convert(PGobject source) { if (source.getValue() == null) { return null; } try { return objectMapper.readValue(source.getValue(), Address.class); } catch (JsonProcessingException e) { throw new TypeConversionException("jsonb格式转Address对象失败", e); } } }
3. 注册转换器到Spring Data JDBC
通过自定义配置类把上述转换器注册到Spring Data JDBC的转换体系中,实体类不需要加任何额外的特殊注解:
@Configuration public class JdbcConfig extends AbstractJdbcConfiguration { private final ObjectMapper objectMapper; public JdbcConfig(ObjectMapper objectMapper) { this.objectMapper = objectMapper; } @Override @Bean public JdbcCustomConversions jdbcCustomConversions() { return new JdbcCustomConversions(Arrays.asList( new AddressToJsonbConverter(objectMapper), new JsonbToAddressConverter(objectMapper) )); } }
注意事项
- 上述配置完成后,你的
Buddy实体类中的address字段会被自动完成映射,不需要手动从jsonb字符串反序列化、也不需要手动把POJO转成JSON字符串存库。 - 如果后续有多个POJO类型需要映射jsonb字段,可以把转换器改造为泛型通用实现,不需要为每个POJO重复编写转换逻辑。
- 避免在实体类中把jsonb字段定义为
String类型再手动做序列化/反序列化,这种方式会丢失Spring Data JDBC的类型安全校验能力。
内容的提问来源于stack exchange,提问作者Paolo bi
相关产品推荐
相关产品推荐

