Apache POI详解

前言

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

1. Apache POI简介

依赖配置

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

示例：替换占位符

3. 操作Word模板中的表格

示例：操作表格

4. 将Word文档转换为PDF

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

5. 处理PowerPoint文档

示例：操作PowerPoint文档

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项目中常用的依赖配置：

<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，内容如下：

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

简单代码示例：

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，其中包含一个表格：

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

简单代码示例：

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的依赖：

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

简单代码示例:

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，其中包含一个幻灯片，内容为：

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

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

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();}
}