Java 后端 / 系统课时

映射实体关联关系

映射实体关联关系

本课解决实体之间如何建立安全关联的问题。你将以订单与明细的一对多关系为例,明确拥有方、双向同步、级联与孤儿删除的职责,并用测试验证删除明细不会误删订单。

学习目标

  • 判断关联关系的拥有方并正确配置外键
  • 区分级联操作与孤儿删除的生效范围
  • 使用辅助方法维护双向关联的一致性

建立关联心智模型

关系型数据库通过外键保存关联,JPA 则用对象引用表达同一关系。以订单和订单明细为例,外键位于 order_item.order_id,因此明细实体是关系拥有方;订单上的集合只是反向映射。

订单与明细关联、拥有方和删除行为

mappedBy = "order" 中的 order 必须与明细实体里的属性名一致。只有拥有方写入外键;如果只向订单集合添加明细,却没有设置 item.order,数据库关系就可能没有建立。

编写安全的一对多映射

下面的完整测试文件依赖 Spring Boot 3、Spring Data JPA、H2 和 AssertJ。辅助方法同时修改集合与反向引用,避免内存对象和数据库外键表达不同的关系。

java
package com.example.demo;

import jakarta.persistence.CascadeType;
import jakarta.persistence.Entity;
import jakarta.persistence.FetchType;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import jakarta.persistence.JoinColumn;
import jakarta.persistence.ManyToOne;
import jakarta.persistence.OneToMany;
import jakarta.persistence.Table;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.boot.test.autoconfigure.orm.jpa.TestEntityManager;
import org.springframework.test.context.TestPropertySource;

import java.util.ArrayList;
import java.util.List;

import static org.assertj.core.api.Assertions.assertThat;

@Entity
@Table(name = "purchase_order")
class PurchaseOrder {
    @Id
    @GeneratedValue
    private Long id;

    private String orderNo;

    // mappedBy 指向拥有方属性;订单集合本身不写外键。
    @OneToMany(
            mappedBy = "order",
            cascade = CascadeType.ALL,
            orphanRemoval = true
    )
    private final List<OrderItem> items = new ArrayList<>();

    protected PurchaseOrder() {
    }

    PurchaseOrder(String orderNo) {
        this.orderNo = orderNo;
    }

    // 所有关系变更都同时维护两端,避免内存状态不一致。
    void addItem(OrderItem item) {
        items.add(item);
        item.attachTo(this);
    }

    void removeItem(OrderItem item) {
        items.remove(item);
        item.detach();
    }

    Long getId() {
        return id;
    }

    List<OrderItem> getItems() {
        return items;
    }
}

@Entity
@Table(name = "order_item")
class OrderItem {
    @Id
    @GeneratedValue
    private Long id;

    private String productName;

    // 外键位于明细表,因此 OrderItem 是关系拥有方。
    @ManyToOne(fetch = FetchType.LAZY, optional = false)
    @JoinColumn(name = "order_id", nullable = false)
    private PurchaseOrder order;

    protected OrderItem() {
    }

    OrderItem(String productName) {
        this.productName = productName;
    }

    void attachTo(PurchaseOrder order) {
        this.order = order;
    }

    void detach() {
        this.order = null;
    }

    Long getId() {
        return id;
    }
}

@DataJpaTest
@TestPropertySource(properties = "spring.jpa.hibernate.ddl-auto=create-drop")
class OrderMappingTest {
    @Autowired
    private TestEntityManager entityManager;

    @Test
    void shouldDeleteRemovedItemButKeepOrder() {
        PurchaseOrder order = new PurchaseOrder("A-1001");
        OrderItem keyboard = new OrderItem("Keyboard");
        OrderItem mouse = new OrderItem("Mouse");
        order.addItem(keyboard);
        order.addItem(mouse);

        // CascadeType.ALL 使两个明细随订单一起持久化。
        entityManager.persistAndFlush(order);
        Long orderId = order.getId();
        Long removedItemId = keyboard.getId();

        order.removeItem(keyboard);
        // orphanRemoval 在 flush 时把脱离集合的明细删除。
        entityManager.flush();
        entityManager.clear();

        PurchaseOrder reloaded =
                entityManager.find(PurchaseOrder.class, orderId);
        OrderItem removed =
                entityManager.find(OrderItem.class, removedItemId);

        assertThat(reloaded).isNotNull();
        assertThat(reloaded.getItems()).hasSize(1);
        assertThat(removed).isNull();
    }
}

运行测试:

bash
./mvnw -Dtest=OrderMappingTest test

预期输出:

text
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

本地日志中的时间和临时数据库路径可能不同,但测试应证明订单仍存在、被移除的明细已删除。

区分级联与孤儿删除

cascade = CascadeType.ALL 表示对订单执行持久化、合并、删除等操作时,相应操作可传播到明细。它描述的是“父对象操作如何传播”,不等于数据库外键的 ON DELETE CASCADE。

orphanRemoval = true 描述的是“子对象不再属于父集合时怎么办”。当明细从 items 中移除并发生 flush,Hibernate 会删除该明细。若业务只是暂时解除关系而不应删除记录,就不能启用孤儿删除,且外键必须允许表达新的归属状态。

避免无意的数据变更

级联方向通常从聚合根指向内部子实体,不应轻易从 @ManyToOne 子实体反向级联到父实体。否则删除一条明细时,可能把订单一并删除。

双向关系必须通过 addItem、removeItem 这类领域方法统一维护,不要让调用者分别修改两端。对于带数量、价格或有效期等业务属性的多对多关系,应建立独立关联实体,而不是直接使用 @ManyToMany,这样才能安全更新和审计关系本身。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

映射实体关联关系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通