如何通过JPA动态原生查询返回非实体类List<T>？

1. 利用JPA构造函数映射 #

直接通过EntityManager.createNativeQuery的重载方法指定目标DTO类，前提是DTO有与查询返回字段顺序、类型完全匹配的构造函数：

// 动态构建的原生查询语句
String nativeQuery = "SELECT id, name, create_time FROM user WHERE ...";
Query query = entityManager.createNativeQuery(nativeQuery, UserSimpleDTO.class);
List<UserSimpleDTO> resultList = query.getResultList();

对应的DTO示例：

public class UserSimpleDTO {
    private Long id;
    private String name;
    private LocalDateTime createTime;

    // 构造函数参数顺序必须和SELECT的字段顺序一致
    public UserSimpleDTO(Long id, String name, LocalDateTime createTime) {
        this.id = id;
        this.name = name;
        this.createTime = createTime;
    }

    // 按需添加getter/setter
}

2. 手动遍历映射结果集 #

如果需要对字段做自定义处理（比如类型转换、字段拼接），可以直接遍历Object[]数组逐个转换：

String nativeQuery = "SELECT id, name, create_time FROM user WHERE ...";
List<Object[]> resultArrays = entityManager.createNativeQuery(nativeQuery).getResultList();

List<UserSimpleDTO> dtoList = new ArrayList<>();
for (Object[] row : resultArrays) {
    UserSimpleDTO dto = new UserSimpleDTO();
    dto.setId((Long) row[0]);
    dto.setName((String) row[1]);
    // 比如对时间字段做格式化处理
    dto.setCreateTime(LocalDateTime.parse(row[2].toString()));
    dtoList.add(dto);
}

3. Spring Data Projections（Spring环境下） #

如果项目使用Spring Data JPA，可定义投影接口，借助Hibernate的ResultTransformer自动映射：

先定义投影接口：

public interface UserSimpleProjection {
    Long getId();
    String getName();
    LocalDateTime getCreateTime();
}

查询时转换：

String nativeQuery = "SELECT id AS id, name AS name, create_time AS createTime FROM user WHERE ...";
List<UserSimpleProjection> result = entityManager.createNativeQuery(nativeQuery)
    .unwrap(org.hibernate.query.Query.class)
    .setResultTransformer(new Transformers.AliasToBeanResultTransformer(UserSimpleProjection.class))
    .getResultList();

注意：查询字段的别名要和接口方法名对应（比如create_time别名为createTime），此方案依赖Hibernate API。

4. 封装通用反射映射工具 #

如果需要通用转换逻辑，可写一个工具类利用反射自动映射字段（需保证DTO字段顺序与查询返回字段顺序一致）：

public class DtoMapper {
    @SuppressWarnings("unchecked")
    public static <T> List<T> mapToList(List<Object[]> resultList, Class<T> dtoClass) throws Exception {
        List<T> dtoList = new ArrayList<>();
        Constructor<T> constructor = dtoClass.getDeclaredConstructor();
        Field[] fields = dtoClass.getDeclaredFields();

        for (Object[] row : resultList) {
            T dto = constructor.newInstance();
            for (int i = 0; i < fields.length; i++) {
                Field field = fields[i];
                field.setAccessible(true);
                field.set(dto, row[i]);
            }
            dtoList.add(dto);
        }
        return dtoList;
    }
}

使用示例：

List<Object[]> resultArrays = entityManager.createNativeQuery(nativeQuery).getResultList();
List<UserSimpleDTO> dtoList = DtoMapper.mapToList(resultArrays, UserSimpleDTO.class);

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