Java Apache POI导出Excel实例：直接可使用

本文还有配套的精品资源，点击获取

简介：Apache POI库是Java中用于操作Microsoft Office文件的强大工具，特别是Excel。本文介绍了如何使用Apache POI库在Java项目中导出Excel文件。从引入依赖到创建工作簿、工作表、行和单元格，以及如何填充数据和导出文件，本文将提供完整的代码示例和详细解释。此外，还涉及如何调整样式和添加高级功能，以及如何根据实际需求对实例进行扩展。

1. Apache POI库介绍

Apache POI是Apache软件基金会旗下一个开源项目，提供了用于读取和写入Microsoft Office格式文档的Java库。它的出现不仅让Java开发者能够轻松地处理Word、Excel等文件，而且因其跨平台、开源的特性，在各种企业级应用中得到了广泛的应用。

POI的起源和应用场景

Apache POI最初是为了读取和写入Microsoft Office文件而生。随着时间的推移，它发展成为一个完整的解决方案，涵盖了从简单的文本处理到复杂的格式化和数据渲染。其应用场景包括但不限于自动化报告生成、数据分析、系统集成和文档内容管理。

POI库的基本组成结构

POI库主要由几个核心模块构成，包括HSSF和XSSF用于Excel文件操作，HWPF用于Word文档操作，以及HSLF用于PowerPoint幻灯片操作。每个模块都包含了一系列的类和接口，它们共同组成了Apache POI库的框架结构。

例如，在Excel处理中，用户可以通过Workbook接口及其相关的实现类来创建和管理Excel文档，而Cell接口和它的实现类则用于操作单个单元格，包括读写数据和设置格式。这些组成部分的细节和使用方式将在后续章节中详细探讨。

2. 引入Apache POI依赖

2.1 环境配置与依赖管理

2.1.1 项目中添加POI依赖的必要性

Apache POI库作为一个强大的Java库，它支持读写Microsoft Office格式的文件。当我们在Java项目中需要操作Excel文件时，引入POI库是必不可少的。POI库提供了丰富的API来访问和修改Excel文件，无需安装Microsoft Office软件，即可实现自动化处理Excel文档。此外，使用POI库还能帮助开发者避免处理各种二进制格式的复杂性，让代码更加清晰，维护起来更为便捷。

2.1.2 不同构建工具的依赖引入方法

Maven项目依赖引入

对于使用Maven进行项目管理的Java开发者而言，添加POI依赖到项目的 pom.xml 文件中是最常见的做法。以下是如何添加Apache POI的依赖到Maven项目中的示例代码：

<dependencies>
    <!-- Apache POI -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>5.2.3</version> <!-- 请替换为最新版本号 -->
    </dependency>
    <!-- Apache POI for Excel 2007+ (.xlsx) -->
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version> <!-- 请替换为最新版本号 -->
    </dependency>
</dependencies>

Gradle项目依赖引入

如果是使用Gradle构建工具的项目，可以在 build.gradle 文件中添加如下依赖配置：

dependencies {
    implementation 'org.apache.poi:poi:5.2.3' // 请替换为最新版本号
    implementation 'org.apache.poi:poi-ooxml:5.2.3' // 请替换为最新版本号
}

完成依赖引入后，可以执行相应的构建命令（如 mvn clean install 或 ./gradlew build ），以确保依赖能够被正确加载到项目中。

2.2 版本选择与兼容性问题

2.2.1 如何选择合适的POI版本

在选择Apache POI库的版本时，有几个重要的考虑因素。首先需要查看POI库的官方发布版本说明，确保选择的版本与您的项目需求相匹配。通常，最新版本的POI库会有最新的bug修复和性能提升。然而，最新并不总是最好的，你还需要考虑以下几点：

