JPA、Hibernate 与 Spring Data：实体状态、映射和查询

调用 save 或修改实体字段时，数据库未必就在那一行立刻更新。理解实体状态、持久化上下文和 flush，才能读懂 JPA 程序。下面也会区分规范、Hibernate 实现和 Spring Data 仓库，避免把三者混叫成一个东西。

Jakarta Persistence 是规范，Hibernate 是常见实现，Spring Data JPA 在其上提供仓库抽象；三者的职责需要分开理解。

1. 本文覆盖范围

  • 实体生命周期与持久化上下文
  • 关联、继承和值对象映射
  • JPQL、Criteria、Specification 与原生 SQL
  • 抓取策略、锁和批处理

2. 核心知识详解

1. 持久化上下文与脏检查

实体处于 transient、managed、detached、removed 等状态。持久化上下文保证同一标识的对象身份，并在 flush 时通过脏检查生成 SQL。

  • persist 管理新实体，merge 返回受管副本，原对象仍可能是 detached。
  • flush 将变更同步到数据库连接，不等于事务已经提交。
  • 长事务会让上下文积累对象，批处理时分批 flush/clear。

这里容易混淆的是： 看到对象字段已变不代表其他事务已可见；可见性由数据库隔离和提交决定。

2. 关联与聚合边界

一对一、一对多、多对一和多对多映射描述对象关系，但领域聚合和数据库外键仍需独立设计。

  • 双向关联由 owning side 写入外键，双方对象引用由业务代码保持一致。
  • 集合默认避免 EAGER；查询用 fetch join、EntityGraph 或 DTO 投影显式取数。
  • 多对多含业务属性时建独立关联实体。

这里容易混淆的是： 把所有关系设为 EAGER 会产生笛卡尔积、重复数据或不可控查询，并不等于消除 N+1。

3. 查询抽象选择

派生查询适合简单条件；JPQL 面向实体；Specification/Criteria 适合组合条件；复杂报表或方言特性可用原生 SQL/专用查询层。

  • 列表接口优先 DTO 投影，避免序列化实体图。
  • 分页同时提供稳定排序，并审查 count 查询成本。
  • 查询结果数量和 SQL 次数纳入自动化测试。

这里容易混淆的是： Repository 方法名很长通常说明查询语义已超出派生查询的可读范围。

4. 并发控制与批处理

乐观锁通过版本列检测丢失更新，悲观锁由数据库锁定记录/范围。批处理还受主键生成策略、flush 频率和 JDBC batching 影响。

  • 捕获乐观锁冲突后按业务语义提示或有限重试。
  • 锁顺序固定、事务短小，减少死锁窗口。
  • 批量导入与在线事务使用不同资源配额。

这里容易混淆的是： 自动重试整个非幂等业务可能重复外部副作用；重试边界必须明确。

3. 工程链路

stateDiagram-v2 [*] --> Transient Transient --> Managed: persist Managed --> Detached: clear/close Detached --> Managed: merge 返回副本 Managed --> Removed: remove Managed --> Database: flush SQL

4. 教学示例（结合本章运行前提）

@Version 用来参与乐观锁检查，关联集合则描述订单与明细的关系。例子省略了明细实体、双向关系维护和访问方法；它用于观察映射含义，不是完整项目。还要通过 SQL 日志确认 flush 时实际发出了什么语句。

java
@Entity
class PurchaseOrder {
  @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

  @Version
  private long version;

  @OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
  private List<OrderLine> lines = new ArrayList<>();
}

5. 实践与验证

  1. 建立订单、订单项和值对象映射，写出数量、SQL 次数和事务边界测试。
  2. 演示 N+1、fetch join、DTO 投影三种方案并比较结果。
  3. 用 @Version 构造并发更新冲突。

6. 掌握检查

  • 能区分规范、实现和仓库抽象。
  • 能解释 flush/commit。
  • 能选择抓取策略。
  • 能处理乐观锁冲突。

参考资料