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

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

准备工作

环境搭建

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

xml 复制代码

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

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

编写代码

导入必要的包

java 复制代码

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;

创建主类和方法

java 复制代码

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文档。

java 复制代码

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

2. 替换文本

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

3. 处理表格

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

java 复制代码

// 获取文档中的所有表格
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的方法来添加或删除行和列。

java 复制代码

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

5. 插入图片

使用XWPFPictureData类来插入图片。

java 复制代码

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来设置文档的样式。

java 复制代码

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来访问和修改的。

java 复制代码

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

8. 保存文档

最后，记得保存文档。

java 复制代码

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

总结

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