Apache POI详解 - 技术栈

前言

[Apache POI是一个强大的Java库，广泛用于处理Microsoft Office文档，包括Word、Excel和PowerPoint等。本文将详细介绍如何使用Apache POI库操作Word模板（包括替换占位符、操作表格）、将Word文档转换为PDF，以及如何处理PowerPoint文档。我们将通过代码示例逐步演示这些操作。](#Apache POI是一个强大的Java库，广泛用于处理Microsoft Office文档，包括Word、Excel和PowerPoint等。本文将详细介绍如何使用Apache POI库操作Word模板（包括替换占位符、操作表格）、将Word文档转换为PDF，以及如何处理PowerPoint文档。我们将通过代码示例逐步演示这些操作。)

[1. Apache POI简介](#1. Apache POI简介)

依赖配置

[2. 操作Word模板中的占位符](#2. 操作Word模板中的占位符)

示例：替换占位符

[3. 操作Word模板中的表格](#3. 操作Word模板中的表格)

示例：操作表格

[4. 将Word文档转换为PDF](#4. 将Word文档转换为PDF)

[示例：使用Apache PDFBox将Word转换为PDF](#示例：使用Apache PDFBox将Word转换为PDF)

[5. 处理PowerPoint文档](#5. 处理PowerPoint文档)

示例：操作PowerPoint文档

[6. 总结](#6. 总结)

前言

Apache POI是一个强大的Java库，广泛用于处理Microsoft Office文档，包括Word、Excel和PowerPoint等。本文将详细介绍如何使用Apache POI库操作Word模板（包括替换占位符、操作表格）、将Word文档转换为PDF，以及如何处理PowerPoint文档。我们将通过代码示例逐步演示这些操作。

1. Apache POI简介

Apache POI（Poor Obfuscation Implementation）是一个开源的Java库，主要用于处理Microsoft Office文档。它支持多种Office文档格式，包括：

Word ：.doc（旧版）和.docx（新版）。
Excel ：.xls（旧版）和.xlsx（新版）。
PowerPoint ：.ppt（旧版）和.pptx（新版）。

依赖配置

在使用Apache POI之前，需要在项目中添加相关的依赖。以下是Maven项目中常用的依赖配置：

XML 复制代码

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

poi：包含POI的核心功能，支持旧版Office格式。
poi-ooxml ：支持新版Office格式（如.docx、.xlsx、.pptx）。
poi-scratchpad：提供了一些额外的功能，如处理Outlook邮件格式。

2. 操作Word模板中的占位符

在Word模板中，我们通常使用${}作为占位符，表示需要动态替换的内容。以下代码示例展示了如何读取Word模板并替换占位符。

示例：替换占位符

假设我们有一个Word模板template.docx，内容如下：

XML 复制代码

尊敬的${name}：
    您的订单编号为${orderId}，已成功支付。

简单代码示例：

java 复制代码

import org.apache.poi.xwpf.usermodel.*;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
public class WordTemplateExample {
    public static void main(String[] args) throws IOException {
        // 打开Word模板
        FileInputStream file = new FileInputStream("template.docx");
        XWPFDocument document = new XWPFDocument(file);
        // 定义占位符的替换内容
        Map<String, String> replacements = new HashMap<>();
        replacements.put("${name}", "张三");
        replacements.put("${orderId}", "123456");
        // 遍历段落并替换占位符
        for (XWPFParagraph paragraph : document.getParagraphs()) {
            String text = paragraph.getText();
            for (Map.Entry<String, String> entry : replacements.entrySet()) {
                if (text != null && text.contains(entry.getKey())) {
                    text = text.replace(entry.getKey(), entry.getValue());
                    paragraph.removeRun(0); // 删除原有内容
                    paragraph.createRun().setText(text); // 插入新内容
                }
            }
        }
        // 保存修改后的文档
        FileOutputStream out = new FileOutputStream("output.docx");
        document.write(out);
        // 关闭文档
        document.close();
        out.close();
    }
}

3. 操作Word模板中的表格

Word文档中的表格是常见的结构化数据展示方式。以下代码示例展示了如何读取和修改Word模板中的表格。

示例：操作表格

假设我们有一个Word模板template.docx，其中包含一个表格：

java 复制代码

| 姓名   | 年龄 | 性别 |
|--------|------|------|
| ${name}| ${age}| ${gender}|

简单代码示例：

java 复制代码

import org.apache.poi.xwpf.usermodel.*;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
public class WordTableExample {
    public static void main(String[] args) throws IOException {
        // 打开Word模板
        FileInputStream file = new FileInputStream("template.docx");
        XWPFDocument document = new XWPFDocument(file);
        // 定义占位符的替换内容
        Map<String, String> replacements = new HashMap<>();
        replacements.put("${name}", "李四");
        replacements.put("${age}", "25");
        replacements.put("${gender}", "男");
        // 遍历表格并替换占位符
        for (XWPFTable table : document.getTables()) {
            for (XWPFTableRow row : table.getRows()) {
                for (XWPFTableCell cell : row.getTableCells()) {
                    for (XWPFParagraph paragraph : cell.getParagraphs()) {
                        String text = paragraph.getText();
                        for (Map.Entry<String, String> entry : replacements.entrySet()) {
                            if (text != null && text.contains(entry.getKey())) {
                                text = text.replace(entry.getKey(), entry.getValue());
                                paragraph.removeRun(0); // 删除原有内容
                                paragraph.createRun().setText(text); // 插入新内容
                            }
                        }
                    }
                }
            }
        }
        // 保存修改后的文档
        FileOutputStream out = new FileOutputStream("output.docx");
        document.write(out);
        // 关闭文档
        document.close();
        out.close();
    }
}

4. 将Word文档转换为PDF

将Word文档转换为PDF是一个常见的需求。我们可以使用Apache POI结合其他库（如Apache PDFBox或iText）来实现这一功能。

示例：使用Apache PDFBox将Word转换为PDF

首先，添加PDFBox的依赖：

XML 复制代码

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.27</version>
</dependency>

简单代码示例:

java 复制代码

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
public class WordToPdfExample {
    public static void main(String[] args) throws IOException {
        // 打开Word文档
        FileInputStream file = new FileInputStream("output.docx");
        XWPFDocument document = new XWPFDocument(file);
        // 创建PDF文档
        PDDocument pdfDocument = new PDDocument();
        PDPage page = new PDPage();
        pdfDocument.addPage(page);
        // 写入PDF内容
        PDPageContentStream contentStream = new PDPageContentStream(pdfDocument, page);
        contentStream.setFont(PDType1Font.HELVETICA_BOLD, 12);
        contentStream.beginText();
        contentStream.newLineAtOffset(100, 700);
        for (XWPFParagraph paragraph : document.getParagraphs()) {
            contentStream.showText(paragraph.getText());
            contentStream.newLineAtOffset(0, -15);
        }
        contentStream.endText();
        contentStream.close();
        // 保存PDF文件
        pdfDocument.save("output.pdf");
        // 关闭文档
        pdfDocument.close();
        document.close();
    }
}

5. 处理PowerPoint文档

Apache POI也支持处理PowerPoint文档。以下代码示例展示了如何读取和修改PowerPoint文档。

示例：操作PowerPoint文档

假设我们有一个PowerPoint模板template.pptx，其中包含一个幻灯片，内容为：

java 复制代码

标题：${title}
内容：${content}

操作PowerPoint文档的简单代码示例：

java 复制代码

import org.apache.poi.xslf.usermodel.*;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
public class PowerPointExample {
    public static void main(String[] args) throws IOException {
        // 打开PowerPoint模板
        FileInputStream file = new FileInputStream("template.pptx");
        XMLSlideShow ppt = new XMLSlideShow(file);
        // 定义占位符的替换内容
        Map<String, String> replacements = new HashMap<>();
        replacements.put("${title}", "项目报告");
        replacements.put("${content}", "这是项目的最新进展。");
        // 遍历幻灯片并替换占位符
        for (XSLFSlide slide : ppt.getSlides()) {
            for (XSLFShape shape : slide.getShapes()) {
                if (shape instanceof XSLFTextShape) {
                    XSLFTextShape textShape = (XSLFTextShape) shape;
                    String text = textShape.getText();
                    for (Map.Entry<String, String> entry : replacements.entrySet()) {
                        if (text != null && text.contains(entry.getKey())) {
                            text = text.replace(entry.getKey(), entry.getValue());
                            textShape.clearText(); // 清除原有内容
                            textShape.setText(text); // 插入新内容
                        }
                    }
                }
            }
        }
        // 保存修改后的文档
        FileOutputStream out = new FileOutputStream("output.pptx");
        ppt.write(out);
        // 关闭文档
        ppt.close();
        out.close();
    }
}

6. 总结

通过Apache POI库，可以轻松地操作Word模板（包括替换占位符、操作表格）、将Word文档转换为PDF，以及处理PowerPoint文档。本文提供了详细的代码示例，帮助您快速上手这些操作。如果您有更多需求或问题，欢迎在评论区留言讨论！