当前位置：首页 > news >正文

我如何开发 Doc Java工具，简化文档模板生成

news 来源：原创 2025/5/4 6:25:38

在开发 Excel 模板填充工具 之后，我发现 Word 文档的填充需求同样广泛。许多业务场景需要基于固定模板动态生成文档，例如合同、报表、出口贸易文件等。手动填充这些文档效率低下，且容易出错，因此我决定开发一个 doc 工具，简化 Word 文档模板的生成过程。

核心思路：基于标签解析和数据替换

doc 工具的核心理念是 将模板中的数据用 Map 封装后传入，再解析 Word 模板中的标签并替换数据。

在 Word 模板（.docx）文件中，我们可以使用类似 #{Map.TradeMode}、#{Table.CNYSalesAmount} 这样的标签作为占位符，来标识需要填充的数据。例如，Word 文档模板可能包含以下内容：

贸易模式：#{Map.TradeMode}  
销售金额：#{Table.CNYSalesAmount}

而在代码中，我设计了 DocUtil.replaceContent 方法来自动填充这些占位符，调用方式如下：


DocUtil.replaceContent(response.getOutputStream(), map, 
new ClassPathResource("report/ExportXXXXXXX.docx").getInputStream());

其中，map 是封装后的数据结构，例如：

map.put("#{Map.HSCode}", exportXXXXXXDTO.getHSCode());
map.put("Table", exportXXXXXXXXXXDTOList);

#{Map.HSCode} 这样的标签会被 exportXXXXXXDTO.getHSCode() 的值替换。
"Table" 代表一组数据，适用于表格填充的情况。

解析 Word 表格中的占位符并替换数据

在 Word 文档中，表格是一个常见的结构，我们需要检查表格中的每一行是否包含 #{Map 这样的标签，并进行替换。以下是核心代码示例：

for (int i = 0; i < xwpfTable.getRows().size(); i++) {
    if (checkRowCell(xwpfTable.getRows().get(i), "#{Map")) { 
        // 遍历该行的所有单元格
        for (XWPFTableCell xwpfTableCell : xwpfTable.getRows().get(i).getTableCells()) {
            for (XWPFParagraph cellParagraph : xwpfTableCell.getParagraphs()) {
                // 替换单元格中的占位符
                updateRuns(cellParagraph.getRuns(), replaceMap, "#{Map");
            }
        }
    }
}

代码解析：