Spring Data JPA 用于 Java：完整指南及示例

这是什么以及为什么需要它？

Spring Data JPA 是 Spring 生态系统中一个强大的库，它提供了对 Java Persistence API (JPA) 的抽象，以简化与数据库的工作。如果您曾经使用 EntityManager 编写过 DAO（数据访问对象），您就会知道需要编写多少样板代码：打开事务、创建查询、处理结果。Spring Data JPA 通过提供一种声明式的方法来创建存储库，解决了这个问题。

该库的核心思想是，开发人员只需定义一个扩展了某个基本接口（例如 JpaRepository）的存储库接口，Spring Data JPA 就会在运行时自动生成实现。此外，该库支持基于方法名称创建查询：如果您将方法命名为 findByLastName(String lastName)，Spring Data JPA 会自动理解需要执行查询 SELECT * FROM users WHERE last_name = ?。

为什么需要它？首先，它极大地减少了需要编写和维护的代码量。其次，该库通过 JPA 提供了一种统一的方法来处理不同的数据库管理系统（MySQL、PostgreSQL、H2、Oracle 等）。第三，Spring Data JPA 与 Spring 的事务、缓存以及框架的其他组件集成，使得企业级应用程序的开发更加可预测和方便。

安装

Spring Data JPA 不能通过 pip 或 npm 安装，因为它是一个 Java 库。要使用它，需要使用 Maven 或 Gradle 构建系统。以下是两种系统的精确依赖项。

Maven (pom.xml):

<!-- Spring Data JPA 核心依赖 -->\n<dependency>\n    <groupId>org.springframework.boot</groupId>\n    <artifactId>spring-boot-starter-data-jpa</artifactId>\n    <version>3.2.0</version>\n</dependency>\n\n<!-- 数据库驱动（以 PostgreSQL 为例） -->\n<dependency>\n    <groupId>org.postgresql</groupId>\n    <artifactId>postgresql</artifactId>\n    <version>42.7.1</version>\n    <scope>runtime</scope>\n</dependency>

Gradle (build.gradle):

dependencies {\n    implementation 'org.springframework.boot:spring-boot-starter-data-jpa:3.2.0'\n    runtimeOnly 'org.postgresql:postgresql:42.7.1'\n}

添加依赖项后，不要忘记在 application.properties 或 application.yml 文件中配置数据库连接。

# application.properties\nspring.datasource.url=jdbc:postgresql://localhost:5432/mydb\nspring.datasource.username=user\nspring.datasource.password=pass\nspring.jpa.hibernate.ddl-auto=update\nspring.jpa.show-sql=true

快速入门 — 最小工作示例

让我们创建一个简单的用户管理应用程序。我们需要一个实体（Entity）、一个存储库和一个服务。

步骤 1. 创建 User 实体

package com.example.demo.entity;\n\nimport jakarta.persistence.*;\n\n@Entity\n@Table(name = "users")\npublic class User {\n\n    @Id\n    @GeneratedValue(strategy = GenerationType.IDENTITY)\n    private Long id;\n\n    @Column(nullable = false)\n    private String firstName;\n\n    @Column(nullable = false)\n    private String lastName;\n\n    @Column(unique = true, nullable = false)\n    private String email;\n\n    // 构造函数\n    public User() {}\n\n    public User(String firstName, String lastName, String email) {\n        this.firstName = firstName;\n        this.lastName = lastName;\n        this.email = em