SpringBoot指南：JPA连表查询与分页实践详解

谢月连Jed

于 2025-06-08 09:05:08 发布

阅读量288

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00979/article/details/148506132

SpringBoot指南：JPA连表查询与分页实践详解

springboot-guide SpringBoot2.0+从入门到实战！项目地址: https://gitcode.com/gh_mirrors/sp/springboot-guide

引言

在SpringBoot应用开发中，JPA(Java Persistence API)作为ORM框架的规范，极大简化了数据库操作。当业务需求涉及多表关联查询时，JPA提供了灵活的解决方案。本文将深入探讨如何在SpringBoot项目中实现JPA的连表查询和分页功能，帮助开发者掌握这一核心技术。

一、实体类设计基础

在开始连表查询前，我们需要先建立正确的实体关系。假设我们有以下三个核心实体：

Person（人员信息）
Company（公司信息）
School（学校信息）

其中Person与Company、School存在关联关系。这里我们展示Company和School的实体类定义：

// 公司实体
@Entity
@Data
@NoArgsConstructor
public class Company {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(unique = true)
    private String companyName;
    private String description;
    
    // 构造方法
    public Company(String name, String description) {
        this.companyName = name;
        this.description = description;
    }
}

// 学校实体
@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class School {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(unique = true)
    private String name;
    private String description;
}

二、DTO数据传输对象设计

在进行连表查询时，我们通常需要从多个表中提取数据并组合返回。这时使用DTO(Data Transfer Object)模式是最佳实践：

@Data
@NoArgsConstructor
@Builder(toBuilder = true)
@AllArgsConstructor
public class UserDTO {
    private String name;        // 人员姓名
    private int age;           // 人员年龄
    private String companyName; // 公司名称
    private String schoolName;  // 学校名称
}

三、JPA连表查询实现

3.1 基础连表查询

在Repository接口中，我们可以使用@Query注解自定义JPQL实现连表查询：

public interface PersonRepository extends JpaRepository<Person, Long> {
    
    @Query("SELECT new com.example.dto.UserDTO(p.name,p.age,c.companyName,s.name) " +
           "FROM Person p LEFT JOIN Company c ON p.companyId=c.id " +
           "LEFT JOIN School s ON p.schoolId=s.id " +
           "WHERE p.id=:personId")
    Optional<UserDTO> getUserInformation(@Param("personId") Long personId);
}

关键点说明：

使用LEFT JOIN确保即使关联表没有匹配记录也能返回主表数据
ON子句明确指定关联条件
使用构造器表达式直接创建DTO对象

3.2 连表分页查询

分页是Web应用中的常见需求，JPA提供了完美的支持：

@Query(value = "SELECT new com.example.dto.UserDTO(p.name,p.age,c.companyName,s.name) " +
        "FROM Person p LEFT JOIN Company c ON p.companyId=c.id " +
        "LEFT JOIN School s ON p.schoolId=s.id",
        countQuery = "SELECT COUNT(p.id) " +
                "FROM Person p LEFT JOIN Company c ON p.companyId=c.id " +
                "LEFT JOIN School s ON p.schoolId=s.id")
Page<UserDTO> getUserInformationList(Pageable pageable);

使用示例：

// 创建分页请求(第0页，每页3条，按年龄降序)
PageRequest pageRequest = PageRequest.of(0, 3, Sort.Direction.DESC, "age");
Page<UserDTO> pageResult = personRepository.getUserInformationList(pageRequest);

// 获取分页信息
long totalElements = pageResult.getTotalElements(); // 总记录数
int totalPages = pageResult.getTotalPages();       // 总页数
List<UserDTO> content = pageResult.getContent();   // 当前页数据

四、高级查询技巧

4.1 IN查询

处理多值匹配场景：

@Query("SELECT new com.example.dto.UserDTO(p.name,p.age,c.companyName,s.name) " +
       "FROM Person p LEFT JOIN Company c ON p.companyId=c.id " +
       "LEFT JOIN School s ON p.schoolId=s.id " +
       "WHERE p.name IN :names")
List<UserDTO> findByNames(@Param("names") List<String> names);

4.2 BETWEEN范围查询

处理区间范围查询：

@Query("SELECT new com.example.dto.UserDTO(p.name,p.age,c.companyName,s.name) " +
       "FROM Person p LEFT JOIN Company c ON p.companyId=c.id " +
       "LEFT JOIN School s ON p.schoolId=s.id " +
       "WHERE p.age BETWEEN :minAge AND :maxAge")
List<UserDTO> findByAgeBetween(@Param("minAge") int minAge, 
                              @Param("maxAge") int maxAge);