一个超级牛的Java工具库

在软件开发中，操作文档文件格式，如Excel、Word等，是程序员经常会遇到的一项任务。Apache POI，一个强大的Java库，使得在Java程序中处理这些文件格式变得轻而易举。

本文将介绍Apache POI的使用，通过具体的代码示例，让大家能够快速上手并在日常工作中运用它。

Apache POI 是什么

Apache POI，是一个由Apache软件基金会维护的开源Java库，它支持读取和写入Microsoft Office格式文件，如Word文档（.doc, .docx）、Excel电子表格（.xls, .xlsx）等。它广泛应用于需要操作Office文档的各种场景，如企业信息管理系统、在线文档编辑服务、自动化办公流程等。

Apache POI提供了全面的API，允许开发者以编程方式创建、修改、格式化和提取数据等多种操作。它支持从早期版本的Office格式（如97-2003的.xls和.doc）到最新的.xlsx和.docx格式。

由于其功能强大且免费，Apache POI在Java社区中备受推崇，成为处理Microsoft Office文档格式的事实上的标准库。

如何引入Apache POI

Maven项目

在Java项目中使用Apache POI库，最常见的方式是通过Maven进行依赖管理。首先，确保你的pom.xml文件中包含了Apache POI的相关依赖。以下是一个基本的例子：

<dependencies>
    <!-- Apache POI Word (for .docx files) -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>你的版本号</version>
    </dependency>
    
    <!-- Apache POI Excel (for .xlsx files) -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>你的版本号</version>
    </dependency>
    
    <!-- Apache POI HWPF (for .doc files) -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>你的版本号</version>
    </dependency>
</dependencies>

请将你的版本号替换为最新的Apache POI版本号。你可以在Apache POI的官方网站Apache POI Downloads找到最新的版本号。

非Maven项目

如果你不使用Maven，也可以手动下载Apache POI的jar包并添加到你的项目的类路径中。你可以从官方网站下载jar包，或者使用包管理工具如JCenter或Maven Central。

一旦下载了jar包，你可以将其解压，并将解压后的lib目录中的所有jar文件复制到你的项目的lib目录中，或者直接将jar文件拖拽到你的IDE中，使其添加到项目的类路径中。

请注意，与Maven方式相比，手动安装可能需要你手动管理jar包的版本和依赖关系，因此推荐使用Maven或类似依赖管理工具来简化这一过程。

Apache POI 使用示例

1. 读取Excel文件

Apache POI支持读取不同格式的Excel文件，如.xls和.xlsx。下面是一个简单的示例，展示如何读取一个Excel文件并打印其中的数据。

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

import java.io.File;
import java.io.FileInputStream;
import java.util.Iterator;

