当前位置：首页 > news >正文

EasyExcel集成使用总结与完整示例

news 来源：原创 2025/5/16 6:49:51

EasyExcel集成使用总结与完整示例

一、EasyExcel简介

EasyExcel是阿里巴巴开源的Java库，专注于简化Excel文件的读写操作。它基于Apache POI进行了优化，采用流式处理，具有低内存占用和高性能的特点，非常适合处理大规模数据的导入导出。

主要特点

简单易用：提供简洁的API和注解，快速上手。
高性能：内存占用低，支持读写大型Excel文件。
功能丰富：支持数据导入导出、样式设置、数据转换、模板填充等。
扩展性强：支持自定义监听器、转换器，满足复杂业务需求。

二、集成步骤

1. 引入依赖

在pom.xml中添加EasyExcel依赖：

<dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>3.1.1</version> <!-- 使用最新稳定版本 -->
</dependency>

2. 定义实体类

创建与Excel列对应的实体类，使用@ExcelProperty注解指定列名。

import com.alibaba.excel.annotation.ExcelProperty;public class User {@ExcelProperty("姓名")private String name;@ExcelProperty("年龄")private Integer age;@ExcelProperty("邮箱")private String email;// 省略构造方法、Getter和Setter
}

三、数据导出实现

1. 准备数据

创建要导出的数据列表。

import java.util.ArrayList;
import java.util.List;public class ExportData {public static List<User> prepareData() {List<User> users = new ArrayList<>();users.add(new User("张三", 25, "zhangsan@example.com"));users.add(new User("李四", 30, "lisi@example.com"));// 添加更多数据...return users;}
}

2. 导出Excel

使用EasyExcel.write()方法将数据写入Excel文件。

import com.alibaba.excel.EasyExcel;public class ExcelExportExample {public static void main(String[] args) {String fileName = "users.xlsx";List<User> data = ExportData.prepareData();EasyExcel.write(fileName, User.class).sheet("用户信息").doWrite(data);System.out.println("数据导出成功！");}
}

四、数据导入实现

1. 创建监听器

继承AnalysisEventListener，处理读取到的数据。

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import com.alibaba.fastjson.JSON;import java.util.ArrayList;
import java.util.List;public class UserImportListener extends AnalysisEventListener<User> {private List<User> users = new ArrayList<>();@Overridepublic void invoke(User user, AnalysisContext context) {users.add(user);System.out.println("读取到数据：" + JSON.toJSONString(user));}@Overridepublic void doAfterAllAnalysed(AnalysisContext context) {System.out.println("所有数据导入完成，共 " + users.size() + " 条记录。");// 在这里可以对读取到的数据进行处理，如保存到数据库}
}

2. 导入Excel

使用EasyExcel.read()方法读取Excel文件。

import com.alibaba.excel.EasyExcel;public class ExcelImportExample {public static void main(String[] args) {String fileName = "users.xlsx";EasyExcel.read(fileName, User.class, new UserImportListener()).sheet().doRead();System.out.println("数据导入完成！");}
}

五、高级功能

1. 自定义样式

通过WriteCellStyle和HorizontalCellStyleStrategy设置单元格样式。

2. 数据转换

实现Converter接口，自定义数据类型转换。

3. 多Sheet操作

导出多个工作表：

EasyExcel.write(fileName).sheet("用户信息", User.class).doWrite(userData).sheet("订单信息", Order.class).doWrite(orderData);

导入多个工作表：

EasyExcel.read(fileName).sheet("用户信息", User.class, userListener).sheet("订单信息", Order.class, orderListener).doRead();

4. 模板填充

使用模板文件填充数据：

Map<String, Object> dataMap = new HashMap<>();
dataMap.put("username", "张三");
dataMap.put("date", new Date());EasyExcel.fill(fileName, dataMap, Sheet.class).write().doWrite();