Spring Data JPA：数据库交互的“老司机”！

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

什么是 Spring Data JPA？ 🤔

Spring Data JPA 是一个让你轻松玩转数据库操作的利器！它基于 JPA（Java Persistence API）来实现，简化了 Java 应用程序与数据库之间的交互。大多数时候，我们都得自己编写大量的数据库操作代码，比如插入、查询、更新和删除（CRUD）。但有了 Spring Data JPA，很多事情都会变得自动化——框架会根据你定义的方法名自动生成 SQL 查询，甚至自动管理分页、排序等功能。是不是觉得编写数据库操作的工作变得更轻松了呢？🕺

🧩 Spring Data JPA 的优势

• 自动化查询：你只需要按照一定的规则定义方法，Spring Data JPA 就会自动生成相应的 SQL 查询，极大地减少了开发人员的负担。你不用再为每一条 SQL 语句头疼，框架帮你搞定一切！😎
• 代码简洁：通过继承 JpaRepository 或 CrudRepository，大大减少了我们写的样板代码。让你专注于业务逻辑，避免了重复造轮子。⏱️
• 分页与排序：Spring Data JPA 内建的分页与排序功能，可以让你轻松处理大数据量的查询，而不必自己写复杂的分页逻辑！📈
• 与 Spring 兼容：它是 Spring 项目的一部分，和 Spring Boot、Spring Security 等框架无缝集成，给你带来更好的开发体验。🛠️

如何创建 Repository 接口与查询方法 📚

Spring Data JPA 的核心就是 Repository 接口。我们可以通过继承 JpaRepository 或 CrudRepository 来创建自己的 Repository，然后用方法名定义查询。

🛠️ 创建一个 Repository 接口：

首先，我们需要定义一个 Repository 接口来管理我们与数据库之间的交互。假设我们有一个 User 实体类：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 你可以在这里定义更多的查询方法
}

这里的 UserRepository 继承了 JpaRepository，它自动继承了很多常用的方法，比如 save()、findById()、findAll() 等，你不再需要手动编写这些基本的数据库操作代码。这就像你请了个“数据库管家”来帮你打理一切。🤖

🔍 自定义查询方法：

Spring Data JPA 最大的魅力之一就是它的查询方法命名规则。通过定义方法名，Spring Data JPA 会自动根据方法名生成 SQL 查询。举个例子，假如你想通过 username 查找 User，你只需要定义如下方法：

public interface UserRepository extends JpaRepository<User, Long> {
    User findByUsername(String username);
}

当你调用这个方法时，Spring Data JPA 会自动生成一条 SQL 查询：

SELECT * FROM user WHERE username = ?;

是不是觉得省事又高效？这就像一个自动化的查询机器，只要你按规范命名，它就会帮你处理数据库查询。😌

⚡ 方法名的命名规则：

为了让你充分利用这种自动查询功能，Spring Data JPA 定义了一套规则，帮助你根据方法名生成查询。常见的命名规则包括：

• findBy：表示查找某个字段。例如，findByUsername(String username)。
• findByXAndY：多个条件查询。例如，findByUsernameAndEmail(String username, String email)。
• findTopXBy...：查询前 X 条记录。例如，findTop5ByOrderByCreatedAtDesc()，表示查询按创建时间倒序排列的前五个用户。
• countBy：统计某个字段的数量。例如，countByUsername(String username)。

这种方式让你几乎不需要写 SQL，就能完成基本的查询操作。📦

使用 JpaRepository 和 CrudRepository 👨‍💻

Spring Data JPA 提供了两种常用的接口：CrudRepository 和 JpaRepository。它们的区别在哪呢？让我们一探究竟！

🧭 CrudRepository：

CrudRepository 是一个通用接口，提供了最基本的 CRUD（增、删、改、查）操作。如果你的业务比较简单，只需要做基本的数据库操作，那么 CrudRepository 就已经足够了。

例如，CrudRepository 提供了以下常用方法：

• save(): 保存实体
• findById(): 根据 ID 查找实体
• findAll(): 查询所有记录
• deleteById(): 根据 ID 删除记录