• 项目依赖库兼容性 ：如果你的项目已经依赖了某些特定版本的库，那么引入的POI库版本应与之兼容。
• API的稳定性 ：对于生产环境的项目，选择一个稳定版本的POI库通常更加稳妥，以避免潜在的API变动问题。
• 新特性 ：如果你的项目需要某些特定的、新增的POI特性，那么需要确保选择的版本支持这些特性。

2.2.2 兼容性问题的常见解决方案

在处理POI库的兼容性问题时，可以采取以下策略：

• 更新依赖库 ：如果发现版本不兼容，首先尝试更新项目中所有依赖的库到一个统一的版本，以减少版本差异带来的冲突。
• 使用shade插件 ：如果在打包时遇到类冲突问题，可以使用Maven的shade插件或Gradle的shadow插件重新打包应用，从而解决冲突。
• 使用BOM文件 ：为了确保整个项目依赖库的版本一致性，可以使用Maven的Bill Of Materials (BOM)文件统一管理依赖版本。
• 降级POI版本 ：在没有其他解决方案时，降级POI库到一个更旧但与项目兼容的版本，可以是暂时的解决方案，但要注意新版本中可能引入的特性无法使用。

通过以上方法，开发者可以有效地解决在引入和使用Apache POI库时遇到的兼容性问题，保证项目的顺利运行。

3. 创建和使用Workbook对象

3.1 Workbook对象概念

3.1.1 Workbook对象的作用和类型

Workbook在Apache POI库中扮演了管理Excel文档的核心角色，它是整个Excel文件数据结构的顶层接口。它负责提供对工作簿中Sheet（工作表）、以及其他高级特性如样式、模板和打印属性等的访问。

在POI中，Workbook有多种实现类，分别对应不同版本的Excel文件格式：

• HSSFWorkbook ：对应Microsoft Excel 97(-2007)文件格式，扩展名为.xls
• XSSFWorkbook ：对应Microsoft Excel 2007+ 文件格式，扩展名为.xlsx
• SXSSFWorkbook ：是一个特殊的实现，特别优化于处理大型文件，使用了流式API

选择合适的Workbook实现取决于你的文件格式需求和性能考虑。

3.1.2 不同类型的Workbook对象对比

不同Workbook对象之间的主要差异在于它们支持的Excel格式以及性能特性：

• HSSFWorkbook 和 XSSFWorkbook 是两个极端，前者是旧格式，后者是新格式。旧格式更受存储限制，通常有限制在65536行和256列内；新格式可以支持更多。
• SXSSFWorkbook 则是一个对大型工作簿优化的实现，它会将数据存储在磁盘上的临时文件中，减少内存使用，适合处理包含大量数据的工作表。
• 性能方面， SXSSFWorkbook 在处理非常大Excel文件时尤其出色，而 HSSFWorkbook 在内存使用上更为节俭，适合处理小型到中型的数据集。
• 功能方面， XSSFWorkbook 支持更多的新特性，如更丰富的样式和格式，而 HSSFWorkbook 则受到早期Excel版本的限制。

3.2 Workbook对象的操作

3.2.1 创建新的Workbook实例

创建一个新的Workbook实例相当简单，但是需要根据需要选择合适的实现类。例如，创建一个支持.xlsx格式的Workbook实例，可以使用以下代码：

// 引入对应的Workbook实现
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

// 创建一个新的XSSFWorkbook对象
XSSFWorkbook workbook = new XSSFWorkbook();

这段代码实例化了一个 XSSFWorkbook 对象，这个对象可以用来创建新的Sheet、Cell和Row等。

3.2.2 读取现有Excel文件为Workbook对象

当我们需要读取一个已经存在的Excel文件时，应该根据文件的格式选择合适的Workbook实现来读取。假设我们要读取一个.xlsx格式的文件，代码如下：

import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import java.io.File;
import java.io.FileInputStream;

// 指定文件路径
File file = new File("path/to/your/excel/file.xlsx");
FileInputStream fis = new FileInputStream(file);

