Apache POI 是一个开源库，专门用于处理 Microsoft Office 格式的文件，特别是 Excel。在 Java 开发中，如果你需要读取、写入或修改 Excel 文档，Apache POI 提供了丰富的 API。在这个 poi 基础教程中，我们将重点讨论如何使用 HSSFWorkbook 类来创建和操作 Excel 文件。
1. **HSSFWorkbook 类**
HSSFWorkbook 是 Apache POI 库中的核心类，用于处理 Excel 97-2007 工作簿（.xls 格式）。它是 `java.lang.Object` 的子类，同时也是 `org.apache.poi.hssf.usermodel` 包下的一个类。这个类提供了创建、读取和修改 Excel 工作簿的基本功能。
创建一个新的 HSSFWorkbook 实例非常简单，只需调用无参构造函数即可：
```java
HSSFWorkbook workbook = new HSSFWorkbook();
```
除了无参构造函数，还有其他几个构造函数，例如从输入流中读取工作簿或使用已存在的 POIFSFileSystem 对象。这些构造函数在处理已存在的 Excel 文件时非常有用。
2. **保存 Excel 文件**
创建好 HSSFWorkbook 实例后，我们可以通过调用 `write` 方法将其保存到输出流。这通常是一个 `FileOutputStream`，如下所示：
```java
FileOutputStream out = new FileOutputStream("sample.xls");
workbook.write(out);
```
调用 `write` 方法会将工作簿写入指定的文件，记得在完成操作后关闭输出流以释放资源。
3. **单元格操作**
在 HSSFWorkbook 中，你可以创建 Sheet（工作表），并在 Sheet 中创建 Row（行）和 Cell（单元格）。例如，创建一个新的 Sheet 并添加一行数据：
```java
Sheet sheet = workbook.createSheet("Sheet1");
Row row = sheet.createRow(0); // 第一行
Cell cell = row.createCell(0); // 第一列
cell.setCellValue("Hello, POI!");
```
单元格可以设置各种数据类型，如字符串、数字、日期等，并且可以进行格式化。
4. **读取 Excel 文件**
要读取 Excel 文件，你可以使用 `POIFSFileSystem` 或 ` OPCPackage`（对于 .xlsx 文件）打开文件，然后创建相应的 `Workbook` 实例。例如：
```java
FileInputStream fis = new FileInputStream("sample.xls");
HSSFWorkbook workbook = new HSSFWorkbook(fis);
// 现在可以访问工作簿中的 Sheet、Row 和 Cell
```
5. **POIFSFileSystem**
POIFSFileSystem 是 POI 库中的另一个关键组件，它用于处理旧版的 Microsoft Office 文件格式（如 .xls）。它可以用来读取或写入整个 POI 文件系统，包括多个工作簿、样式和其他元数据。
6. **异常处理**
在上述示例中，可以看到我们对 `IOException` 进行了捕获和处理。在处理文件操作时，确保正确处理可能抛出的异常是至关重要的。
在实际项目中，你可能还需要处理更多复杂的情况，比如合并单元格、设置样式、读取公式结果、处理图片等。Apache POI 提供了丰富的 API 来支持这些功能，使得 Java 开发者能够轻松地与 Excel 文档交互。通过深入学习和实践，你可以熟练掌握 POI 库，为你的项目带来强大的数据处理能力。
