如何避免为每个查询结果集创建实体类以对接Thymeleaf？

可行方案推荐 #

1. 用List<Map<String, Object>>替代实体类 #

这是最直接高效的方案，无需手动创建任何实体类：

• 编写工具方法将ResultSet转换为List<Map<String, Object>>：通过ResultSetMetaData获取查询结果的列名，遍历每一行数据时，把列名作为Map的key，对应字段值作为value存入Map，最后将所有Map放入List。
• 示例代码：

public List<Map<String, Object>> resultSetToList(ResultSet rs) throws SQLException {
    List<Map<String, Object>> list = new ArrayList<>();
    ResultSetMetaData metaData = rs.getMetaData();
    int columnCount = metaData.getColumnCount();
    while (rs.next()) {
        Map<String, Object> map = new HashMap<>();
        for (int i = 1; i <= columnCount; i++) {
            String columnName = metaData.getColumnName(i);
            map.put(columnName, rs.getObject(i));
        }
        list.add(map);
    }
    return list;
}

• 传递给Thymeleaf后，模板中可直接通过列名访问数据，比如${item.USER_NAME}或${item['USER_NAME']}，完全保留列名可读性。

2. 借助Spring JdbcTemplate简化操作 #

如果使用SpringBoot，直接用JdbcTemplate的queryForList方法，无需手动处理ResultSet：

• 示例代码：

@Autowired
private JdbcTemplate jdbcTemplate;

public List<Map<String, Object>> getQueryResult(String sql) {
    return jdbcTemplate.queryForList(sql);
}

• 该方法会自动把查询结果转换成List<Map<String, Object>>，直接传给Model即可，模板用法和上述方案一致。

3. 关于动态生成实体类的说明 #

动态生成匹配列名的类虽然技术上可行，但对新手学习成本高，后续维护麻烦，不推荐作为首选：

• 可借助Apache Commons BeanUtils、CGLIB等工具动态创建类，但需处理类加载、字段映射等细节，容易踩坑。
• 若想尝试，也可以用Spring Data的Projection特性：定义接口，方法名对应查询列名（比如String getUserName()对应USER_NAME列），Spring会动态生成实现类，但数千个查询仍需定义大量接口，效率不如Map方案。

4. 为什么不能直接传递ResultSet到Thymeleaf #

ResultSet依赖数据库连接，一旦连接关闭（比如方法执行完毕后连接归还连接池），ResultSet就会失效，Thymeleaf渲染时会抛出异常，因此这种方式不可行。

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