Java导出Excel合并单元格

1. 引言

在软件开发过程中，经常遇到需要将数据导出到Excel文件的需求。而有时候，我们需要对导出的Excel文件进行样式的设置，比如合并单元格。本文将详细介绍如何使用Java语言导出Excel文件，并实现单元格的合并功能。

2. Excel导出工具

Java中有许多开源的Excel导出工具，比如Apache POI、JExcel等。本文我们选择使用Apache POI库来实现Excel导出。

2.1 简介

Apache POI是Apache软件基金会的一部分，是在业界广泛使用的处理基于Microsoft Office格式的文档的Java库。它可以用于读写Word、Excel和PowerPoint文档。在本文中，我们将使用Apache POI库的XSSF组件来处理Excel文件。

2.2 添加依赖

在使用Apache POI之前，我们需要在项目的pom.xml（Maven项目）或build.gradle（Gradle项目）文件中添加以下依赖：

<!-- Maven依赖 -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>4.1.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>

<!-- Gradle依赖 -->
implementation 'org.apache.poi:poi:4.1.2'
implementation 'org.apache.poi:poi-ooxml:4.1.2'

3. 导出Excel文件

接下来，我们将演示如何使用Apache POI库导出Excel文件，并实现合并单元格的功能。

3.1 创建工作簿和工作表

首先，我们需要创建一个工作簿（Workbook）对象，用于表示整个Excel文件，然后再在工作簿中创建一个工作表（Sheet）对象，用于表示一个Excel工作表。

// 创建工作簿
Workbook workbook = new XSSFWorkbook();

// 创建工作表
Sheet sheet = workbook.createSheet("Sheet1");

3.2 设置表头

接下来，我们可以设置Excel表格的表头。在工作表中，每一行的第一个单元格通常用来表示表头，因此我们可以在第一行的各个单元格中填写表头信息。

// 创建表头行
Row headerRow = sheet.createRow(0);

// 创建表头单元格
Cell headerCell1 = headerRow.createCell(0);
headerCell1.setCellValue("姓名");

Cell headerCell2 = headerRow.createCell(1);
headerCell2.setCellValue("年龄");

3.3 填充数据

接下来，我们可以填充Excel表格的数据。使用循环来遍历数据集合，然后将数据逐行写入Excel表格中。

List<User> userList = getUserList(); // 获取数据集合

// 遍历数据集合
for (int i = 0; i < userList.size(); i++) {
    User user = userList.get(i);

    // 创建数据行
    Row dataRow = sheet.createRow(i + 1);

    // 创建数据单元格
    Cell dataCell1 = dataRow.createCell(0);
    dataCell1.setCellValue(user.getName());

    Cell dataCell2 = dataRow.createCell(1);
    dataCell2.setCellValue(user.getAge());
}

3.4 合并单元格

有时候，我们需要在Excel中合并某些单元格，以展示特定的数据结构。可以使用Sheet对象的addMergedRegion(CellRangeAddress region)方法来实现合并单元格的功能。

以下示例演示了如何将第一行第一列到第三列合并为一个单元格：

CellRangeAddress mergedRegion = new CellRangeAddress(0, 0, 0, 2);
sheet.addMergedRegion(mergedRegion);

3.5 导出Excel文件

最后，我们需要将工作簿中的数据导出到Excel文件中。

// 导出到文件
FileOutputStream fileOutputStream = new FileOutputStream("data.xlsx");
workbook.write(fileOutputStream);
fileOutputStream.close();

4. 示例代码

下面是一个完整的示例代码，用于演示如何使用Java导出Excel文件并合并单元格的功能：

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

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;

public class ExcelExporter {

    public void exportData(List<User> userList) throws IOException {
        // 创建工作簿
        Workbook workbook = new XSSFWorkbook();

        // 创建工作表
        Sheet sheet = workbook.createSheet("Sheet1");

        // 创建表头行
        Row headerRow = sheet.createRow(0);

        // 创建表头单元格
        Cell headerCell1 = headerRow.createCell(0);
        headerCell1.setCellValue("姓名");

        Cell headerCell2 = headerRow.createCell(1);
        headerCell2.setCellValue("年龄");

        // 遍历数据集合
        for (int i = 0; i < userList.size(); i++) {
            User user = userList.get(i);

            // 创建数据行
            Row dataRow = sheet.createRow(i + 1);

            // 创建数据单元格
            Cell dataCell1 = dataRow.createCell(0);
            dataCell1.setCellValue(user.getName());

            Cell dataCell2 = dataRow.createCell(1);
            dataCell2.setCellValue(user.getAge());
        }

        // 合并单元格
        CellRangeAddress mergedRegion = new CellRangeAddress(0, 0, 0, 2); // 合并第一行的第一列到第三列
        sheet.addMergedRegion(mergedRegion);

        // 导出到文件
        FileOutputStream fileOutputStream = new FileOutputStream("data.xlsx");
        workbook.write(fileOutputStream);
        fileOutputStream.close();
    }

    public static void main(String[] args) {
        ExcelExporter exporter = new ExcelExporter();
        List<User> userList = exporter.getUserList(); // 获取数据集合

        try {
            exporter.exportData(userList);
            System.out.println("Excel导出成功！");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private List<User> getUserList() {
        // 获取数据集合的逻辑
        return null;
    }

    private class User {
        private String name;
        private int age;

        // 构造方法、getter和setter省略
    }
}