You need to enable JavaScript to run this app. Spring Data JDBC 如何映射 PostgreSQL jsonb 字段为 Java POJO
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 07:15:08