Spring Data JPA如何通过泛型投影返回集合以支持多投影选择

你希望通过JPA Repository方法返回集合类型的不同投影，但原代码无法正常运行，核心问题在于Spring Data JPA对泛型投影方法的参数识别逻辑。

问题根源 #

你原本定义的Repository方法：

<T> List<T> findByOrderByIdAsc(Class<T> type);

Spring Data JPA会把Class<T> type当作查询条件参数处理，而非投影类型指定参数，因此无法生成正确的投影查询，自然无法返回预期的投影集合。

修正方案 #

通过@Query显式指定查询语句，让Spring Data识别Class<T> type为投影类型参数，修改后的Repository如下：

public interface ThemingRepository extends JpaRepository<ThemeData, Long> {
    @Query("SELECT t FROM ThemeData t ORDER BY t.id ASC")
    <T> List<T> findAllProjectedBy(Class<T> type);
}

服务层代码（无需修改） #

保持你原有的业务逻辑调用即可：

@Transactional
public byte[] findBackgroundImage() {
    var list = themingRepository.findAllProjectedBy(ThemeDataBackgroundImage.class);
    if (list.isEmpty()) {
        throw new NoThemeColorsSetException();
    }
    return list.get(0).getBackgroundImage();
}

@Transactional
public byte[] findLogoImage() {
    var list = themingRepository.findAllProjectedBy(ThemeDataLogoImage.class);
    if (list.isEmpty()) {
        throw new NoThemeColorsSetException();
    }
    return list.get(0).getLogo();
}

@Transactional
public ThemeDataColors findThemeColors() {
    var list = themingRepository.findAllProjectedBy(ThemeDataColors.class);
    if (list.isEmpty()) {
        throw new NoThemeColorsSetException();
    }
    return list.get(0);
}

投影接口示例 #

public interface ThemeDataBackgroundImage {
    byte[] getBackgroundImage();
}

public interface ThemeDataLogoImage {
    byte[] getLogo();
}

public interface ThemeDataColors {
    // 按需定义对应属性的getter方法
    String getPrimaryColor();
    String getSecondaryColor();
}

原理说明 #

使用@Query后，Spring Data JPA会忽略方法参数的查询条件绑定逻辑，转而将Class<T> type作为投影类型的指定参数，生成只查询投影接口中定义属性的SQL语句，最终返回泛型集合。

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