JPA Repository查询部分字段如何返回自定义MyDomain类而非Object

当你只查询实体的部分字段时，JPA默认会返回Object[]数组（每个数组元素对应一个查询的字段），而非完整的MyDomain实例——因为未查询实体全部属性，无法构建完整的实体对象。以下是几种可行的解决方法：

方法1：使用实体类构造函数投影 #

在JPQL中直接调用MyDomain的构造函数，将查询到的字段作为参数传入，前提是MyDomain类中存在对应构造方法。

步骤1：给MyDomain添加对应构造函数 #

public class MyDomain {
    private Long id;
    private String firstname;
    private String lastname;

    // 新增对应查询字段的构造函数
    public MyDomain(String firstname, String lastname) {
        this.firstname = firstname;
        this.lastname = lastname;
    }

    // 必须保留无参构造函数（JPA要求）
    public MyDomain() {}

    // getter、setter方法省略
}

步骤2：修改Repository的@Query注解 #

@Repository
public interface MyRepository extends JpaRepository<MyDomain, Long> {
    // 使用new关键字调用构造函数，需指定实体类全路径
    @Query("SELECT new com.yourpackage.MyDomain(q.firstname, q.lastname) from MyDomain q WHERE q.firstname = :firstname")
    Page<MyDomain> findByFirstName(String firstname, Pageable pageable);
}

此时查询结果会直接返回MyDomain实例，未查询的字段（如id）会为null，后续可正常用Mapper转换为DTO。

方法2：直接返回DTO（更推荐） #

既然最终要转换为MyDomainDto，不如直接在查询时返回DTO对象，省去中间转换不完整实体的步骤。

步骤1：确保MyDomainDto有对应构造函数 #

public class MyDomainDto {
    private String firstname;
    private String lastname;

    public MyDomainDto(String firstname, String lastname) {
        this.firstname = firstname;
        this.lastname = lastname;
    }

    // getter、setter方法省略
}

步骤2：修改Repository方法返回DTO #

@Repository
public interface MyRepository extends JpaRepository<MyDomain, Long> {
    @Query("SELECT new com.yourpackage.MyDomainDto(q.firstname, q.lastname) from MyDomain q WHERE q.firstname = :firstname")
    Page<MyDomainDto> findByFirstName(String firstname, Pageable pageable);
}

步骤3：简化Service层代码 #

private ResponseEntity<List<MyDomainDto>> getByFirstName(String firstname, Pageable pageable) {
    Page<MyDomainDto> page = dataRepository.findByFirstName(firstname, pageable);
    return new ResponseEntity<>(page.getContent(), HttpStatus.OK);
}

这种方式更高效，也避免了处理不完整实体对象的问题。

方法3：使用Spring Data投影接口 #

定义一个投影接口，仅包含需要查询字段的get方法，让Repository返回该接口实例后再转换为DTO。

步骤1：定义投影接口 #

public interface MyDomainProjection {
    String getFirstname();
    String getLastname();
}

步骤2：修改Repository方法 #

@Repository
public interface MyRepository extends JpaRepository<MyDomain, Long> {
    @Query("SELECT q.firstname, q.lastname from MyDomain q WHERE q.firstname = :firstname")
    Page<MyDomainProjection> findByFirstName(String firstname, Pageable pageable);
}

步骤3：Service层转换为DTO #

private ResponseEntity<List<MyDomainDto>> getByFirstName(String firstname, Pageable pageable) {
    Page<MyDomainProjection> page = dataRepository.findByFirstName(firstname, pageable);
    List<MyDomainDto> dtoList = page.getContent().stream()
            .map(projection -> {
                MyDomainDto dto = new MyDomainDto();
                dto.setFirstname(projection.getFirstname());
                dto.setLastname(projection.getLastname());
                return dto;
            })
            .collect(Collectors.toList());
    return new ResponseEntity<>(dtoList, HttpStatus.OK);
}

如果使用MapStruct，还可以给Mapper添加从投影接口到DTO的转换方法，进一步简化代码。

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