使用 EasyExcel 生成序号的完整指南

在这篇文章中,我们将学习如何使用 Java 的 EasyExcel 库生成带有序号的 Excel 文件。无论你是初学者还是正在提升技能的开发者,本文将一步步指导你完成这一过程。

整体流程

在开始之前,我们先简单列出整个实现过程的步骤:

步骤 描述
1 准备项目环境
2 引入 EasyExcel 依赖
3 编写 Excel 数据模型
4 实现生成 Excel 文件的代码
5 运行代码,生成 Excel 文件

详细步骤

1. 准备项目环境

首先,你需要确保你的开发环境已经安装好 Java 和 Maven。我们将通过 Maven 来管理我们的项目。

2. 引入 EasyExcel 依赖

在你的 pom.xml 文件中添加以下依赖:

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.0.5</version>
</dependency>

3. 编写 Excel 数据模型

接下来,我们需要定义一个数据模型来表示 Excel 中的每一行数据。这是一个简单的 Java 类:

import com.alibaba.excel.annotation.ExcelProperty;

public class UserData {
    
    @ExcelProperty("序号")
    private Integer index;
    
    @ExcelProperty("姓名")
    private String name;

    // 构造函数
    public UserData(Integer index, String name) {
        this.index = index;
        this.name = name;
    }

    // Getter 和 Setter
    public Integer getIndex() {
        return index;
    }

    public void setIndex(Integer index) {
        this.index = index;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

4. 实现生成 Excel 文件的代码

现在我们需要编写一个主程序来生成 Excel 文件并填充数据。以下是示例代码:

import com.alibaba.excel.EasyExcel;
import java.util.ArrayList;
import java.util.List;

public class ExcelGenerator {
    
    public static void main(String[] args) {
        // 创建一个 List 存放数据
        List<UserData> dataList = new ArrayList<>();

        // 填充数据(添加序号和姓名)
        for (int i = 1; i <= 10; i++) {
            dataList.add(new UserData(i, "姓名" + i)); // 添加数据
        }

        // 生成 Excel 文件
        String fileName = "用户数据.xlsx"; // 文件名
        // EasyExcel 写入文件
        EasyExcel.write(fileName, UserData.class).sheet("用户信息").doWrite(dataList);
        
        // 提示操作完成
        System.out.println("Excel 文件生成成功: " + fileName);
    }
}

5. 运行代码,生成 Excel 文件

最后一步是运行你的程序。当程序执行完毕后,你应该能在项目根目录下看到一个名为 用户数据.xlsx 的 Excel 文件,它的第一列是序号,后面是一系列姓名。

旅行图与状态图

为了更好地理解整个过程,我们可以用 Mermaid 画出旅行图和状态图。

旅行图

journey
    title EasyExcel 项目旅行
    section 环境准备
      安装 Java & Maven: 5: 不可预测
    section 项目创建
      创建 Maven 项目: 5: 不可预测
    section 依赖引入
      在 pom.xml 中引入 EasyExcel: 5: 成功
    section 数据模型创建
      编写 UserData 类: 5: 成功
    section 代码实现
      编写 ExcelGenerator 类: 5: 成功
    section 运行代码
      生成 Excel 文件: 5: 成功

状态图

stateDiagram
    [*] --> 环境准备
    环境准备 --> 项目创建
    项目创建 --> 依赖引入
    依赖引入 --> 数据模型创建
    数据模型创建 --> 代码实现
    代码实现 --> 运行代码
    运行代码 --> [*]

总结

在这篇文章中,我们详细介绍了如何使用 EasyExcel 来生成带有序号的 Excel 文件。我们一步步从准备项目环境到引入依赖,再到编写数据模型和实现生成代码,最终成功生成了 Excel 文件。

通过这次学习,应该能够帮助你在之后的项目中,更加自如地应用 EasyExcel。如果你还有其他问题,欢迎随时咨询或查阅官方文档来获得更多帮助。希望你在 Java 开发的旅程中一切顺利!