Java 后端 / 系统课时
映射实体关联关系
映射实体关联关系
本课解决实体之间如何建立安全关联的问题。你将以订单与明细的一对多关系为例,明确拥有方、双向同步、级联与孤儿删除的职责,并用测试验证删除明细不会误删订单。
学习目标
- 判断关联关系的拥有方并正确配置外键
- 区分级联操作与孤儿删除的生效范围
- 使用辅助方法维护双向关联的一致性
建立关联心智模型
关系型数据库通过外键保存关联,JPA 则用对象引用表达同一关系。以订单和订单明细为例,外键位于 order_item.order_id,因此明细实体是关系拥有方;订单上的集合只是反向映射。

mappedBy = "order" 中的 order 必须与明细实体里的属性名一致。只有拥有方写入外键;如果只向订单集合添加明细,却没有设置 item.order,数据库关系就可能没有建立。
编写安全的一对多映射
下面的完整测试文件依赖 Spring Boot 3、Spring Data JPA、H2 和 AssertJ。辅助方法同时修改集合与反向引用,避免内存对象和数据库外键表达不同的关系。
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();
}
}运行测试:
./mvnw -Dtest=OrderMappingTest test预期输出:
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,这样才能安全更新和审计关系本身。