// 使用XSSFWorkbook类读取文件为Workbook对象
Workbook workbook = new XSSFWorkbook(fis);

// 记得最后关闭文件输入流
fis.close();

在这段代码中， FileInputStream 用于读取文件，然后通过 XSSFWorkbook 的构造器将文件内容加载到Workbook对象中，之后我们就可以对这个Workbook进行操作了。

在本章节中，我们探讨了Workbook对象在Apache POI库中的角色和重要性，并通过具体代码展示了如何操作Workbook对象。下一部分我们将深入讲解Sheet对象的操作，包括创建、管理以及如何在Sheet中操作行和列。

4. 创建和使用Sheet对象

4.1 Sheet对象的创建与管理

4.1.1 Sheet的定义和用途

在Apache POI库中，Sheet是表示Excel工作簿中单个工作表的主要对象。每个Workbook对象可以包含多个Sheet，类似于Excel文件中的不同工作表标签页。Sheet对象的作用非常多样，它不仅用于数据的展示，还可以进行数据的读写操作，如添加数据、读取数据、格式化单元格等。

工作表（Sheet）是用户进行数据操作的主要场所，它使得数据的组织、管理以及呈现变得更为直观。在POI中，操作工作表对象是进行Excel文件操作的基础。

4.1.2 Sheet的添加、删除和获取方法

在Apache POI中，可以使用Workbook对象来添加、删除和获取Sheet。以下是一些基本操作方法的代码示例：

// 获取Workbook对象的默认工作表
Sheet sheet = workbook.getSheetAt(0); // 获取第一个工作表

// 添加一个新的工作表
Sheet newSheet = workbook.createSheet("New Sheet");

// 删除特定的工作表
workbook.removeSheetAt(0); // 删除第一个工作表

// 获取特定名称的工作表
Sheet specificSheet = workbook.getSheet("Sheet2");

4.1.3 Sheet对象的方法和属性

Sheet对象提供了许多方法来操作工作表，这些方法涉及获取工作表的行数、列数、工作表的名称，以及对工作表进行各种操作如合并单元格、自动调整列宽等。

// 获取工作表名称
String sheetName = sheet.getSheetName();

// 获取工作表的行数
int rowCount = sheet.getLastRowNum() + 1;

// 设置工作表名称
sheet.setSheetName(0, "Renamed Sheet");

// 合并单元格
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("Merged Cell");
sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 0));

4.2 Sheet数据操作

4.2.1 操作Sheet中的行和列

行（Row）和列（Cell）是工作表中的基本组成元素，用于存储数据。在Apache POI中，通过Row和Cell对象来操作工作表中的行和列。

// 创建新行并添加单元格
Row newRow = sheet.createRow(2);
newRow.createCell(0).setCellValue("New Row");

// 删除特定的行
sheet.shiftRows(1, 1, -1); // 将从第二行开始的所有行向上移动一行

// 获取特定的列数
short columnCount = sheet.getRow(0).getLastCellNum();

4.2.2 Sheet视图的调整和打印设置

Apache POI提供了丰富的方法来调整Sheet视图，比如调整列宽、行高、打印设置等。这使得我们可以对工作表进行更精细的调整，以满足不同的显示和打印需求。

// 设置列宽
sheet.setColumnWidth(0, (256 * 20)); // 设置第一列宽度

// 设置行高
sheet.getRow(0).setHeight((short) (256 * 15)); // 设置第一行高度

// 添加页眉和页脚
SheetPrintSetup printSetup = sheet.getPrintSetup();
printSetup.setPageStart((short) 1); // 设置打印起始页

在操作工作表的过程中，我们可能会遇到需要调整行和列的操作，以使得数据展示更为合理。Apache POI通过提供各种方法，使得这些操作变得简单和灵活。

flowchart TD
    A[开始操作Sheet对象] --> B[创建或获取Sheet]
    B --> C[添加或删除行]
    C --> D[合并单元格]
    D --> E[调整列宽和行高]
    E --> F[设置打印属性]
    F --> G[结束操作]