public class ReadExcel {
    public static void main(String[] args) {
        try {
            // 创建FileInputStream对象，用于读取Excel文件
            FileInputStream file = new FileInputStream(new File("example.xlsx"));

            // 创建Workbook对象，用于操作Excel文件
            Workbook workbook = new XSSFWorkbook(file);

            // 获取Sheet对象
            Sheet sheet = workbook.getSheetAt(0);

            // 遍历行
            for (Iterator<Row> rows = sheet.iterator(); rows.hasNext(); ) {
                Row row = rows.next();

                // 遍历列
                for (Iterator<Cell> cells = row.cellIterator(); cells.hasNext(); ) {
                    Cell cell = cells.next();

                    // 获取单元格数据
                    String cellValue = getCellValue(cell);

                    // 打印单元格数据
                    System.out.print(cellValue + "\t");
                }
                System.out.println();
            }

            // 关闭Workbook和FileInputStream对象
            workbook.close();
            file.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    // 根据单元格类型获取数据
    public static String getCellValue(Cell cell) {
        CellType cellType = cell.getCellType();
        switch (cellType) {
            case STRING:
                return cell.getStringCellValue();
            case NUMERIC:
                if (DateUtil.isCellDateFormatted(cell)) {
                    return cell.getDateCellValue().toString();
                } else {
                    return Double.toString(cell.getNumericCellValue());
                }
            case BOOLEAN:
                return Boolean.toString(cell.getBooleanCellValue());
            case FORMULA:
                return cell.getCellFormula();
            default:
                return "";
        }
    }
}

2. 写入Excel文件

我们也可以使用Apache POI来创建或写入Excel文件。下面是一个简单的示例，展示如何创建一个Excel文件并写入数据。

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

import java.io.FileOutputStream;

public class WriteExcel {
    public static void main(String[] args) {
        try {
            // 创建Workbook对象
            Workbook workbook = new XSSFWorkbook();

            // 创建Sheet对象
            Sheet sheet = workbook.createSheet("Example Sheet");

            // 创建行
            Row row = sheet.createRow(0);

            // 创建单元格
            Cell cell = row.createCell(0);

            // 设置单元格数据
            cell.setCellValue("Hello, World!");

            // 创建FileOutputStream对象，用于写入Excel文件
            FileOutputStream fileOut = new FileOutputStream("example.xlsx");

            // 写入Workbook对象到文件
            workbook.write(fileOut);

            // 关闭Workbook和FileOutputStream对象
            workbook.close();
            fileOut.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

这两个示例展示了Apache POI读取和写入Excel文件的基础操作。在实际应用中，你可以根据需求进行更复杂的操作，如样式设置、图片插入、公式计算等。

Apache POI 的应用场景

Apache POI 是一个流行的Java库，用于处理Microsoft Office文档，尤其是Excel文档。它的应用场景广泛，可以帮助开发者高效地处理Office文件，实现办公自动化。

1. 读取和创建Excel文件

Apache POI 支持读取和创建各种Excel格式文件，包括 .xls 和 .xlsx。开发者可以使用它来读取Excel文件的内容，或者创建新的Excel文件。

// 创建一个新的Excel工作簿
XSSFWorkbook workbook = new XSSFWorkbook();
// 在工作簿中添加一个工作表
XSSFSheet sheet = workbook.createSheet("Example Sheet");
// 创建一个行对象
XSSFRow row = sheet.createRow(0);
// 创建一个单元格对象
XSSFCell cell = row.createCell(0);
// 设置单元格的值
cell.setCellValue("Hello, World!");
// 将工作簿写入文件系统
FileOutputStream out = new FileOutputStream("example.xlsx");
workbook.write(out);
out.close();

2. 数据分析和处理

开发者可以使用 Apache POI 读取Excel文件中的数据，进行分析和处理。例如，可以遍历工作表中的所有行和列，对数据进行统计和计算。

// 读取Excel文件
FileInputStream in = new FileInputStream("data.xlsx");
XSSFWorkbook workbook = new XSSFWorkbook(in);
XSSFSheet sheet = workbook.getSheetAt(0);

// 遍历工作表中的所有行和列
for (Row row : sheet) {
    for (Cell cell : row) {
        // 对单元格中的数据进行处理
        if (cell.getCellType() == CellType.NUMERIC) {
            double value = cell.getNumericCellValue();
            // 进行计算或分析
        }
    }
}

3. 报告生成和自动化

Apache POI 可以用于生成各种报告，例如财务报告、销售报告等。开发者可以将数据读取到Excel文件中，然后使用样式和格式进行排版，生成专业的报告。

// 创建一个新的Excel工作簿
XSSFWorkbook workbook = new XSSFWorkbook();
// 创建一个带有样式的字体对象
XSSFFont font = workbook.createFont();
font.setFontName("Arial");
font.setFontHeightInPoints((short) 12);
font.setBold(true);

// 创建一个样式对象，并设置字体
XSSFCellStyle style = workbook.createCellStyle();
style.setFont(font);

// 创建一个工作表
XSSFSheet sheet = workbook.createSheet("Report");
// 创建一个行对象
XSSFRow row = sheet.createRow(0);
// 创建一个单元格对象，并应用样式
XSSFCell cell = row.createCell(0);
cell.setCellValue("Report Title");
cell.setCellStyle(style);

// 将工作簿写入文件系统
FileOutputStream out = new FileOutputStream("report.xlsx");
workbook.write(out);
out.close();

4. 数据导入和导出

Apache POI 可以用于在数据库和Excel文件之间进行数据的导入和导出。开发者可以将数据库中的数据导出到Excel文件，或者将Excel文件中的数据导入到数据库。

// 假设有一个数据库连接和查询
Connection connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mydatabase", "username", "password");
Statement statement = connection.createStatement();
ResultSet resultSet = statement.executeQuery("SELECT * FROM mytable");

// 创建一个新的Excel工作簿
XSSFWorkbook workbook = new XSSFWorkbook();
XSSFSheet sheet = workbook.createSheet("Data");

// 将查询结果写入Excel文件
int rowNum = 0;
while (resultSet.next()) {
    XSSFRow row = sheet.createRow(rowNum++);
    int colNum = 0;
    // 遍历查询结果的列
    while (colNum < resultSet.getMetaData().getColumnCount()) {
        XSSFCell cell = row.createCell(colNum++);
        // 设置单元格的值
        cell.setCellValue(resultSet.getString(colNum + 1));
    }
}

// 将工作簿写入文件系统
FileOutputStream out = new FileOutputStream("data.xlsx");
workbook.write(out);
out.close();

以上是 Apache POI 的主要应用场景，通过这些场景可以看出，Apache POI 为Java开发者提供了强大的Excel文件处理能力，可以满足各种办公自动化需求。

总结

在这一章中，我们已经了解了Apache POI是什么，以及如何使用它来操作Microsoft Office文档。我们从引入和配置Apache POI开始，学习了如何通过添加pom依赖来引入Apache POI库。接下来，我们通过几个示例代码了解了Apache POI的基本使用方法，包括读取和写入Excel文件，创建和修改Word文档等。我们看到了Apache POI在处理Office文档方面的强大功能。

总的来说，Apache POI是一个功能强大且灵活的Java库，它使得在Java应用程序中处理Microsoft Office文档变得轻而易举。无论你是要读取、创建还是修改Excel文件或Word文档，Apache POI都能提供支持。它的易用性和丰富的API使得它成为处理Office文档的优选库。