POI是Apache 提供的一个开源的Java API，用于操作Microsoft文档格式，如Excel、Word和PowerPoint等。POI是Java中处理Microsoft文档最受欢迎的库。
截至2023/12， 最新版本时 POI 5.2.5。
JDK版本兼容
| POI版本 | JDK版本 |
|---|---|
| 4.0及之上版本 | > 1.8 |
| 3.11及之后的 3.x | > 1.6 |
| 3.5 到 3.10 | >1.5 |
| 3.5 之前的版本 | 1.4+ |
使用Maven导入POI相关依赖
要使用 Apache POI 处理 Excel 文件，一般需要导入以下 Maven 依赖：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.5</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.5</version>
</dependency>
其中，
poi是基础依赖，提供了操作 Excel 文件的核心功能；poi-ooxml是操作 Office Open XML 格式文件（如 .xlsx、.docx 等）的扩展库。
只需要处理 Excel 文件，以上两个依赖已经足够了。如果需要处理 Word、PowerPoint 等其它类型的 Office 文件，还需要导入相应的扩展库。
基本示例
以下是一个使用POI 5创建和编辑Excel文件的示例代码：
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.FileOutputStream;
import java.io.IOException;
public class PoiExample {
public static void main(String[] args) throws IOException {
// 创建一个新的工作簿
Workbook workbook = new XSSFWorkbook();
// 创建一个新的工作表
Sheet sheet = workbook.createSheet("Sheet1");
// 创建一行并在其中添加单元格
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("Hello, World!");
// 将工作表写入文件
String filename = "example.xlsx";
FileOutputStream outputStream = new FileOutputStream(filename);
workbook.write(outputStream);
outputStream.close();
System.out.println("Excel文件已创建并保存到 " + filename);
}
}
此代码将创建一个名为"example.xlsx"的新Excel文件，并在第一个工作表上添加一个单元格，其中包含文本"Hello, World!"。
产生的Excel 文件打开之后的画面如下所示：
请注意，在代码中我们使用了XSSFWorkbook类，这个类是用于处理.xlsx文件格式的工作簿。 如果你要处理.xls文件格式，则需要使用HSSFWorkbook类。
HSSFWorkbook和XSSFWorkbook区别
在POI中，HSSFWorkbook和XSSFWorkbook都是用来表示Excel工作簿（workbook）的类，但它们在处理Excel格式上有所不同。
- HSSFWorkbook
HSSFWorkbook是POI中操作Excel 97-2003格式（.xls）的类。它基于“OLE2”文件格式，它使用的是旧的二进制格式，所以它的最大限制是65536行和256列。HSSFWorkbook有一些缺点，如不能处理大于2GB的文件，但它在兼容性和使用方面非常好，特别是在使用低版本的Excel时。
- XSSFWorkbook
XSSFWorkbook是POI中操作Excel 2007及以上版本（.xlsx）的类。它基于XML文件格式，使用基于ZIP的文件格式。相比HSSFWorkbook，XSSFWorkbook可以处理更大的文件，支持更多的格式，并提供更好的性能。
在选择HSSFWorkbook和XSSFWorkbook时，可以根据所需的Excel格式以及文件大小和处理性能的需要进行选择。
错误解决之：java.lang.NoSuchMethodError: org.apache.commons.io.output.UnsynchronizedByteArrayOutputStream.builder()
出现这个错误的原因可能时项目依赖的 Apache Commons IO 版本与 Apache POI 版本不兼容， 可能是项目已经导入了旧的 Apache Commons IO，但是POI要求的该库的版本又比较高，
Apache Commons IO是一个Java类库，它提供了许多有用的IO（输入/输出）实用程序，使得Java IO编程更加容易。它提供了一组简单而强大的工具类，可以用于处理常见的IO任务，如读写文件、复制文件、关闭文件流、处理文件路径等。此外，它还提供了一些高级功能，如符号链接处理、文件过滤器、流处理、资源管理等。Apache Commons IO项目是Apache Software Foundation的一个子项目，可以自由下载和使用。
该问题解决方法可以有多种：
-
检查项目中是否有多个版本的 Apache Commons IO。如果是，请删除其中一个版本。
-
更新Maven 依赖项，以确保 Apache POI 和 Apache Commons IO 版本是兼容的。比如说降级POI的版本到 ５.０.０．Maven导入修改为如下：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.0.0</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.0.0</version>
</dependency>
３. 如果使用的是较旧版本的 Apache POI，则升级到新版本。
poi-version.jar 基础依赖的包
在POI的基础依赖包的不同子包中存在一些同名的类， 比如Sheet , 在org.apache.poi.ss.usermodel和org.apache.poi.sl 中都存在， 这里看一下基础依赖的主要包及作用：
-
org.apache.poi.ss包是Apache POI库的核心包之一，它包含了用于处理Excel电子表格的类和接口。它提供了一些基于行和列的模型来处理Excel文件，支持Excel文件的读取、写入和修改。可以使用该包来创建、读取和编辑简单的Excel文件。
-
org.apache.poi.sl包则是Apache POI库的另一个包，它提供了一些类和接口，用于处理Microsoft Office Open XML文件格式中的幻灯片和演示文稿，如PPT和PPTX文件。它也包含了一些类和接口，用于处理其他的Office文件格式，如ODP和ODS文件。
-
org.apache.poi.hpsf 提供了处理Microsoft Office文档属性的功能。HPSF代表“文档摘要信息流”，是一个二进制格式，用于存储Office文档的元数据信息，比如作者、标题、主题、关键字、类别等等。
-
org.apache.poi.hssf负责处理HSSF格式的Excel文档。HSSF即“Horrible Spreadsheet Format”，是Excel二进制文件格式的一种。该包包含了一系列类，可以读取、创建、修改和写入HSSF格式的Excel文件，例如HSSFWorkbook、HSSFSheet、HSSFRow和HSSFCell等。通过使用org.apache.poi.hssf包，Java开发人员可以在应用程序中使用HSSF格式的Excel文件进行数据处理和导入导出操作。
-
org.apache.poi.poifs负责处理OLE 2 Compound Document格式的文件，包括Excel文件、Word文件、PowerPoint文件等。OLE 2 Compound Document是微软公司开发的一种文件格式，它可以将多个文件组合成一个文件，其中包括存储数据的流和存储元数据的属性表。
org.apache.poi.poifs包中包含了一些类和接口，可以读取、创建、修改和写入OLE 2 Compound Document格式的文件，例如POIFSFileSystem、POIFSWriter、DocumentEntry、DirectoryEntry等。开发人员可以使用这些类和接口来操作Excel、Word等文件格式，例如读取、写入、创建、修改、删除文件，以及查找文件等操作。