通过以上步骤，我们可以完成对Apache POI中Sheet对象的基本操作，无论是数据的增删改查还是视图的调整，都能有效利用所提供的API实现。在实际的应用中，这些操作对于处理Excel文件来说是非常基础且必须掌握的技能。

5. 创建和使用Row和Cell对象

5.1 Row和Cell对象基础

5.1.1 Row和Cell在Excel中的角色

在Apache POI库中， Row 和 Cell 对象是构建Excel文件的基石。 Row 代表Excel表中的行，而 Cell 代表行中的单元格。这些对象使得对Excel文档内容的编辑变得可能，无论是在填充数据、设置样式，还是在编写公式上。

Row 对象通常通过 Sheet 对象获得，而 Cell 对象则通过 Row 对象获得。它们之间的关系是层级式的，这允许开发人员在创建和操作Excel文件时，能够精确地定位和修改每一个单元格的数据。

5.1.2 Row和Cell对象的创建与引用

创建 Row 和 Cell 对象时，通常是在创建了 Sheet 对象之后。在POI中，当你首次通过 Sheet.createRow 或 Row.createCell 方法创建一个行或单元格时，它们被自动添加到Excel文档的对应结构中。

// 创建一个行对象示例
Row row = sheet.createRow(0);

// 创建一个单元格对象示例
Cell cell = row.createCell(0);

在上述代码中，我们首先创建了一个位于索引0（通常是Excel中的第一行）的 Row 对象。随后，我们在该 Row 对象中创建了一个位于索引0的 Cell 对象。通过索引操作 Row 和 Cell 对象时，需要注意，索引是从0开始的。

5.2 数据填充与单元格操作

5.2.1 向单元格填充数据的多种方法

在POI中，向单元格填充数据是通过 Cell 对象的 setCellValue 方法实现的。这个方法支持多种数据类型，如 double , float , int , boolean , Date , String 等。根据填充数据的不同类型，POI会自动决定单元格的格式。

// 向单元格填充不同数据类型的示例
cell.setCellValue(100); // 整数
cell.setCellValue(100.12); // 浮点数
cell.setCellValue(true); // 布尔值
cell.setCellValue(new Date()); // 日期
cell.setCellValue("Hello, Apache POI!"); // 字符串

5.2.* 单元格样式、类型和格式的设置

单元格样式是增强Excel文档可读性的重要方式。Apache POI提供了 CellStyle 类，通过它可以设置字体、边框、背景色、对齐方式等。单元格类型（ CellType ）则用于指定单元格中的数据类型，例如数值型、文本型、日期型等。

// 设置单元格样式示例
CellStyle style = workbook.createCellStyle();
style.setAlignment(HorizontalAlignment.CENTER); // 水平居中
style.setFillForegroundColor(IndexedColors.LAVENDER.getIndex()); // 背景色设置为淡紫色
style.setFillPattern(FillPatternType.SOLID_FOREGROUND); // 背景填充类型

cell.setCellStyle(style); // 应用样式到单元格

在上面的代码中，我们创建了一个新的 CellStyle 对象，并设置了单元格的对齐方式、背景色和填充类型。最后，我们通过 setCellStyle 方法将这个样式应用到了特定的 Cell 对象上。

通过对单元格样式、类型和格式的设置，开发者可以根据需要创建视觉上更加吸引人的Excel文档，使数据展示更加直观和专业。

6. 循环填充数据到Excel

6.1 数据循环填充原理

6.1.1 循环结构的设计思路

循环填充数据是将数据库或程序中的数据批量导入到Excel表格中的常见需求。为了实现这一点，我们需要设计一个高效的循环结构，既能保证数据的准确填充，又能确保操作的性能优化。在设计循环结构时，应遵循以下原则：

