### Apache POI 3.8 架构与应用详解
#### 一、Apache POI 概述
Apache POI 是一个由 Apache 软件基金会维护的开源项目，旨在为 Java 开发者提供一系列 API 以支持 Microsoft Office 文件格式的读写功能。POI 提供了对多种 Office 文档的支持，包括 Excel、Word 和 PowerPoint 等。
#### 二、Apache POI 3.8 结构解析
Apache POI 的核心模块主要分为以下几个部分：
1. **HSSF**：提供了对 Microsoft Excel (.xls) 格式的读写支持。HSSF 是“Horrible Sheets by Flowerjama”的缩写，用于处理早期版本的 Excel 文件。
2. **XSSF**：提供了对 Microsoft Excel OOXML (.xlsx) 格式的读写支持。XSSF 是“XML-based Spreadsheet”（基于 XML 的电子表格）的缩写，用于处理 Office 2007 及以上版本的 Excel 文件。
3. **HWPF**：提供了对 Microsoft Word (.doc) 格式的读写支持。HWPF 是“Horrible Words by Flowerjama”的缩写，用于处理 Word 文件。
4. **HSLF**：提供了对 Microsoft PowerPoint (.ppt) 格式的读写支持。HSLF 是“Horrible Slides by Flowerjama”的缩写，用于处理 PowerPoint 文件。
5. **HDGF**：提供了对 Microsoft Visio (.vdx) 格式的读写支持。HDGF 是“Horrible Drawings by Flowerjama”的缩写，用于处理 Visio 文件。
#### 三、创建 Excel 文档
Apache POI 的 HSSF 和 XSSF 模块分别提供了对 Excel 的 .xls 和 .xlsx 文件的支持。下面通过一个示例来展示如何使用 POI 创建 Excel 文档。
```java
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFCell;
import java.io.FileOutputStream;
public class CreateXL {
public static String outputFile = "D:\\test.xls";
public static void main(String[] argv) {
try {
HSSFWorkbook workbook = new HSSFWorkbook(); // 创建一个新的 Excel 工作簿
HSSFSheet sheet = workbook.createSheet("效益指标"); // 创建一个名为“效益指标”的工作表
HSSFRow row = sheet.createRow((short) 0); // 在索引 0 的位置创建行
HSSFCell cell = row.createCell((short) 0); // 在索引 0 的位置创建单元格
cell.setCellType(HSSFCell.CELL_TYPE_STRING); // 设置单元格类型为字符串
cell.setCellValue("增加值"); // 设置单元格的值
FileOutputStream fOut = new FileOutputStream(outputFile); // 创建输出文件流
workbook.write(fOut); // 将工作簿写入文件
fOut.flush();
fOut.close(); // 关闭文件流
System.out.println("文件生成成功");
} catch (Exception e) {
System.out.println("文件生成失败：" + e);
}
}
}
```
#### 四、读取 Excel 文档中的数据
除了创建 Excel 文档之外，POI 还可以用来读取现有 Excel 文件中的数据。下面的示例展示了如何读取一个 Excel 文件的数据。
```java
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFCell;
import java.io.FileInputStream;
public class ReadXL {
public static String fileToBeRead = "D:\\test1.xls";
public static void main(String[] argv) {
try {
HSSFWorkbook workbook = new HSSFWorkbook(new FileInputStream(fileToBeRead)); // 创建对 Excel 文件的引用
HSSFSheet sheet = workbook.getSheetAt(0); // 获取第一个工作表
for (int i = sheet.getFirstRowNum(); i <= sheet.getLastRowNum(); i++) {
HSSFRow row = sheet.getRow(i);
if (row != null) {
for (int j = row.getFirstCellNum(); j < row.getLastCellNum(); j++) {
HSSFCell cell = row.getCell(j);
if (cell != null) {
System.out.print(cell.toString() + "\t");
}
}
System.out.println();
}
}
} catch (Exception e) {
System.out.println("文件读取失败：" + e);
}
}
}
```
通过以上示例，我们可以看到 Apache POI 提供了强大的功能来支持对 Microsoft Office 文件的操作。无论是创建新文档还是读取现有文档，POI 都能够满足开发者的需求，并且提供了丰富的 API 来处理这些文档。这对于需要与 Office 文档交互的应用来说是非常有价值的工具。
