Java利用FreeMarker模板引擎动态生成HTML表格
编辑：本站更新：2025-02-21 20:35:54人气：5247
在实际的Web开发中，为了提高代码复用性和灵活性，开发者常常会借助于模板引擎技术来实现页面内容与数据分离。其中，Apache FreeMarker是一个广泛使用的、基于Java的模板引擎工具，它能够帮助我们高效地将后端处理的数据渲染为前端所需的HTML结构。接下来我们将详细探讨如何使用FreeMarker动态生成HTML表格。
首先，在项目中引入Freemarker依赖，并配置相关环境以使其能正确解析和输出模板文件到HTTP响应流中。通常情况下，Spring Boot等框架已经内置了对FreeMarker的支持，只需简单配置即可启用。
@Configuration
public class FreemarkerConfig {
@Bean
public freemarker.template.Configuration configuration() {
Configuration config = new Configuration(Configuration.VERSION_2_3_0);
// 设置加载ftl模版路径
config.setDirectoryForTemplateLoading(new File("templates"));
// 设置默认编码格式
config.setDefaultEncoding("UTF-8");
return config;
}
}
然后我们需要准备一个用于展示数据的FreeMarker模板（如：table.ftlh）。在此模板内我们可以编写静态HTML骨架以及嵌入式指令语法：
<table border="1">
<thead>
<tr>
<!-- 动态列头 -->
<#list header as column>
<th>${column}</th>
</#list>
</tr>
</thead>
<tbody>
<!-- 遍历并显示具体行记录 -->
<#list data as row>
<tr>
<#list row?keys as key>
<td>${row[key]}</td>
</#list>
</tr>
</#list>
</tbody>
</table>
上述FTL模板通过`<#list>`标签循环遍历传入的表头数组(`header`) 和 数据集合 (`data`). 每个元素或对象属性都会被插入对应的单元格位置上，从而实现了根据后台传递的不同JSON或者List<Map<String,Object>>类型数据构建不同形态及规模的 HTML 表格。
最后一步是结合Java服务层进行数据填充并将结果模型发送给视图去呈现：
@GetMapping("/dynamic-table")
public String dynamicTable(Model model) throws IOException, TemplateException {
List<Map<String, Object>> dataList = ...; // 获取需要展现的数据列表
Map<String, Object> rootMap = new HashMap<>();
rootMap.put("header", Arrays.asList("Name","Age","Email")); // 填充表头字段名
rootMap.put("data", dataList); // 将数据绑定至rootMap
// 使用FreeMarkerConfiguration实例获取指定模板并合并数据模型
StringWriter writer = new StringWriter();
template.process(rootMap, writer);
// 在ModelAndView中添加已处理好的Html字符串供Thymeleaf或其他ViewResolver渲染返回给客户端
model.addAttribute("content", writer.toString());
return "result"; // 返回指向包含要替换区域的结果页名称
}
综上所述，通过整合Java业务逻辑处理后的数据源，搭配灵活强大的FreeMarker模板语言表达能力，可以轻松实现在服务器端按照需求实时动态生成各种复杂的HTML表格布局，显著提升应用系统的前后端交互效率和用户体验。同时这种模式也有效降低了维护成本，增强了项目的可扩展性。
首先，在项目中引入Freemarker依赖，并配置相关环境以使其能正确解析和输出模板文件到HTTP响应流中。通常情况下，Spring Boot等框架已经内置了对FreeMarker的支持，只需简单配置即可启用。
java
@Configuration
public class FreemarkerConfig {
@Bean
public freemarker.template.Configuration configuration() {
Configuration config = new Configuration(Configuration.VERSION_2_3_0);
// 设置加载ftl模版路径
config.setDirectoryForTemplateLoading(new File("templates"));
// 设置默认编码格式
config.setDefaultEncoding("UTF-8");
return config;
}
}
然后我们需要准备一个用于展示数据的FreeMarker模板（如：table.ftlh）。在此模板内我们可以编写静态HTML骨架以及嵌入式指令语法：
html
<table border="1">
<thead>
<tr>
<!-- 动态列头 -->
<#list header as column>
<th>${column}</th>
</#list>
</tr>
</thead>
<tbody>
<!-- 遍历并显示具体行记录 -->
<#list data as row>
<tr>
<#list row?keys as key>
<td>${row[key]}</td>
</#list>
</tr>
</#list>
</tbody>
</table>
上述FTL模板通过`<#list>`标签循环遍历传入的表头数组(`header`) 和 数据集合 (`data`). 每个元素或对象属性都会被插入对应的单元格位置上，从而实现了根据后台传递的不同JSON或者List<Map<String,Object>>类型数据构建不同形态及规模的 HTML 表格。
最后一步是结合Java服务层进行数据填充并将结果模型发送给视图去呈现：
java
@GetMapping("/dynamic-table")
public String dynamicTable(Model model) throws IOException, TemplateException {
List<Map<String, Object>> dataList = ...; // 获取需要展现的数据列表
Map<String, Object> rootMap = new HashMap<>();
rootMap.put("header", Arrays.asList("Name","Age","Email")); // 填充表头字段名
rootMap.put("data", dataList); // 将数据绑定至rootMap
// 使用FreeMarkerConfiguration实例获取指定模板并合并数据模型
StringWriter writer = new StringWriter();
template.process(rootMap, writer);
// 在ModelAndView中添加已处理好的Html字符串供Thymeleaf或其他ViewResolver渲染返回给客户端
model.addAttribute("content", writer.toString());
return "result"; // 返回指向包含要替换区域的结果页名称
}
综上所述，通过整合Java业务逻辑处理后的数据源，搭配灵活强大的FreeMarker模板语言表达能力，可以轻松实现在服务器端按照需求实时动态生成各种复杂的HTML表格布局，显著提升应用系统的前后端交互效率和用户体验。同时这种模式也有效降低了维护成本，增强了项目的可扩展性。
www.php580.com PHP工作室 - 全面的PHP教程、实例、框架与实战资源
PHP学习网是专注于PHP技术学习的一站式在线平台，提供丰富全面的PHP教程、深入浅出的实例解析、主流PHP框架详解及实战应用，并涵盖PHP面试指南、最新资讯和活跃的PHP开发者社区。无论您是初学者还是进阶者，这里都有助于提升您的PHP编程技能。
转载内容版权归作者及来源网站所有，本站原创内容转载请注明来源。