• 避免在循环内进行大量的计算或复杂的操作。
• 尽可能减少循环内部的分支和条件判断。
• 使用适当的数据结构来缓存中间结果，减少对数据库或文件系统的I/O操作。
• 合理分配内存资源，避免内存溢出或资源耗尽。

接下来，我们将讨论如何实现数据的循环填充以及如何避免常见的性能瓶颈。

6.1.2 避免性能瓶颈的策略

在循环填充数据到Excel的过程中，性能瓶颈常常出现在以下几个方面：

• 频繁的文件I/O操作：如果每次循环都写入文件，这将极大降低性能。
• 内存使用不当：当处理大量数据时，不合理的内存使用可能导致内存溢出。
• 循环体中的复杂计算：在循环内部进行耗时的计算会使整体性能下降。

针对这些潜在的性能瓶颈，我们可以采取以下优化策略：

• 使用缓冲机制：将数据先写入内存中的缓冲区，然后一次性写入文件，从而减少I/O次数。
• 优化内存使用：合理分配内存资源，及时释放不再使用的数据，避免内存泄漏。
• 循环简化：将复杂的计算逻辑移至循环外部，循环体只负责数据处理和填充。

6.2 动态数据处理技巧

6.2.1 条件判断和循环控制的应用

在填充Excel时，根据条件进行数据的动态处理是常见需求。例如，根据某列的值决定是否进行特定的计算或格式化。在编写循环时，可以利用条件判断来处理这些逻辑。

// 示例代码：条件判断在循环中的应用
for (int i = 0; i < data.length; i++) {
    Row row = sheet.createRow(i);
    Cell cell = row.createCell(0);
    if (data[i].getCondition()) {
        // 满足条件，填充特定数据
        cell.setCellValue(data[i].getValue());
    } else {
        // 不满足条件，填充默认值
        cell.setCellValue("DEFAULT");
    }
}

在上述代码中，我们使用了简单的 if-else 语句来判断条件，并根据条件填充数据。这里的 data 可以是一个对象数组，每个对象包含数据以及是否满足特定条件的信息。

6.2.2 数据类型转换和异常处理

在处理动态数据时，可能需要将字符串转换为数值，或者根据数据的性质调整单元格的类型。同时，对于可能出现的异常情况，需要进行适当的异常处理，确保程序的健壮性。

try {
    for (int i = 0; i < data.length; i++) {
        Row row = sheet.createRow(i);
        Cell cell = row.createCell(0);
        // 尝试将字符串转换为double类型
        double value = Double.parseDouble(data[i].getValue());
        cell.setCellValue(value);
        // 根据数据值设置单元格样式
        if (value > 100) {
            cell.setCellStyle(highValueStyle);
        } else {
            cell.setCellStyle(normalValueStyle);
        }
    }
} catch (NumberFormatException e) {
    // 处理数字格式错误的情况
    System.out.println("数字格式转换错误：" + e.getMessage());
}

在上述代码中，我们首先尝试将数据中的字符串转换为 double 类型的数值，然后根据数值大小设置不同的单元格样式。如果转换过程中遇到格式错误，将捕获 NumberFormatException 并打印错误信息，避免程序崩溃。

在实际应用中，循环填充数据到Excel的操作可能涉及更多的数据类型和条件判断逻辑。合理的应用循环控制和异常处理机制，将有助于编写出既高效又健壮的代码。

7. 样式、字体、颜色和边框调整

在本章节中，我们将深入探讨如何通过Apache POI库在Java程序中对Excel文档进行高级定制，包括单元格样式的应用、字体和颜色的个性化设置以及边框的美化。这些操作可以让你的Excel文件不仅仅包含数据，还具有良好的视觉效果和用户体验。

7.1 样式对象的使用

样式是Excel中用于定义单元格格式的一组设置。Apache POI提供了丰富的方法来创建和应用样式。

7.1.1 创建和应用单元格样式

