Spring Data JPA 投影：高效查询与部分数据映射

@Repository
public interface RoleRepo extends JpaRepository<Role, Long>{  
    // 这种方式会引发ConversionFailedException
    @Query("SELECT r.roleId, r.name FROM Role r")  
    List<Role> getAllRoleNames();
}

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;

@Entity
public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long roleId;
    private String name;
    private String description; // 假设还有其他字段

    // 构造函数、Getter和Setter
    public Role() {}

    public Role(Long roleId, String name) {
        this.roleId = roleId;
        this.name = name;
    }

    public Long getRoleId() {
        return roleId;
    }

    public void setRoleId(Long roleId) {
        this.roleId = roleId;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getDescription() {
        return description;
    }

    public void setDescription(String description) {
        this.description = description;
    }
}

public interface RoleInfoProjection {
    Long getRoleId();
    String getName();
    // 如果需要，也可以包含其他字段的getter
}

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.stereotype.Repository;
import java.util.List;

@Repository
public interface RoleRepo extends JpaRepository<Role, Long> {

    // 使用派生查询方法，Spring Data JPA会自动识别并映射到投影
    List<RoleInfoProjection> findBy(); // 查询所有角色，并映射到RoleInfoProjection

    // 也可以结合@Query注解使用，但此时@Query中无需指定具体的字段
    // 因为Spring Data JPA会根据返回类型（投影接口）自动选择所需字段
    @Query("SELECT r FROM Role r")
    List<RoleInfoProjection> findAllRolesAsProjection();

    // 如果你明确只想选择某些字段，也可以在@Query中指定，但此时需要构造函数式投影或使用元组
    // 但对于接口式投影，通常直接返回实体，让Spring Data根据接口方法名推断
    // 更推荐的方式是让Spring Data自动处理，如findBy()或findAllRolesAsProjection()
    // 或者，如果你确实需要显式指定字段，且字段名与实体属性名不一致，可以这样：
    // @Query("SELECT r.roleId as roleId, r.name as name FROM Role r") // 别名需与投影方法名匹配
    // List<RoleInfoProjection> findSpecificFieldsWithQuery();
    // 但通常情况下，Spring Data会自动从接口方法名推断实体属性名，无需在@Query中显式指定字段。
    // 最简洁的方式是：
    List<RoleInfoProjection> findAllBy(); // 通过派生查询自动映射
}

public class RoleDto {
    private Long roleId;
    private String name;

    // 构造函数必须与@Query中选择的字段顺序和类型匹配
    public RoleDto(Long roleId, String name) {
        this.roleId = roleId;
        this.name = name;
    }

    // Getter方法
    public Long getRoleId() { return roleId; }
    public String getName() { return name; }
}

@Repository
public interface RoleRepo extends JpaRepository<Role, Long> {
    @Query("SELECT new com.example.demo.RoleDto(r.roleId, r.name) FROM Role r")
    List<RoleDto> findAllRoleDtos();
}