Spring Data JPA 入门

这一课你将能做到

1. 定义 JPA 实体并映射到表，用注解控制主键策略、列名和枚举存储
2. 用方法名派生查询零 SQL 实现常用检索，分页一行代码搞定
3. 对比 JPA 与 MyBatis 的适用场景，能说清 save 的更新原理和 N+1 问题

为什么要学

上一课 MyBatis 的思路是「SQL 由你写，框架帮你搬」；这一课的 JPA 反过来——你描述「实体长什么样、要查什么」，框架自己生成 SQL。标准 CRUD 一个 SQL 都不用写，改个字段连 SQL 都不用动。

JPA（Java Persistence API，现为 Jakarta Persistence）是 ORM 规范，Hibernate 是它的参考实现，Spring Data JPA 再封装一层仓库接口。国内业务系统 MyBatis 系占多数，但 JPA 在海外项目、快速原型、领域驱动设计项目中非常常见，而且「实体映射、主键策略、关联关系」这些概念两边通用。两个都会，选型时才有话语权。

先建立图像

三层关系一图流：

你的代码
TaskRepository extends JpaRepository   ← Spring Data 提供 CRUD 实现
        ↓ 操作的是
Task 实体（@Entity，映射 task 表）
        ↓ 实际执行
Hibernate（JPA 实现）负责生成 SQL、管理实体状态、脏检查
        ↓
数据库

JPA 最特别的概念是实体有「状态」：从库里查出来的对象被 Hibernate「托管」，你改了它的字段，事务提交时 Hibernate 自动比对并发 UPDATE——不用显式调用 update。这个「脏检查」机制是 save 行为、N+1 问题、缓存问题的共同源头。

名词	人话
Entity	被 @Entity 标注、与表一一对应的类
Repository	数据访问接口，方法名即查询语句
持久化上下文	Hibernate 的「托管区」，管着本事务内所有实体的状态
脏检查	事务提交前对比实体快照，变了就自动 UPDATE

跟着做

步骤 1：引入依赖与配置

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

spring:
  jpa:
    hibernate:
      ddl-auto: update        # 开发期自动按实体更新表结构；生产禁用，用迁移工具
    show-sql: true            # 控制台打印 SQL
    properties:
      hibernate:
        format_sql: true

注意与上一课互斥：JDBC/MyBatis 与 JPA 都引时数据源共用没问题，但别让两套框架建同一张表。本课建议把上一课的 schema.sql 暂时移走，让 JPA 自己建表。

步骤 2：定义实体

package com.example.taskflow.entity;

import jakarta.persistence.*;
import java.time.LocalDateTime;

@Entity
@Table(name = "task")
public class Task {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)   // 数据库自增
    private Long id;

    @Column(nullable = false, length = 50)
    private String title;

    @Column(nullable = false)
    private Integer priority;

    @Enumerated(EnumType.STRING)      // 枚举按名字存 varchar，别用 ORDINAL
    @Column(nullable = false, length = 20)
    private TaskStatus status = TaskStatus.TODO;

    @Column(name = "created_at", nullable = false, updatable = false)
    private LocalDateTime createdAt;

    @PrePersist                       // 插入前回调：自动填创建时间
    public void prePersist() {
        if (createdAt == null) createdAt = LocalDateTime.now();
    }

    // JPA 实体规范要求：必须有无参构造（protected 即可）
    protected Task() { }

    public Task(String title, Integer priority) {
        this.title = title;
        this.priority = priority;
    }

    // getter/setter 全部生成（IDE: Alt+Insert），此处省略
    public Long getId() { return id; }
    public String getTitle() { return title; }
    public Integer getPriority() { return priority; }
    public TaskStatus getStatus() { return status; }
    public void setStatus(TaskStatus status) { this.status = status; }
    public LocalDateTime getCreatedAt() { return createdAt; }

    public enum TaskStatus { TODO, DOING, DONE }
}