JPA EntityManager如何将JPQL查询结果映射为嵌套DTO类

存在完全基于JPQL的原生支持方案，核心是使用JPA规范定义的NEW构造函数表达式，支持多层嵌套构造嵌套结构的DTO，无需借助第三方映射工具，适配EntityManager的查询逻辑。

前置准备 #

所有层级的DTO都提供与查询字段顺序、类型匹配的全参数构造方法，示例：

// AddressDTO 示例
// 可手动编写全参构造，也可使用Lombok的@AllArgsConstructor注解生成
public class AddressDTO {
    private Long id;
    private String street;
    private String city;

    public AddressDTO(Long id, String street, String city) {
        this.id = id;
        this.street = street;
        this.city = city;
    }
}

// UserDTO 示例
public class UserDTO {
    private Long id;
    private AddressDTO address;
    private String status; // 示例自定义计算字段

    public UserDTO(Long id, AddressDTO address, String status) {
        this.id = id;
        this.address = address;
        this.status = status;
    }
}

JPQL查询编写 #

直接在JPQL的NEW构造中嵌套子DTO的NEW构造即可，示例：

SELECT NEW com.yourproject.dto.UserDTO(
    u.id,
    -- 嵌套构造AddressDTO
    NEW com.yourproject.dto.AddressDTO(a.id, a.street, a.city),
    -- 自定义计算字段示例
    CASE WHEN u.active = TRUE THEN '启用' ELSE '禁用' END
) FROM User u LEFT JOIN u.address a

EntityManager执行代码示例 #

@PersistenceContext
private EntityManager entityManager;

public List<UserDTO> queryUserDTOList() {
    String jpql = "SELECT NEW com.yourproject.dto.UserDTO(" +
            "u.id, " +
            "NEW com.yourproject.dto.AddressDTO(a.id, a.street, a.city), " +
            "CASE WHEN u.active = TRUE THEN '启用' ELSE '禁用' END" +
            ") FROM User u LEFT JOIN u.address a";
    // 直接指定返回类型为UserDTO，无需手动映射
    TypedQuery<UserDTO> query = entityManager.createQuery(jpql, UserDTO.class);
    return query.getResultList();
}

注意事项 #

• 构造DTO时必须写类的全限定名（包名+类名），否则JPQL无法识别目标类
• 构造参数的顺序、数据类型必须和对应DTO的全参构造方法完全一致，否则会抛出构造方法不匹配的异常
• 若关联的子实体为null（比如左关联没有对应的地址数据），嵌套构造出的子DTO也会自动为null，符合业务预期
• 该方案为JPA标准实现，所有兼容JPA规范的ORM框架都支持，完全基于JPQL无需使用原生SQL

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