Spring Boot + Thymeleaf：无实体类的查询结果如何传递至视图？

一、最规范的方案：创建DTO（数据传输对象） #

你提到的思路方向是对的，但不要用Employee类（这会和你现有的员工实体混淆），应该创建一个专门用于封装查询结果的DTO类，比如SkuSalesDto：

public class SkuSalesDto {
    private String sku;
    private int unitSold;

    // 必须提供对应查询结果字段的构造方法（JPA查询会用到）
    public SkuSalesDto(String sku, int unitSold) {
        this.sku = sku;
        this.unitSold = unitSold;
    }

    // Getter方法（Thymeleaf需要通过getter访问属性）
    public String getSku() {
        return sku;
    }

    public int getUnitSold() {
        return unitSold;
    }
}

后续步骤： #

1. Repository层查询映射到DTO：
   如果用JPA，可以直接在Repository接口中定义返回DTO的查询方法：

   @Repository
   public interface SkuSalesRepository extends JpaRepository<...> {
       @Query("SELECT new com.yourpackage.dto.SkuSalesDto(s.sku, SUM(s.unitSold)) " +
              "FROM SalesRecord s GROUP BY s.sku ORDER BY SUM(s.unitSold) DESC LIMIT 5")
       List<SkuSalesDto> findTop5SkuSales();
   }
   

   注意要写全DTO的完整包路径。

2. Service层调用：

   public List<SkuSalesDto> getTop5SkuSales() {
       return skuSalesRepository.findTop5SkuSales();
   }
   

3. Controller层传递模型：

   @GetMapping("/top-skus")
   public String showTopSkuSales(Model model) {
       List<SkuSalesDto> topSkuSales = skuSalesService.getTop5SkuSales();
       model.addAttribute("topSkus", topSkuSales);
       return "/sku-sales";
   }
   

4. Thymeleaf中访问：

   <table>
       <tr>
           <th>SKU</th>
           <th>销量</th>
       </tr>
       <tr th:each="skuSale : ${topSkus}">
           <td th:text="${skuSale.sku}"></td>
           <td th:text="${skuSale.unitSold}"></td>
       </tr>
   </table>
   

二、快速临时方案：使用Map<String, Object> #

如果只是快速测试，不想创建DTO类，可以用Map封装每条查询结果：

Repository层（以JPA为例）： #

@Query("SELECT s.sku as sku, SUM(s.unitSold) as unitSold " +
       "FROM SalesRecord s GROUP BY s.sku ORDER BY SUM(s.unitSold) DESC LIMIT 5")
List<Map<String, Object>> findTop5SkuSalesAsMap();

Controller传递： #

@GetMapping("/top-skus")
public String showTopSkuSales(Model model) {
    List<Map<String, Object>> topSkuSales = skuSalesService.getTop5SkuSalesAsMap();
    model.addAttribute("topSkus", topSkuSales);
    return "/sku-sales";
}

Thymeleaf访问： #

<tr th:each="skuSale : ${topSkus}">
    <td th:text="${skuSale.sku}"></td>
    <td th:text="${skuSale.unitSold}"></td>
</tr>

这种方案适合临时场景，但代码可读性差，不利于维护，不推荐长期使用。

三、JPA接口投影方案（更简洁） #

如果你的查询是基于JPA，可以用接口投影来避免编写DTO类：

1. 定义投影接口：

public interface SkuSalesProjection {
    String getSku();
    int getUnitSold();
}

2. Repository层查询：

@Query("SELECT s.sku as sku, SUM(s.unitSold) as unitSold " +
       "FROM SalesRecord s GROUP BY s.sku ORDER BY SUM(s.unitSold) DESC LIMIT 5")
List<SkuSalesProjection> findTop5SkuSales();

3. 后续步骤和DTO方案一致，Controller传递List<SkuSalesProjection>，Thymeleaf中同样通过${skuSale.sku}访问。

你之前创建实体类失败的可能原因 #

1. 错误地使用了@Entity注解：这类查询结果不需要映射到数据库表，所以不能加@Entity，应该用普通的DTO类。
2. 字段名和查询结果不匹配：比如查询返回的是unit_sold，但DTO类中是unitSold，需要确保查询别名和DTO的getter对应（JPA会自动驼峰转换，比如查询别名unit_sold对应getUnitSold()）。
3. 缺少构造方法：JPA映射到DTO时需要对应参数的构造方法，否则无法实例化对象。

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