java excel 导出动态表头

原创

mob64ca12e3dd9e 2024-08-16 09:53:29 ©著作权

文章标签 java Apache Java 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者mob64ca12e3dd9e的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java Excel 导出动态表头指南

在当前的数据处理和报告生成中，Excel 文件作为一种常用的数据交换格式，具有广泛的应用。Java 程序员经常需要将数据导出到 Excel 文件中，尤其是当数据表的列数和列名不是固定时，我们需要实现动态表头的功能。本文将针对 Java 中 Excel 的动态表头导出进行详细讲解，并提供相关代码示例。

1. 动态表头的概念

动态表头指的是在生成 Excel 文件时，表头的列名和列数不是固定的，而是根据实际数据动态生成的。这样的功能在生成报表时尤为重要，因为用户可能需要查看不同行业的数据，或者根据权限查看不同维度的信息。

2. 使用 Apache POI 操作 Excel

Apache POI 是一个流行的开源 Java 库，用于读写 Microsoft Office 格式的文档，包括 Excel。在本节中，我们将使用 Apache POI 来导出带有动态表头的 Excel。

2.1 添加 Apache POI 依赖

在 Maven 项目中，我们可以通过添加以下依赖来引入 Apache POI：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>
<dependency>
    <groupId>org.apache.xmlbeans</groupId>
    <artifactId>xmlbeans</artifactId>
    <version>5.0.0</version>
</dependency>

2.2 编写导出函数

我们将编写一个函数，用于导出包含动态表头的 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;
import java.util.Map;

public class ExcelExporter {

    public void exportExcel(String fileName, List<String> headers, List<Map<String, Object>> data) {
        Workbook workbook = new XSSFWorkbook(); // 创建工作簿
        Sheet sheet = workbook.createSheet("Sheet1"); // 创建工作表
        
        // 创建表头
        Row headerRow = sheet.createRow(0);
        for (int i = 0; i < headers.size(); i++) {
            Cell cell = headerRow.createCell(i);
            cell.setCellValue(headers.get(i));
        }
        
        // 填充数据
        for (int i = 0; i < data.size(); i++) {
            Row dataRow = sheet.createRow(i + 1);
            Map<String, Object> rowData = data.get(i);
            
            for (int j = 0; j < headers.size(); j++) {
                Cell cell = dataRow.createCell(j);
                Object value = rowData.get(headers.get(j));
                if (value != null) {
                    cell.setCellValue(value.toString());
                }
            }
        }

        // 写入文件
        try (FileOutputStream outputStream = new FileOutputStream(fileName)) {
            workbook.write(outputStream);
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                workbook.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

2.3 使用示例

以下是如何调用上述函数的示例代码：

import java.util.*;

public class Main {
    public static void main(String[] args) {
        ExcelExporter exporter = new ExcelExporter();
        
        // 动态表头
        List<String> headers = Arrays.asList("姓名", "年龄", "性别", "城市");
        
        // 数据
        List<Map<String, Object>> data = new ArrayList<>();
        
        Map<String, Object> row1 = new HashMap<>();
        row1.put("姓名", "张三");
        row1.put("年龄", 28);
        row1.put("性别", "男");
        row1.put("城市", "北京");
        
        Map<String, Object> row2 = new HashMap<>();
        row2.put("姓名", "李四");
        row2.put("年龄", 24);
        row2.put("性别", "女");
        row2.put("城市", "上海");
        
        data.add(row1);
        data.add(row2);
        
        // 导出 Excel
        exporter.exportExcel("动态表头示例.xlsx", headers, data);
    }
}

3. 流程图

为了清楚地展示导出动态表头 Excel 的整个流程，下面是相关的流程图：

flowchart TD
    A[开始] --> B[定义表头]
    B --> C[准备数据]
    C --> D[创建Workbook]
    D --> E[创建Sheet]
    E --> F[创建表头行]
    F --> G[遍历数据填充行]
    G --> H[写入文件]
    H --> I[关闭工作簿]
    I --> J[结束]