Java使用Apache POI向Word文档中填充数据

Java使用Apache POI向Word文档中填充数据

向一个包含占位符的Word文档中填充数据，并保存为新的文档。

准备工作

1. 环境搭建

   • 在项目中添加Apache POI依赖。在pom.xml中添加如下依赖：

     <dependencies>
         <dependency>
             <groupId>org.apache.poi</groupId>
             <artifactId>poi-ooxml</artifactId>
             <version>5.2.2</version> <!-- 请检查最新的版本号 -->
         </dependency>
     </dependencies>

2. 准备Word文档

   • 创建一个.docx文件作为模板。在这个文档中，需要定义一些占位符，例如{``{name}}，{``{age}}等。这些占位符将在程序运行时被替换为实际的数据。

编写代码

1. 导入必要的包

   import org.apache.poi.xwpf.usermodel.XWPFDocument;
   import org.apache.poi.xwpf.usermodel.XWPFParagraph;
   import org.apache.poi.xwpf.usermodel.XWPFRun;
   
   import java.io.File;
   import java.io.FileInputStream;
   import java.io.FileOutputStream;
   import java.util.List;

2. 创建主类和方法

   public class WordFiller {
       public static void main(String[] args) {
           try {
               fillDocumentWithValues();
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
       
       private static void fillDocumentWithValues() throws Exception {
           // 1. 加载现有的Word文档
           FileInputStream fis = new FileInputStream(new File("template.docx"));
           XWPFDocument document = new XWPFDocument(fis);
           
           // 2. 遍历文档中的所有段落
           List<XWPFParagraph> paragraphs = document.getParagraphs();
           for (XWPFParagraph paragraph : paragraphs) {
               // 3. 遍历每个段落中的所有run
               List<XWPFRun> runs = paragraph.getRuns();
               if (runs != null) {
                   for (XWPFRun run : runs) {
                       // 4. 获取文本并替换占位符
                       String text = run.getText(0);
                       if (text != null) {
                           text = text.replaceAll("\\{\\{name\\}\\}", "John Doe");
                           text = text.replaceAll("\\{\\{age\\}\\}", "30");
                           run.setText(text, 0);
                       }
                   }
               }
           }
           
           // 5. 将修改后的文档保存到新的文件
           FileOutputStream out = new FileOutputStream("filled-document.docx");
           document.write(out);
           
           // 6. 关闭所有打开的资源
           out.close();
           fis.close();
           document.close();
       }
   }

复杂文档的处理

1. 加载文档

首先，加载Word文档。

FileInputStream fis = new FileInputStream(new File("complex-template.docx"));
XWPFDocument document = new XWPFDocument(fis);

2. 替换文本

对于简单文本的替换，前面的示例已经涵盖了基本方法。对于复杂的文档，可能需要根据不同的情况来决定如何替换文本。

3. 处理表格

如果文档中包含表格，可以使用XWPFTable类来操作表格。

// 获取文档中的所有表格
List<XWPFTable> tables = document.getTables();

for (XWPFTable table : tables) {
    // 遍历表格中的每一行
    for (int i = 0; i < table.getNumberOfRows(); i++) {
        XWPFTableRow row = table.getRow(i);

        // 遍历行中的每一列
        for (int j = 0; j < row.getTableCells().size(); j++) {
            XWPFTableCell cell = row.getCell(j);
            // 获取单元格中的所有段落
            List<XWPFParagraph> paragraphs = cell.getParagraphs();
            
            for (XWPFParagraph paragraph : paragraphs) {
                // 替换单元格中的文本
                List<XWPFRun> runs = paragraph.getRuns();
                if (runs != null) {
                    for (XWPFRun run : runs) {
                        String text = run.getText(0);
                        if (text != null) {
                            text = text.replaceAll("\\{\\{name\\}\\}", "John Doe");
                            text = text.replaceAll("\\{\\{age\\}\\}", "30");
                            run.setText(text, 0);
                        }
                    }
                }
            }
        }
    }
}

4. 添加/删除表格行或列

可以通过XWPFTable的方法来添加或删除行和列。

XWPFTable table = tables.get(0); // 获取第一个表格
XWPFTableRow newRow = table.createRow(); // 添加新行
newRow.createCell().setText("New Column"); // 添加新列，并设置文本

5. 插入图片

使用XWPFPictureData类来插入图片。

File imgFile = new File("path/to/image.png");
FileInputStream fisImg = new FileInputStream(imgFile);
byte[] bytes = new byte[(int) imgFile.length()];
fisImg.read(bytes);

XWPFParagraph para = document.createParagraph();
XWPFRun run = para.createRun();
run.addPicture(bytes, XWPFDocument.PICTURE_TYPE_PNG, "image.png", Units.toEMU(150), Units.toEMU(150));

6. 设置样式

可以通过XWPFStyle来设置文档的样式。

XWPFStyle style = document.createStyle();
style.setStyleName("MyStyle");
style.setType(XWPFStyle.STYLE_TYPE.CHARACTER);
style.setFontFamily("Arial");

// 应用样式
XWPFParagraph para = document.createParagraph();
para.getStyle().setStyleName("MyStyle");

7. 处理页眉和页脚

页眉和页脚也是可以通过XWPFHeader和XWPFFooter来访问和修改的。

XWPFHeader header = document.getDocument().getBody().getHeaders().get(0);
XWPFParagraph headerPara = header.createParagraph();
headerPara.createRun().setText("This is the header");

8. 保存文档

最后，记得保存文档。

FileOutputStream out = new FileOutputStream("output.docx");
document.write(out);
out.close();
document.close();

总结

处理复杂文档时，需要根据文档的具体内容来确定需要处理哪些元素。Apache POI提供了丰富的API来操作Word文档的各种组成部分。通过组合使用这些API，可以实现对文档的全面控制，从而满足各种复杂的需求。务必注意，处理大型文档时，内存管理变得非常重要，因为加载整个文档到内存可能会消耗大量的资源。在处理完毕后，及时关闭流和文档对象是很重要的。