Java使用Word模板通过POI生成文件完整指南

什么是POI？

Apache POI是Apache软件基金会的开源项目，提供Java API用于操作Microsoft Office格式文件。其中，XWPF组件专门用于处理Word文档（.docx格式）。

通过POI，开发者可以在Java应用中创建、修改和读取Word文档，特别适合生成报表、合同、证书等需要模板化的文档。

工作原理

使用模板生成Word文件的核心思路是：

• 预先设计一个包含占位符的Word模板（如${name}, ${date}）
• Java程序读取该模板文件
• 在内存中查找并替换所有占位符为实际数据
• 将修改后的文档保存为新的Word文件

基本实现步骤

1. 添加Maven依赖

   <dependency>
       <groupId>org.apache.poi</groupId>
       <artifactId>poi-ooxml</artifactId>
       <version>5.2.4</version>
   </dependency>

2. 创建模板

   设计Word文档，使用${变量名}作为占位符，如：${customerName}, ${orderDate}

3. 编写Java代码

   import org.apache.poi.xwpf.usermodel.*;
   
   public class WordGenerator {
       public void generateFromTemplate(String templatePath, String outputPath, Map<String, String> data) 
               throws Exception {
           // 读取模板
           XWPFDocument doc = new XWPFDocument(OPCPackage.open(templatePath));
           
           // 替换段落中的占位符
           for (XWPFParagraph p : doc.getParagraphs()) {
               List<XWPFRun> runs = p.getRuns();
               if (runs != null) {
                   for (XWPFRun run : runs) {
                       String text = run.getText(0);
                       if (text != null) {
                           for (Map.Entry<String, String> entry : data.entrySet()) {
                               text = text.replace("${" + entry.getKey() + "}", entry.getValue());
                           }
                           run.setText(text, 0);
                       }
                   }
               }
           }
           
           // 处理表格（可选）
           for (XWPFTable table : doc.getTables()) {
               // 遍历表格进行替换...
           }
           
           // 保存文件
           FileOutputStream out = new FileOutputStream(outputPath);
           doc.write(out);
           out.close();
           doc.close();
       }
   }

高级技巧

• 表格动态填充：遍历模板中的表格，根据数据量动态添加行
• 图片插入：使用XWPFRun.addPicture()方法插入二进制图片数据
• 样式保持：模板中的字体、颜色、段落格式会被自动保留
• 条件内容：通过特殊标记实现内容的条件显示/隐藏

这些功能使POI非常适合生成复杂的业务文档，如财务报表、法律合同、个性化证书等。

应用场景

该技术广泛应用于：

• 企业级报表系统自动导出
• 电商平台订单合同生成
• 人力资源系统生成录用通知书
• 教育机构生成成绩单和证书
• 任何需要批量生成个性化Word文档的场景