public interface UserRepository extends CrudRepository<User, Long> {
    // 没有额外复杂的查询需求
}

🧰 JpaRepository：

相比之下，JpaRepository 是 CrudRepository 的扩展，提供了更强大的功能。它支持分页和排序，也提供了更多查询选项，适合有较复杂查询需求的项目。

JpaRepository 继承了 PagingAndSortingRepository，这意味着它不仅支持基本的 CRUD 操作，还支持分页和排序功能。更进一步，它也可以处理复杂的查询需求。

public interface UserRepository extends JpaRepository<User, Long> {
    // 支持分页和排序
    Page<User> findByUsername(String username, Pageable pageable);
}

总结一下：

• CrudRepository：适用于简单的 CRUD 操作。
• JpaRepository：适用于复杂查询、分页、排序等功能，功能更强大。

查询方法命名规则与自定义查询 ✨

Spring Data JPA 最为人称道的就是它的 查询方法命名规则。它让你通过方法名自动生成查询，几乎不需要手动写 SQL。如果你知道了这些规则，那就能大大提高开发效率！🚀

📏 常见命名规则示例：

• findBy：通过某字段查找数据。例如，findByEmail(String email) 会生成 SELECT * FROM user WHERE email = ?。
• findByXAndY：多个条件查询。例如，findByUsernameAndStatus(String username, String status) 会生成 SELECT * FROM user WHERE username = ? AND status = ?。
• findTopXBy...：查询前 X 条记录。例如，findTop3ByOrderByCreatedAtDesc() 会生成查询语句，按 createdAt 字段降序排序，并只返回前三条记录。
• countBy：统计某字段的数量。例如，countByStatus(String status) 会生成 SELECT COUNT(*) FROM user WHERE status = ?。

这些命名规则不仅简化了开发工作，还让你在没有 SQL 的情况下实现了常见的查询。

🔎 自定义查询：

有时，命名规则可能不能满足你的复杂需求。这时，你可以使用 @Query 注解来进行自定义查询。

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u FROM User u WHERE u.email = ?1")
    User findUserByEmail(String email);
}

这段代码中，我们使用了 JPQL（Java Persistence Query Language），它和 SQL 类似，但是操作的是 JPA 实体而非数据库表。

你还可以在 @Query 注解中编写更加复杂的查询，包括多表联合查询、聚合查询等。这样，你就不再局限于简单的命名规则了。💡

分页与排序功能 📊

对于大数据量的查询，分页和排序是不可避免的。Spring Data JPA 提供了强大的分页和排序支持，你只需要传递一个 Pageable 或 Sort 对象，它就能帮你处理分页与排序。

🧭 分页查询：

假设你有一个庞大的用户表，你不希望一次性查询所有记录，那么分页查询就显得尤为重要。Spring Data JPA 允许你通过 Pageable 对象实现分页查询。

public Page<User> findByUsername(String username, Pageable pageable);

在这个方法中，Pageable 是一个接口，它包含了当前页、每页数据量等信息。Spring 会根据 Pageable 对象来自动分配查询的偏移量和限制，避免一次性加载大量数据，提升性能。

🔄 排序查询：

public List<User> findAll(Sort sort);

通过 Sort 对象，你可以控制查询结果的排序方式，按指定字段升序或降序排列。

例如，你可以按用户名升序排序：

List<User> users = userRepository.findAll(Sort.by(Sort.Order.asc("username")));

分页和排序功能的结合让你在面对庞大的数据集时不再头痛。你可以轻松控制每次查询返回的数据量和顺序，确保系统性能稳定。📈

结语 📜

通过使用 Spring Data JPA，你可以轻松实现高效的数据库交互，自动化生成 SQL 查询，减少开发工作量，同时又能享受到分页、排序等强大功能。无论是复杂的查询，还是简单的增删改查，Spring Data JPA 都能帮你省时省力，提升开发效率。

所以，不再纠结于那些冗长的 SQL 语句，和 Spring Data JPA 一起，让你的数据库操作变得更简单、更高效！🚀

希望这篇文章能帮助你深入理解 Spring Data JPA，让你在项目中大显身手！💪

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

  最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

  同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-