Spring Boot原生查询如何直接将指定表字段映射为Bean

当然可以直接把NativeQuery的查询结果转换成自定义Bean，不用再折腾Object[]数组啦！下面给你几个实用且优雅的实现方案，按推荐程度排序：

1. 优先推荐：Spring Data JPA 投影（Projection） #

这是Spring Data生态里最简洁的方式，专门用来处理只需要实体部分字段的场景。

步骤： #

• 定义一个投影接口，里面只包含你需要的字段对应的getter方法：

public interface EmployeeProjection {
    String getFirstName();
    String getLastName();
    String getEmail();
}

• 在你的Spring Data Repository接口里，编写NativeQuery并指定返回这个投影类型：

@Repository
public interface EmployeeRepository extends JpaRepository<Employee, Long> {
    @Query(nativeQuery = true, value = "SELECT first_name, last_name, email FROM employee")
    List<EmployeeProjection> findEmployeeBasicInfo();
}

注意：SQL里的字段名要和投影接口的getter方法名对应（比如first_name对应getFirstName()，Spring会自动处理下划线转驼峰的映射）。如果字段名和方法名不匹配，可以用@Value注解手动指定：

public interface EmployeeProjection {
    @Value("#{target.first_name}")
    String getFirstName();
    // 其他字段同理
}

这个方案的优点是代码量极少，完全不需要额外的转换逻辑，Spring Data帮你搞定一切。

2. 标准JPA方案：@SqlResultSetMapping + @ConstructorResult #

如果需要兼容标准JPA（不依赖Spring Data的特性），可以用这种方式。

步骤： #

• 先定义一个普通的DTO类（带全参构造器）：

public class EmployeeDto {
    private String firstName;
    private String lastName;
    private String email;

    public EmployeeDto(String firstName, String lastName, String email) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
    }

    // getter方法按需添加
}

• 在你的Employee实体类上（或者单独的@Entity类上）定义结果集映射：

@Entity
@SqlResultSetMapping(
    name = "EmployeeDtoMapping",
    classes = @ConstructorResult(
        targetClass = EmployeeDto.class,
        columns = {
            @ColumnResult(name = "first_name", type = String.class),
            @ColumnResult(name = "last_name", type = String.class),
            @ColumnResult(name = "email", type = String.class)
        }
    )
)
public class Employee {
    // 实体类原有字段和注解
}

• 然后在EntityManager中使用这个映射执行NativeQuery：

@Autowired
private EntityManager entityManager;

public List<EmployeeDto> getEmployeeBasicInfo() {
    String sql = "SELECT first_name, last_name, email FROM employee";
    Query query = entityManager.createNativeQuery(sql, "EmployeeDtoMapping");
    return query.getResultList();
}

这个方案是JPA标准规范，适合需要跨持久层框架的场景，缺点是需要写较多的映射配置。

3. Hibernate特定方案：ResultTransformer（不推荐优先使用） #

如果你项目里直接用Hibernate的API，可以用ResultTransformer来实现映射，但注意Hibernate 5.2+之后Transformers.aliasToBean被标记为过时，建议优先用上面两种方案，这里仅作参考：

String sql = "SELECT first_name AS firstName, last_name AS lastName, email AS email FROM employee";
List<EmployeeDto> result = entityManager.createNativeQuery(sql)
    .unwrap(org.hibernate.query.Query.class)
    .setResultTransformer(Transformers.aliasToBean(EmployeeDto.class))
    .getResultList();

注意：这里SQL里的字段别名必须和EmployeeDto的字段名完全一致，而且Dto需要有无参构造器和setter方法。

总结 #

• 如果你用Spring Data JPA，优先选投影方案，代码最简洁，维护成本最低；
• 如果需要标准JPA兼容，选@SqlResultSetMapping方案；
• Hibernate的ResultTransformer尽量少用，因为版本兼容性不好。

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