如何用JPA将含嵌套对象的Java实体映射到MySQL单表？

针对你遇到的问题，最适合的方案是使用JPA的**嵌入式对象（@Embeddable + @Embedded）**机制，把CardHolderInfo作为值对象嵌入到主实体中，直接将其fullName属性映射到数据库的CARD_HOLDER_FULL_NAME列。以下是具体实现步骤：

1. 定义嵌入式的CardHolderInfo类 #

用@Embeddable注解标记这个类，同时在fullName属性上指定对应的数据库列名：

import jakarta.persistence.Embeddable;
import jakarta.persistence.Column;

@Embeddable
public class CardHolderInfo {
    @Column(name = "CARD_HOLDER_FULL_NAME")
    private String fullName;

    // JPA要求必须有无参构造函数
    public CardHolderInfo() {}

    // 可选的带参构造函数，方便实例化
    public CardHolderInfo(String fullName) {
        this.fullName = fullName;
    }

    // 必须提供getter和setter，JPA需要访问属性
    public String getFullName() {
        return fullName;
    }

    public void setFullName(String fullName) {
        this.fullName = fullName;
    }
}

2. 在主实体中嵌入CardHolderInfo #

假设你的主实体是Card（对应数据库表），用@Embedded注解引入CardHolderInfo对象：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Embedded;
import jakarta.persistence.Table;

@Entity
@Table(name = "你的数据库表名") // 替换成实际表名
public class Card {
    @Id
    private Long id; // 根据你的主键类型调整，比如String或Long
    
    @Embedded
    private CardHolderInfo cardHolderInfo;

    // 其他实体属性（比如卡号、有效期等）
    // private String cardNumber;
    // private LocalDate expiryDate;

    // 无参构造函数、带参构造函数、getter和setter
    public Card() {}

    public Card(Long id, CardHolderInfo cardHolderInfo) {
        this.id = id;
        this.cardHolderInfo = cardHolderInfo;
    }

    // getter和setter
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public CardHolderInfo getCardHolderInfo() {
        return cardHolderInfo;
    }

    public void setCardHolderInfo(CardHolderInfo cardHolderInfo) {
        this.cardHolderInfo = cardHolderInfo;
    }
}

3. 覆盖列名的备用方案（可选） #

如果CardHolderInfo类已经定义好，且没有在属性上指定@Column，可以在主实体中用@AttributeOverride强制指定列名：

@Embedded
@AttributeOverride(name = "fullName", column = @Column(name = "CARD_HOLDER_FULL_NAME"))
private CardHolderInfo cardHolderInfo;

4. 编写Rest Controller和Repository #

JPA Repository接口 #

import org.springframework.data.jpa.repository.JpaRepository;

public interface CardRepository extends JpaRepository<Card, Long> {
}

Rest Controller接收POST请求 #

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class CardController {
    private final CardRepository cardRepository;

    // 构造函数注入Repository（Spring 4.3+支持）
    public CardController(CardRepository cardRepository) {
        this.cardRepository = cardRepository;
    }

    @PostMapping("/cards")
    public Card createCard(@RequestBody Card card) {
        // 直接保存实体到数据库
        return cardRepository.save(card);
    }
}

测试请求示例 #

你可以用Postman或curl发送POST请求，请求体格式如下：

{
    "id": 1,
    "cardHolderInfo": {
        "fullName": "张三"
    }
}

这样发送请求后，JPA会自动把cardHolderInfo.fullName的值存入数据库的CARD_HOLDER_FULL_NAME列中。

内容的提问来源于stack exchange，提问作者Icy B