Java 动态导出 Word 登记表：多人员、分页、动态表格的最佳实践

本文详细讲解如何使用 Java 动态导出包含多人员报名表的 Word 文档，每人占据独立一页，并支持动态表格行（如个人经历）。我们对比了多种实现方案，最终推荐基于 Freemarker + XML 模板 或 docx4j 的灵活方式，并提供完整代码示例与最佳实践，助你高效实现复杂 Word 导出需求。

一、需求分析

在许多业务场景中（如招聘报名、活动登记、培训考核等），我们需要将多人的信息导出为 Word 文档，通常要求：

1. 每人一页：每个人的报名表独立成页，便于打印或分发；
2. 动态表格行：如“工作经历”“学习经历”等，每个人的条目数量不固定；
3. 模板可配置：希望报名表的字段、排版可灵活调整，而非硬编码；
4. 导出为标准 DOCX：兼容 Microsoft Word，支持分页、表格样式等。

传统方式（如直接拼接字符串生成 Word）难以满足动态需求，而 Apache POI 虽然功能强大，但 API 繁琐。本文将介绍更优雅的解决方案。

二、实现思路

方案对比

推荐选择：

• 追求灵活性和可控性 → Freemarker + XML 模板
• 追求开发效率和稳定性 → docx4j

核心实现步骤

1. 定义数据模型：如 Applicant（姓名、经历等）；
2. 准备 Word 模板：
   • 方式 1：从 DOCX 中提取 document.xml，用 Freemarker 语法替换动态部分；
   • 方式 2：直接编写 XML 模板（需熟悉 Word 的 XML 结构）；
3. 动态渲染：用 Freemarker 填充数据，生成 document.xml；
4. 打包为 DOCX：将渲染后的 XML 放入标准 DOCX 结构（或使用 docx4j 直接生成）。

三、示例代码

1. 数据模型定义

// Applicant.java
public class Applicant {
    private String name;
    private List<Experience> experiences;
    // getters/setters...
}

// Experience.java
public class Experience {
    private String period;
    private String organization;
    // getters/setters...
}

2. Freemarker + XML 模板方案

（1）XML 模板片段（applicant_template.ftl）

<w:tbl>
  <w:tr>
    <w:tc<w:p><w:r><w:t>时间段</w:t></w:r></w:p></w:tc>
    <w:tc<w:p><w:r><w:t>单位</w:t></w:r></w:p></w:tc>
  </w:tr>
  <#list experiences as exp>
  <w:tr>
    <w:tc<w:p><w:r><w:t>${exp.period}</w:t></w:r></w:p></w:tc>
    <w:tc<w:p><w:r><w:t>${exp.organization}</w:t></w:r></w:p></w:tc>
  </w:tr>
  </#list>
</w:tbl>
<w:p<w:r><w:br w:type="page"/></w:r></w:p> <!-- 分页符 -->

（2）Java 渲染代码

Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
cfg.setClassForTemplateLoading(getClass(), "/templates");
Template template = cfg.getTemplate("applicant_template.ftl");

StringWriter xmlWriter = new StringWriter();
Map<String, Object> data = new HashMap<>();
data.put("name", applicant.getName());
data.put("experiences", applicant.getExperiences());
template.process(data, xmlWriter);

// 将 xmlWriter.toString() 插入到完整 DOCX 的 document.xml 中

3. docx4j 方案（推荐生产环境使用）

import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import org.docx4j.wml.*;

// 创建 Word 文档
WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.createPackage();

// 循环添加每个人
for (Applicant applicant : applicants) {
    // 添加基本信息段落
    wordMLPackage.getMainDocumentPart().addParagraphOfText("姓名: " + applicant.getName());

    // 创建表格
    Tbl table = factory.createTbl();
    // 添加表头行...
    // 循环添加经历行...
    wordMLPackage.getMainDocumentPart().addObject(table);

    // 添加分页符
    wordMLPackage.getMainDocumentPart().addPageBreak();
}

// 保存为 DOCX
wordMLPackage.save(new File("applicants.docx"));

四、优势对比

最终建议：

• 中小项目或快速原型 → Freemarker + XML
• 企业级应用 → docx4j

五、总结

本文介绍了 Java 动态导出 Word 报名表的完整方案，重点解决了 多人员分页 和 动态表格行 的需求。通过对比不同技术栈，推荐：

1. 灵活性优先 → Freemarker + XML 模板；
2. 开发效率优先 → docx4j 库。