Spring Data JPA中非表实体数据获取及用户实体指定字段查询

嘿，这两个Spring Data JPA的场景在日常开发里挺常见的，我来给你详细说说解决方案：

这里的“非表实体”指的是没有对应数据库表的自定义数据结构（比如聚合查询结果、跨表关联的自定义数据等），常用的实现方式有三种：

1. 接口投影（Interface-based Projection） #

这是最简洁的实现方式，你只需要定义一个包含目标字段getter方法的接口，Spring Data会自动生成代理类返回数据：

// 自定义非表实体的投影接口
public interface CustomDataProjection {
    String getTitle();
    Integer getCount();
}

// 在Repository中定义查询方法
public interface SomeRepository extends JpaRepository<SomeEntity, Long> {
    @Query("SELECT s.title AS title, COUNT(s.id) AS count FROM SomeEntity s GROUP BY s.title")
    List<CustomDataProjection> getCustomData();
}

注意： 查询语句里的字段别名要和接口的getter方法名对应（比如title对应getTitle()）。

2. DTO类投影（Class-based Projection） #

如果需要对返回的数据做后续处理，可创建一个DTO类并提供对应构造函数，在查询中直接调用构造函数：

// 自定义DTO类（非表实体）
public class CustomDataDTO {
    private String title;
    private Integer count;

    // 构造函数参数要和查询返回的字段顺序、类型完全匹配
    public CustomDataDTO(String title, Integer count) {
        this.title = title;
        this.count = count;
    }

    // getter/setter按需添加
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }
    public Integer getCount() { return count; }
    public void setCount(Integer count) { this.count = count; }
}

// Repository中的查询方法
public interface SomeRepository extends JpaRepository<SomeEntity, Long> {
    @Query("SELECT new com.yourpackage.CustomDataDTO(s.title, COUNT(s.id)) FROM SomeEntity s GROUP BY s.title")
    List<CustomDataDTO> getCustomData();
}

注意： 构造函数必须写全类名，参数顺序要和查询返回的字段一致。

3. 原生SQL配合@SqlResultSetMapping #

针对复杂的原生SQL查询（比如多表关联的复杂逻辑），可以用@SqlResultSetMapping映射到非表实体：

// 自定义非表实体类（无需@Entity注解）
public class CustomData {
    private String name;
    private Double total;

    // 必须提供无参构造函数
    public CustomData() {}

    // getter/setter
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Double getTotal() { return total; }
    public void setTotal(Double total) { this.total = total; }
}

// 在任意实体类上定义结果集映射（示例绑定到SomeEntity）
@Entity
@SqlResultSetMapping(
    name = "CustomDataMapping",
    classes = @ConstructorResult(
        targetClass = CustomData.class,
        columns = {
            @ColumnResult(name = "name", type = String.class),
            @ColumnResult(name = "total", type = Double.class)
        }
    )
)
public class SomeEntity {
    // ... 实体类原有字段定义
}

// Repository中的原生SQL查询方法
public interface SomeRepository extends JpaRepository<SomeEntity, Long> {
    @Query(value = "SELECT u.name, SUM(o.amount) AS total FROM user u JOIN `order` o ON u.id = o.user_id GROUP BY u.name",
           nativeQuery = true)
    @SqlResultSetMapping(name = "CustomDataMapping")
    List<CustomData> getCustomData();
}

先提个小问题： 你提供的User实体类中重复定义了private String firstName;字段，这会导致编译错误，建议删除其中一个重复的定义。

针对只查询三个字段的需求，推荐以下几种优雅的实现方式：

1. 接口投影方式 #

定义一个仅包含目标字段的投影接口，Repository方法直接返回该接口的列表即可：

// 定义User的投影接口
public interface UserProjection {
    Long getId();
    String getFirstName();
    Integer getAge();
}

// UserRepository接口
public interface UserRepository extends JpaRepository<User, Long> {
    // 自动生成只查询指定字段的SQL
    List<UserProjection> findAllProjectedBy();

    // 带条件的投影查询示例
    List<UserProjection> findByAgeGreaterThan(Integer age);
}

这种方式无需手动写SQL，Spring Data会自动生成最优的查询语句。

2. DTO类投影方式 #

创建包含目标字段的UserDTO类，通过构造函数查询返回：

// UserDTO类
public class UserDTO {
    private Long id;
    private String firstName;
    private Integer age;

    public UserDTO(Long id, String firstName, Integer age) {
        this.id = id;
        this.firstName = firstName;
        this.age = age;
    }

    // getter方法
    public Long getId() { return id; }
    public String getFirstName() { return firstName; }
    public Integer getAge() { return age; }
}

// UserRepository中的查询方法
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT new com.yourpackage.UserDTO(u.id, u.firstName, u.age) FROM User u")
    List<UserDTO> findAllUserDTO();

    // 带条件的DTO查询示例
    @Query("SELECT new com.yourpackage.UserDTO(u.id, u.firstName, u.age) FROM User u WHERE u.age = :age")
    List<UserDTO> findUserDTOByAge(@Param("age") Integer age);
}

这种方式适合需要对返回数据做后续业务处理的场景。

3. 直接指定查询字段（不推荐） #

如果不想创建额外类/接口，也可以直接在@Query中指定字段，但返回的是Object数组，需要手动转换：

public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u.id, u.firstName, u.age FROM User u")
    List<Object[]> findUserPartialData();
}

这种方式不够优雅，一般仅用于临时调试场景。

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