JPA/Hibernate嵌套JSON的geo字段映射到ADDRESS单表实现方法问询

你可以通过以下两种常用方案实现需求，无需单独创建GEO表，同时兼容JSON反序列化逻辑： #

方案1：使用JPA @Embeddable 可嵌入对象（推荐，结构清晰） #

实现逻辑： #

将Geo定义为可嵌入类，JPA会自动将其内部属性映射到Address主表的字段，Jackson天然支持嵌套对象的序列化/反序列化，原有RestTemplate调用代码无需修改。

步骤1：定义可嵌入的Geo类 #

import jakarta.persistence.Embeddable;
// JPA低版本使用javax.persistence包

@Embeddable
public class Geo {
    private String lat;
    private String lng;

    // 必须保留无参构造
    public Geo() {}

    // Getter和Setter
    public String getLat() { return lat; }
    public void setLat(String lat) { this.lat = lat; }
    public String getLng() { return lng; }
    public void setLng(String lng) { this.lng = lng; }
}

步骤2：修改Address实体类配置 #

import jakarta.persistence.*;
// JPA低版本使用javax.persistence包

@Entity
public class Address {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String street;
    private String suite;
    private String city;
    private String zipcode;

    @Embedded
    // 自定义映射到Address表的列名，可按需修改
    @AttributeOverrides({
        @AttributeOverride(name = "lat", column = @Column(name = "geo_lat")),
        @AttributeOverride(name = "lng", column = @Column(name = "geo_lng"))
    })
    private Geo geo;

    // 无参构造、所有字段的Getter和Setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getStreet() { return street; }
    public void setStreet(String street) { this.street = street; }
    public String getSuite() { return suite; }
    public void setSuite(String suite) { this.suite = suite; }
    public String getCity() { return city; }
    public void setCity(String city) { this.city = city; }
    public String getZipcode() { return zipcode; }
    public void setZipcode(String zipcode) { this.zipcode = zipcode; }
    public Geo getGeo() { return geo; }
    public void setGeo(Geo geo) { this.geo = geo; }
}

效果： #

• JPA自动在ADDRESS表生成geo_lat、geo_lng两个字段，无额外表生成
• RestTemplate无需修改，直接可以完成JSON到Address对象的转换
• 序列化返回JSON时自动保留geo嵌套结构，符合接口规范

方案2：直接在Address类新增lat/lng字段（无需额外创建Geo类） #

实现逻辑： #

通过Jackson的@JsonSetter注解处理嵌套的geo节点，手动赋值给Address类的lat/lng字段，JPA直接映射这两个字段到主表。

代码实现： #

import com.fasterxml.jackson.annotation.JsonSetter;
import jakarta.persistence.*;
// JPA低版本使用javax.persistence包

@Entity
public class Address {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String street;
    private String suite;
    private String city;
    private String zipcode;
    // 直接新增lat、lng字段，JPA自动映射为表列
    private String lat;
    private String lng;

    // 处理JSON反序列化时的geo嵌套节点
    @JsonSetter("geo")
    public void parseGeoFromJson(Map<String, String> geoMap) {
        if (geoMap != null) {
            this.lat = geoMap.get("lat");
            this.lng = geoMap.get("lng");
        }
    }

    // 如果需要序列化返回嵌套geo结构，可新增以下注解
    // @JsonGetter("geo")
    // public Map<String, String> formatGeoToJson() {
    //     return Map.of("lat", this.lat, "lng", this.lng);
    // }

    // 其他字段的Getter和Setter
}

效果： #

• ADDRESS表直接生成lat、lng列，无额外类和表
• 原有RestTemplate调用逻辑无需修改

内容的提问来源于stack exchange，提问作者Ramachandran Periyasamy