使用Java和Freemarker生成Word文档中的表格

在现代软件开发中，自动化生成文档是一项常见的需求。特别是在生成报告、发票或其他正式文档时，许多开发者选择使用Java结合Freemarker模板引擎来创建Word文档。本文将通过一个简单的示例介绍如何利用Freemarker中定义的模板生成一个包含表格的Word文档。

工作流程

下面是整个流程的简要说明：

flowchart TD
    A[开始] --> B[创建Freemarker模板]
    B --> C[准备Java环境]
    C --> D[初始化数据模型]
    D --> E[生成Word文档]
    E --> F[保存并查看]
    F --> G[结束]

第一步：创建Freemarker模板

首先，我们需要创建一个Freemarker模板。在模板中，我们可以定义表格的结构。下面是一个简单的Freemarker模板（template.ftl）示例：

<table border="1">
    <tr>
        <th>姓名</th>
        <th>年龄</th>
        <th>城市</th>
    </tr>
    <#list users as user>
    <tr>
        <td>${user.name}</td>
        <td>${user.age}</td>
        <td>${user.city}</td>
    </tr>
    </#list>
</table>

在这个模板中，我们创建了一个表格，表头包括姓名、年龄和城市。接下来，使用Freemarker的<#list>语句来遍历数据模型中的用户列表。

第二步：准备Java环境

在Java项目中，确保已添加Freemarker依赖（通常在pom.xml中）。以下是使用Maven的依赖配置：

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.31</version>
</dependency>

第三步：初始化数据模型

接下来，我们需要初始化数据模型并将用户数据传入。以下是Java代码示例：

import java.io.FileWriter;
import java.io.StringWriter;
import java.util.*;

import freemarker.template.Configuration;
import freemarker.template.Template;

public class WordGenerator {

    public static void main(String[] args) throws Exception {
        // 创建Freemarker配置对象
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
        cfg.setClassForTemplateLoading(WordGenerator.class, "/");
        
        // 加载模板
        Template template = cfg.getTemplate("template.ftl");

        // 准备数据模型
        Map<String, Object> dataModel = new HashMap<>();
        List<Map<String, String>> users = new ArrayList<>();

        users.add(createUser("Alice", "30", "New York"));
        users.add(createUser("Bob", "25", "Los Angeles"));
        users.add(createUser("Charlie", "35", "Chicago"));

        dataModel.put("users", users);

        // 生成文件
        StringWriter out = new StringWriter();
        template.process(dataModel, out);
        try (FileWriter writer = new FileWriter("output.doc")) {
            writer.write(out.toString());
        }
    }

    private static Map<String, String> createUser(String name, String age, String city) {
        Map<String, String> user = new HashMap<>();
        user.put("name", name);
        user.put("age", age);
        user.put("city", city);
        return user;
    }
}

在这段代码中，我们实例化了Freemarker配置、加载了模板，并构建了一个简单的用户列表。然后，使用模板生成Word文档，并将其写入output.doc文件。

第四步：保存并查看

最后一步是保存生成的Word文档并打开它进行查看。你可以使用Microsoft Word或其他兼容的应用程序打开output.doc文件，查看包含用户信息的表格。

总结

通过使用Java和Freemarker的强大功能，开发者可以快速生成动态文档。本文展示的简单示例展示了如何将表格集成到Word文档中。在实际开发中，你可以根据不同的需求自定义数据模型和模板内容，以满足各种文档场景的需求。希望这些内容能帮助你更有效地生成自动化Word文档！