在Java开发中，Apache POI是一个非常常用的库，用于处理Microsoft Office文档（如Word、Excel、PowerPoint等）。POI提供了一套丰富的API，允许开发者读取、写入和操作这些文件格式。Apache POI支持的文件格式包括Excel (.xls 和 .xlsx)、Word (.doc 和 .docx)、PowerPoint (.ppt 和 .pptx)等。无论你是在开发一个文档生成工具，还是需要解析已有的文件，Apache POI都是一个非常强大的工具。

本文将详细介绍如何在Java项目中使用Maven依赖来集成Apache POI，以及如何使用POI处理Excel文件（作为例子）。我们将逐步说明如何通过Maven引入Apache POI依赖，接着讲解如何在Java代码中使用POI API来读取、写入Excel文件。本文的目标是为你提供清晰、易懂的Apache POI使用指南。

1. 引入Apache POI依赖

在Maven项目中，使用Apache POI非常简单。首先，你需要在"pom.xml"文件中添加POI的依赖。Apache POI的Maven依赖包括多个子模块，例如HSSF（用于处理".xls"文件），XSSF（用于处理".xlsx"文件），以及POI的核心模块。通常情况下，我们需要使用XSSF和HSSF模块来处理不同版本的Excel文件。

以下是一个示例"pom.xml"文件中添加POI依赖的配置：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.3</version>
</dependency>
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-collections4</artifactId>
    <version>4.4</version>
</dependency>

在这个配置中，"poi-ooxml"用于处理".xlsx"格式的Excel文件，"poi"是POI的核心库，"commons-collections4"是POI的一个依赖库，通常POI的功能需要它的支持。

2. 读取Excel文件

Apache POI可以非常方便地读取Excel文件。我们接下来会展示如何使用POI来读取一个Excel文件中的数据。在这个例子中，我们假设文件是".xlsx"格式。

首先，我们需要导入一些POI的类，并加载Excel文件。以下是读取Excel文件的代码示例：

import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

public class ExcelReader {
    public static void main(String[] args) throws IOException, InvalidFormatException {
        // 文件路径
        FileInputStream file = new FileInputStream(new File("example.xlsx"));
        
        // 创建一个Workbook对象
        Workbook workbook = new XSSFWorkbook(file);
        
        // 获取第一个Sheet
        Sheet sheet = workbook.getSheetAt(0);
        
        // 遍历Sheet中的每一行
        for (Row row : sheet) {
            // 遍历每一行中的每个单元格
            for (Cell cell : row) {
                // 根据单元格的类型读取内容
                switch (cell.getCellType()) {
                    case STRING:
                        System.out.print(cell.getStringCellValue() + "\t");
                        break;
                    case NUMERIC:
                        System.out.print(cell.getNumericCellValue() + "\t");
                        break;
                    default:
                        System.out.print("未知类型\t");
                        break;
                }
            }
            System.out.println();
        }
        
        // 关闭资源
        workbook.close();
        file.close();
    }
}

这段代码的功能是读取一个Excel文件，遍历每一行，每一列的单元格，并打印它们的值。注意，在实际使用时，需要根据Excel的实际数据类型来处理单元格的内容，POI提供了多种方法来获取不同类型的数据。

3. 创建和写入Excel文件

除了读取Excel文件，POI还支持创建和修改Excel文件。接下来，我们将演示如何使用POI创建一个新的Excel文件，并将数据写入到文件中。

以下是一个创建Excel文件并写入数据的代码示例：

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelWriter {
    public static void main(String[] args) throws IOException {
        // 创建一个工作簿
        Workbook workbook = new XSSFWorkbook();
        
        // 创建一个Sheet
        Sheet sheet = workbook.createSheet("Sheet1");
        
        // 创建行和单元格并写入数据
        Row row = sheet.createRow(0);
        Cell cell1 = row.createCell(0);
        cell1.setCellValue("姓名");
        Cell cell2 = row.createCell(1);
        cell2.setCellValue("年龄");
        
        Row row2 = sheet.createRow(1);
        row2.createCell(0).setCellValue("张三");
        row2.createCell(1).setCellValue(25);
        
        Row row3 = sheet.createRow(2);
        row3.createCell(0).setCellValue("李四");
        row3.createCell(1).setCellValue(30);
        
        // 写入Excel文件
        FileOutputStream fileOut = new FileOutputStream("output.xlsx");
        workbook.write(fileOut);
        
        // 关闭资源
        fileOut.close();
        workbook.close();
    }
}

这段代码将创建一个新的Excel文件，并在其中添加一个名为“Sheet1”的工作表，接着添加三行数据。第一行是表头，后面两行是数据内容。最后，我们将Excel文件保存为"output.xlsx"。

4. Excel文件格式的选择

Apache POI支持两种主要的Excel格式：HSSF（".xls"）和XSSF（".xlsx"）。HSSF是老版本的Excel文件格式（Excel 97-2003），而XSSF是较新的Excel 2007及以后的版本（".xlsx"）。在使用POI时，通常需要根据文件的扩展名选择合适的API。

对于".xls"格式的文件，使用"HSSFWorkbook"类处理；对于".xlsx"格式的文件，使用"XSSFWorkbook"类。前面给出的代码示例使用的是"XSSFWorkbook"，它适用于".xlsx"格式的文件。如果你需要处理".xls"文件，可以将"XSSFWorkbook"替换为"HSSFWorkbook"。

5. 总结

Apache POI是一个功能强大的Java库，用于操作Microsoft Office文档，尤其是在处理Excel文件时非常方便。本文通过Maven依赖的方式引入了POI库，并展示了如何使用POI读取和写入Excel文件。通过POI，你可以轻松地处理Excel文件中的数据，创建新的Excel文件，或者修改现有的文件。

要记住，在处理大文件时，POI可能会占用较多的内存，因此在处理大数据时可以使用流式API（例如"SXSSF"）来优化内存使用。希望本文能够帮助你更好地理解和使用Apache POI进行文档处理。