Spring Data JPA：使用Pageable查询实体指定字段的实现方案

嘿，刚好我之前在Spring Data 2.x版本里做过类似的需求，给你几个实用的方案来搞定分页时只返回Persona的特定字段，完全适配你用的2.0.6.RELEASE版本：

方案一：使用Spring Data投影（Projections） #

这是Spring Data官方推荐的轻量方式，不需要额外创建DTO类，只需要定义一个包含目标字段getter的接口就行。

1. 先定义投影接口，只包含你需要返回的字段：

// 替换成你实际需要的字段和对应的getter方法
interface PersonaProjection {
    String getId();
    String getFullName();
    LocalDate getBirthDate();
}

2. 修改你的Repository接口，添加一个返回投影分页结果的方法：

interface PersonaDataJpaCrudRepository extends PagingAndSortingRepository<Persona, String> {
    // 方法名遵循Spring Data命名规则，ProjectedBy后缀会自动映射到投影接口
    Page<PersonaProjection> findAllProjectedBy(Pageable pageable);
}

3. 在Controller里直接使用这个方法，把分页的投影结果放到Model中：

@GetMapping(produces=MediaType.TEXT_HTML_VALUE)
public String findAll(Pageable pageable, Model model){
    Page<PersonaProjection> personaPage = personaRepository.findAllProjectedBy(pageable);
    model.addAttribute("personas", personaPage);
    return "persona-list"; // 你的视图名称
}

方案二：使用DTO构造函数查询 #

如果需要更灵活的字段组合，或者后续要对返回的数据做额外处理，创建DTO类配合JPQL查询会更合适。

1. 创建一个DTO类，包含需要的字段和对应的构造函数：

// 记得替换成你的包路径和实际字段
package com.yourproject.dto;

import java.time.LocalDate;

public class PersonaDto {
    private String id;
    private String fullName;
    private LocalDate birthDate;

    // 构造函数的参数顺序要和JPQL查询里的字段顺序完全一致
    public PersonaDto(String id, String fullName, LocalDate birthDate) {
        this.id = id;
        this.fullName = fullName;
        this.birthDate = birthDate;
    }

    // 必须提供getter方法，Spring Data需要通过getter来映射数据
    public String getId() { return id; }
    public String getFullName() { return fullName; }
    public LocalDate getBirthDate() { return birthDate; }
}

2. 在Repository里添加带@Query注解的分页查询方法：

interface PersonaDataJpaCrudRepository extends PagingAndSortingRepository<Persona, String> {
    @Query("SELECT new com.yourproject.dto.PersonaDto(p.id, p.fullName, p.birthDate) FROM Persona p")
    Page<PersonaDto> findAllAsDto(Pageable pageable);
}

3. Controller里的用法和投影方案类似，只需要把返回类型换成Page<PersonaDto>即可。

额外提示 #

• 如果需要带条件的分页查询，只需要在方法名里添加条件（比如findByAgeGreaterThanProjectedBy(Integer age, Pageable pageable)），或者在@Query里加入WHERE子句就行，Pageable参数的使用完全不受影响。
• Spring Data 2.0.6.RELEASE对这两种方案都有完善的支持，不用担心版本兼容问题。
• 投影方案更适合简单的字段筛选，DTO方案适合需要复杂处理或者后续要扩展的场景，你可以根据自己的需求选择。

内容的提问来源于stack exchange，提问作者Manuel Jordan