首先，我们需要创建一个 CellStyle 对象，并设置所需的格式，例如字体、颜色、边框和对齐方式。一旦样式对象被创建，它就可以被应用到任何单元格上。

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

public class POIStyleExample {
    public static void main(String[] args) throws Exception {
        Workbook workbook = new XSSFWorkbook();
        CreationHelper createHelper = workbook.getCreationHelper();
        // 创建样式
        CellStyle style = workbook.createCellStyle();
        style.setDataFormat(createHelper.createDataFormat().getFormat("m/d/yy"));

        // 应用样式到单元格
        Sheet sheet = workbook.createSheet("Example Sheet");
        Row row = sheet.createRow(0);
        Cell cell = row.createCell(0);
        cell.setCellValue(new Date());
        cell.setCellStyle(style);
        // 写出Excel文件
        try (FileOutputStream fileOut = new FileOutputStream("workbook.xlsx")) {
            workbook.write(fileOut);
        }
    }
}

在上面的代码中，我们创建了一个具有特定日期格式的样式，并将其应用到了第一个单元格中。这个过程包括了样式对象的创建、格式设置、样式应用以及最终的文件写入。

7.1.2 样式的继承和修改

创建的样式对象可以被继承，也可以被修改以适应不同的需求。当你需要为Excel中的多个单元格设置相同的样式时，继承已有的样式会是一个高效的选择。

// 继承样式
CellStyle newStyle = workbook.createCellStyle();
newStyle.cloneStyleFrom(style);
newStyle.setAlignment(HorizontalAlignment.CENTER);

在本例中， newStyle 从已有的 style 继承，并对齐方式被设置为居中。

7.2 字体、颜色和边框的个性化设置

除了单元格样式之外，我们还可以对单元格的字体、颜色和边框进行个性化设置。

7.2.1 字体样式和颜色的选择

字体样式和颜色是提升文档可读性的重要因素。Apache POI允许我们通过 Font 对象来详细定义它们。

// 创建字体并设置字体样式和颜色
Font font = workbook.createFont();
font.setBold(true); // 字体加粗
font.setColor(IndexedColors.BLUE.getIndex()); // 字体颜色改为蓝色

// 应用字体到单元格样式
CellStyle cellStyle = workbook.createCellStyle();
cellStyle.setFont(font);

这段代码中，我们创建了一个字体对象，并将其应用到了单元格样式中。通过这种方式，我们可以对Excel文档中的字体进行高度定制。

7.2.2 边框样式的定制与美化

边框是给Excel单元格添加视觉边界的另一种方式。Apache POI中的 CellStyle 对象可以用来定义边框的样式。

// 创建边框样式
CellStyle borderedStyle = workbook.createCellStyle();
borderedStyle.setBorderBottom(BorderStyle.THIN); // 底边框样式为细线
borderedStyle.setBottomBorderColor(IndexedColors.GREEN.getIndex()); // 底边框颜色为绿色

// 应用边框样式到单元格
Cell borderedCell = row.createCell(1);
borderedCell.setCellValue("带边框的单元格");
borderedCell.setCellStyle(borderedStyle);

在这个示例中，我们为单元格定义了一个带有细边框和绿色底边框的样式。你可以根据需要添加其他边框，并自定义边框的颜色和样式。

通过本章的内容，我们学习了如何使用Apache POI为Excel文档添加样式、字体、颜色和边框。这将使得你的输出文件在视觉上更加吸引人，并且在实际应用中更加实用。

本文还有配套的精品资源，点击获取

简介：Apache POI库是Java中用于操作Microsoft Office文件的强大工具，特别是Excel。本文介绍了如何使用Apache POI库在Java项目中导出Excel文件。从引入依赖到创建工作簿、工作表、行和单元格，以及如何填充数据和导出文件，本文将提供完整的代码示例和详细解释。此外，还涉及如何调整样式和添加高级功能，以及如何根据实际需求对实例进行扩展。

本文还有配套的精品资源，点击获取