天空闲话 发表于 2024-12-5 15:32:18

利用 EasyExcel 实现高效的 Excel 读写操纵

在一样寻常开发中,Excel 文件的读写操纵是一个常见的需求。EasyExcel 是阿里巴巴开源的一个高性能、易用的 Excel 读写库,可以大幅提高处理 Excel 文件的服从。它通过变乱驱动模子优化了大数据量 Excel 的读写性能,非常适合处理大文件或高并发场景。
本篇博客将从 EasyExcel 的根本概念、优势、安装、读写操纵以及高级用法睁开,并提供清楚的代码示例。
一、EasyExcel 的焦点特点


[*]高性能:基于流式解析,低内存消耗,适合大数据量操纵。
[*]简单易用:提供了强大的注解支持,配置简单。
[*]兼容性强:支持 Excel 2007(.xlsx)及更高版本。
[*]变乱驱动模子:按需读取,制止一次性加载所有数据到内存。
[*]支持复杂表头:可以轻松处理多级表头、归并单位格等复杂场景。
二、安装 EasyExcel

起首,在你的 Maven 项目中引入 EasyExcel 的依靠:
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.3</version> <!-- 请使用最新版本 -->
</dependency>
三、根本用法

1. 写入 Excel

以下是一个简单的 Excel 写入示例:
import com.alibaba.excel.EasyExcel;

import java.util.ArrayList;
import java.util.List;

public class EasyExcelWriteExample {

    public static void main(String[] args) {
      String fileName = "example.xlsx";

      // 准备数据
      List<UserData> data = generateData();

      // 写入文件
      EasyExcel.write(fileName, UserData.class)
                .sheet("用户信息")
                .doWrite(data);
    }

    private static List<UserData> generateData() {
      List<UserData> list = new ArrayList<>();
      for (int i = 1; i <= 10; i++) {
            list.add(new UserData(i, "用户" + i, "user" + i + "@example.com"));
      }
      return list;
    }

    // 数据类,使用注解指定表头
    public static class UserData {
      @com.alibaba.excel.annotation.ExcelProperty("用户ID")
      private Integer id;

      @com.alibaba.excel.annotation.ExcelProperty("用户名")
      private String name;

      @com.alibaba.excel.annotation.ExcelProperty("邮箱")
      private String email;

      // 构造函数、Getter 和 Setter
      public UserData(Integer id, String name, String email) {
            this.id = id;
            this.name = name;
            this.email = email;
      }
    }
}
说明:



[*]@ExcelProperty 注解用于指定 Excel 列的标题。
[*]EasyExcel.write() 是写操纵的入口,指定文件路径和数据模子。
运行以上代码后,会天生一个名为 example.xlsx 的文件,包含一张标题为“用户信息”的表单。
2. 读取 Excel

以下示例展示怎样读取 Excel 文件内容:
import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.read.listener.ReadListener;

import java.util.List;

public class EasyExcelReadExample {

    public static void main(String[] args) {
      String fileName = "example.xlsx";

      // 读取文件
      EasyExcel.read(fileName, UserData.class, new UserDataListener())
                .sheet()
                .doRead();
    }

    // 自定义监听器,处理每一行数据
    public static class UserDataListener implements ReadListener<UserData> {
      @Override
      public void invoke(UserData data, AnalysisContext context) {
            System.out.println("读取到数据:" + data);
      }

      @Override
      public void doAfterAllAnalysed(AnalysisContext context) {
            System.out.println("所有数据读取完毕");
      }
    }
}
四、高级功能

1. 多级表头

EasyExcel 支持复杂的多级表头:
java
复制代码
public class MultiLevelData {
    @com.alibaba.excel.annotation.ExcelProperty({"用户信息", "用户ID"})
    private Integer id;

    @com.alibaba.excel.annotation.ExcelProperty({"用户信息", "用户名"})
    private String name;

    @com.alibaba.excel.annotation.ExcelProperty({"联系方式", "邮箱"})
    private String email;
}
在写入时,会天生两级表头,分为“用户信息”和“接洽方式”。
2. 大数据量读取

针对大文件,EasyExcel 提供了分批读取的能力。
EasyExcel.read(fileName, UserData.class, new ReadListener<UserData>() {
    @Override
    public void invoke(UserData data, AnalysisContext context) {
      // 处理每一条数据
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
      // 处理完成后执行
    }
}).sheet().doRead();
通过监听器,每次读取一小部分数据处理,制止内存溢出。
五、利用场景


[*]导出数据报表:支持复杂的表格格式和多级表头,可以天生格式化的报表文件。
[*]批量导入:支持从 Excel 导入数据到数据库,处理高并发上传。
[*]日记分析:处理大文件日记的导入和分析。
六、常见问题


[*]内存溢出:对于大数据量,建议利用分批读取,制止一次性加载过多数据。
[*]日期格式问题:利用 @ExcelProperty 的 converter 属性自界说日期格式。
[*]归并单位格:必要自界说拦截器,控制单位格的样式和归并举动。
七、总结

EasyExcel 是一个功能强大且高效的 Excel 操纵工具。它通过简化代码结构、优化性能和丰富的功能支持,成为 Java 开发者处理 Excel 文件的首选库。通过本篇博客的讲解,相信你已经把握了 EasyExcel 的根本用法和高级功能,可以或许在实际项目中高效处理 Excel 文件。
如果你喜欢这篇文章,请点赞、收藏或分享给更多必要的小伙伴吧!

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 利用 EasyExcel 实现高效的 Excel 读写操纵