EasyExcel01 - 核心api
本文整理自掘金大佬 - 竹子爱熊猫
文章目录
- [EasyExcel01 - 核心api](#EasyExcel01 - 核心api)
一：初相识EasyExcel
EasyExcel是一个高效、低内存占用的Excel处理框架，提供了简洁易用的API接口，使得我们能更加高效、灵活的处理Excel文件
当然，EasyExcel并非一个完全从零构建的开源项目，而是阿里巴巴在POI的基础上做了进一步封装
下面内容来自easyExcel官网：
POI也好，JXL也罢，它们都存在一个严重的问题就是非常的耗内存，尽管POI提供了一套SAX模型能在一定程度上解决OOM问题，但它仍然存在一些缺陷，对内存消耗依旧较大。因此，
EasyExcel重写了POI对07版Excel文件的解析，一个3MB的文件用原生的POI-SAX去解析，需要消耗100MB左右的内存，改用EasyExcel可以降低到几MB，并且再大的文件也不会出现内存溢出；03版依赖POI-SAX模式，也在上层做了模型转换的封装，让使用者更加简单方便。
一个75MB的Excel文件，每行数据二十五列，总计46W条数据，能够在23秒解析、读取完成，并且仅消耗了16MB内存，这个结果无疑是惊人的！
同时，如果内存足够充裕，还可以开启急速模式换取更快的处理性能。
当然，这个数据来源于实验环境，在硬件配置较差、或读取数据后还需要清洗、落库等情况下，性能上会有所差异。但是不管怎么说，在资源占用、性能方面都完胜POI原生的处理方式
对EasyExcel有了基本认知后，下面来一起快速上手实操一下，首先咱们需要导入下相关依赖
xml
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>4.0.2</version>
</dependency>这里我们可以使用最新的4.0.2版本，也可以选择之前的稳定版本，3.1.x以后的版本API大致相同，新的版本也会向前兼容（3.1.x之前的版本，部分API可能在高版本被废弃）
关于POI、JDK版本适配问题
1：写入excel入门
java
package com.example.bootrocketmq.study.wheel.easyexcel;
import lombok.*;
import java.util.Date;
/**
* @author cui haida
* 2024/12/21
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Person {
private Long id; // 主键id
private String name; // 姓名
private String sex; // 性别
private String hobby; // 爱好
private Date birthday; // 生日
}假设有一个Person集合，目前想把其中的数据，生成并写入到Excel文件该怎么做？十分简单
java
package com.example.bootrocketmq.study.wheel.easyexcel;
import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.write.builder.ExcelWriterBuilder;
import com.alibaba.excel.write.builder.ExcelWriterSheetBuilder;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
/**
* @author cui haida
* 2024/12/21
*/
public class SimpleWriteDemo {
private static void writeDemo() {
List<Person> personList = new ArrayList<>();
Person person = new Person(1L, "cuihaida", "男", "打游戏", new Date());
Person person2 = new Person(2L, "cuihaida2", "女", "打游戏2", new Date());
personList.add(person);
personList.add(person2);
// 可以写绝对路径
String fileName = "person数据-" + System.currentTimeMillis() + ".xlsx";
// 创建ExcelWriterBuilder, 默认创建内存模式，通过write方式指定文件名和实体类。
ExcelWriterBuilder write = EasyExcel.write(fileName, Person.class);
// 创建ExcelWriterSheetBuilder，默认创建第一个sheet，通过sheet方式指定sheet名
ExcelWriterSheetBuilder sheet = write.sheet("person列表");
// 通过dowrite(list)的方式写入到excel中
sheet.doWrite(personList);
write.autoCloseStream(true);
System.out.println("写入成功");
}
public static void main(String[] args) {
writeDemo();
}
}
2：读取Excel入门
看完写入操作后，下面来看看如何读取Excel文件里的数据，咱们就以前面生成的文件作为解析目标，首先需要定义一个监听器
java
package com.example.bootrocketmq.study.wheel.easyexcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import java.util.ArrayList;
import java.util.List;
/**
* @author cui haida
* 2024/12/22
*/
public class PersonListener extends AnalysisEventListener<Person> {
// 一会读出来的数据都放在这里
private final List<Person> data = new ArrayList<>();
/**
* 读excel一行一行的读, 每次都会调用这个invoke方法
* @param person person实体数据
* @param analysisContext 上下文对象
*/
@Override
public void invoke(Person person, AnalysisContext analysisContext) {
System.out.println("每读取到一行，都会触发这个函数，读取到的内容是: " + person.toString());
// 加入到结果中
data.add(person);
}
/**
* 读取完所有数据后调用这个方法
* @param analysisContext 上下文对象
*/
@Override
public void doAfterAllAnalysed(AnalysisContext analysisContext) {
System.out.println("读取完毕，一共读取了" + analysisContext.readSheetHolder().getTotal() + "行");
}
/**
* 获取读取的数据
* @return 数据
*/
public List<Person> getData() {
return data;
}
}这个监听器很简单，无非就是将每条读取到的数据添加到data集合里，然后对外提供了一个获取数据的方法
其实这个监听器不定义也可以，因为EasyExcel有默认的监听器
java
package com.example.bootrocketmq.study.wheel.easyexcel;
import com.alibaba.excel.EasyExcel;
import java.util.List;
/**
* @author cui haida
* 2024/12/22
*/
public class SimpleReadDemo {
public static void main(String[] args) {
String fileName = "person数据-1734779595717.xlsx";
PersonListener listener = new PersonListener();
// 读取excel的内容，要转化成的对象(Person.class), 监听器(PersonListener)
EasyExcel.read(fileName, Person.class, listener).sheet().doRead();
List<Person> data = listener.getData();
System.out.println(data);
}
}
二：数据模型注解
从上面可以发现，不管是读取文件还是写入文件，都需要传递一个具体的class
这个类叫做数据模型类，主要是用来映射Java对象和excel列的匹配关系的。【java对象 - excel列】
为了更好的满足各种报表需求，easyExcel提供了各种注解进行辅助，主要有两大类
1：读写通用注解
通用注解是指在类、字段上添加后，对于读写场景都会生效的注解，而这些通用注解也是最常用的
1.1：@ExcelProperty注解
@ExcelProperty注解在读取用于映射excel表头，在写入时用于控制生成的excel表头
作用范围：数据实体类的字段上
注解释义：用于映射excel列和实体字段的匹配关系
可选参数：（注意优先级 -> index > order > value)
| 参数 | 说明 |
|---|---|
| value | 以列名形式匹配excel列，多行头会匹配最后一行 |
| order | 以权重形式匹配excel列，值越小越靠前，优先级高于value |
| index | 以索引形式匹配excel列，优先级高于order & value |
| converter | 数据格式转换器，解析时会根据指定的转换器处理对应数据 |
该注解是EasyExcel中最重要的注解，它提供了列名、权重、索引三种列匹配模式
不过在解析excel文件时，官方只建议同时使用一种，因为就算指定了多种，它们也会有优先级关系，大可不必多此一举。
在写入的场景中，确实常常将index，value一起使用 -> value用于控制列名称，index用于控制列的顺序。
java
@ExcelProperty(value="姓名", index=1)
private String name;这代表name字段在excel文件的列名为"姓名"，位于表格的第二列（B列）
1.2：@ExcelIgnore注解
作用范围：数据实体类的字段上
注解释义：当前字段不参与excel的匹配，即处理时候忽略这个字段。
java
@ExcelIgnore
private String name; // name字段不参与excel列的映射匹配1.3：@ExcelIgnoreUnannotated注解
作用范围：数据模型类上
注解释义：匹配列时忽略所有未使用@ExcelProperty注解的字段
如果类中许多字段都不想参与excel读写，而你又嫌挨个加@ExcelIgnore注解麻烦，这时就可以直接在类上加一个@ExcelIgnoreUnannotated注解，以此来忽略所有未添加@ExcelProperty注解的字段
1.4：@DateTimeFormat注解
作用范围：数据实体类的字段上
注解释义：用String接收日期数据时，会根据指定格式转换日期
可选参数：
| 参数 | 说明 |
|---|---|
| value | 日期数据转换为字符串的目标格式 |
| use1904windowing | excel日期数据默认从1900年开始，但有些会从1904开始 |
在解析excel文件时，如果使用String字段接收日期数据，就会根据指定的格式转换数据，格式可以参考java.text.SimpleDateFormat的写法，例如yyyy-MM-dd HH:mm:ss。
而在往excel写数据时，如果Java中的字段类型为Date、LocalDate、LocalDateTime等日期类型，则会将日期数据转换为指定的格式写入对应列
1.5：@NumberFormat注解
作用范围：数据实体类的字段上
注解释义：用String接受数据类型时，会根据指定格式转换数值
可选参数：
| 参数 | 说明 |
|---|---|
| value | 数值转成字符串的目标格式 |
| roundingMode | 数值格式化时的舍入模式，如四舍五入、向上取整等 |
这个注解和前一个注解类似，只不过是用于将非整数类型的数值数据转换成给定格式，格式可以参考java.text.DecimalFormat的写法，如#.##。
除了可以指定格式外，还可以指定舍入模式，枚举可参考java.math.RoundingMode类
2：生成注解
2.1：@ColumnWidth注解
作用范围：数据模型类上、字段上
注解释义：设置列的宽度
这个注解如果加在类上，则会对所有字段生效；如果单独加在某个字段上，则只对特定的列有效，单位是px
2.2：@ContentFontStyle注解
作用范围：数据模型类上、字段上
注解释义：用于设置单元格内容字体格式的注解
可选参数：
| 参数 | 说明 |
|---|---|
| fontName | 字体名称，如"黑体、宋体、Arial"等 |
| fontHeightInPoints | 字体高度，以磅为单位 |
| italic | 是否设置斜体（字体倾斜） |
| strikeout | 是否设置删除线 |
| color | 字体的颜色，通过RGB值来设置 |
| typeOffset | 偏移量，用于调整字体的位置 |
| underline | 是否添加下划线 |
| bold | 是否对字体加粗 |
| charset | 设置编码格式，只能对全局生效（字段上设置无效） |
这个注解用于设置主体内容的字体样式（不包含表头），与上个注解同理，加在类上对整个excel文件生效，加在字段上只对单列有效，可以通过该注解来设置字体风格、高度、是否斜体等属性
2.3：其他注解
- @HeadFontStyle注解 -> 用于定制标题字体格式
- @HeadRowHeight注解 -> 用于设置标题行的行高
- @HeadStyle注解 -> 用于设置标题样式
- @OnceAbsoluteMerge注解 -> 用于合并指定的单元格
- @ContentLoopMerge注解 -> 用于合并单元格
三：核心API全解
1：EasyExcel入口类
基于一开始的简单读写案例，会发现所有excel相关的动作都始于EasyExcel这个类，而这个类也被称为入口类，主要用来构建各种excel操作的实例（如读、写）。
java
public class EasyExcel extends EasyExcelFactory {
public EasyExcel() {
}
}可以发现这是一个空的实现，EasyExcel类直接继承了EasyExcelFactory，拥有的所有API底层也由EasyExcelFactory提供，所以，我们直接分析EasyExcelFactory即可：
java
// 基于给定的文件、数据模型类，构建一个Excel写入对象
public static ExcelWriterBuilder write(File file, Class head)
// 基于给定的流、数据模型类，构建一个Excel写入对象
public static ExcelWriterBuilder write(OutputStream outputStream, Class head)
// 基于给定的sheet号、sheet名称，构建一个Sheet写入对象
public static ExcelWriterSheetBuilder writerSheet(Integer sheetNo, String sheetName)
// 基于给定的表格号，构建一个Table写入对象
public static ExcelWriterTableBuilder writerTable(Integer tableNo)
// 基于给定的文件、数据模型类，构建一个Excel读取对象
public static ExcelReaderBuilder read(File file, ReadListener readListener)
// 基于给定的文件、数据模型类，构建一个Excel读取对象
public static ExcelReaderBuilder read(InputStream inputStream, ReadListener readListener)
// 基于给定的sheet号、sheet名称，构建一个Sheet读取对象
public static ExcelReaderSheetBuilder readSheet(Integer sheetNo, String sheetName)对于重复的方法不在说明，上面列出的是EasyExcelFactory类中的核心方法，其作用主要是构建读、写excel文件的对象，以便于后续读取、写入excel数据
简单了解这个入口类后，下面来看看这些构建出的读写对象
2：读对象
EasyExcel中，与读取数据相关的核心类主要有三个：ExcelReaderBuilder、ExcelReaderSheetBuilder、ReadListener
2.1：ExcelReaderBuilder
ExcelReaderBuilder只是为了满足链式调用封装出的Builder类，其内部会构建一个读取工作簿的ReadWorkbook对象，这就相当于你在实体类上加了个@Builder注解
所谓的工作簿，可以简单理解成一个Excel文件，下面看看它的API：
| API | 参数说明 |
|---|---|
| converter | 数据转换器，默认内置了很多，如果读取的数据需要特定转换，则可以按需添加 |
| registerReadListener | 注册监听器，读取数据时会触发已注册的监听器 |
| headRowNumber | 文件中头的行数，默认为1，文件的列头是多行时设置 |
| head | excel数据的表头列表（以字符串列表形式指定），官方建议使用模型类的方式 |
| clazz | 与excel数据映射的模型类，与head二选一，都未指定时会用Map读取所有数据 |
| use1904windowing | 日期格式是否以1904年开始，兼容特殊的excel文件 |
| useScuentificFormat | 数字转文本的时候在较大的数值的是否是否采用科学计数法 |
| autoTrim | 是否开启自动去除前后空格，开启后会对读到的头信息、数据去空格 |
上述这些参数，也是ExcelReaderSheetBuilder对象具备的通用属性
下面是独特参数：
excelType：指定要读取的excel文件类型，支持XLS、XLSX、CSV；inputStream：指定读取数据的文件流，底层会创建临时文件来转换数据；file：要读取数据的目标文件，与inputStream二选一；mandatoryUseInputStream：强制从流中读数据（不会创建临时文件，性能会变差）；charset：设置文件内容编码格式，读取CSV文件时有效，默认UTF-8；autoCloseStream：读取完毕后是否自动关闭读取的流（默认开启）；readCache：设置读取数据的缓存配置（默认5M内使用内存，其余使用EhCache）；readCacheSelector：设置什么时候使用内存、什么时候使用磁盘来存储缓存数据；ignoreEmptyRow：读取数据行时，是否忽略所有字段为空的行，默认开启；password：读取excel文件的密码（文件加密时使用）；xlsxSAXParserFactoryName：指定POI-SAX模式读取使用的实现类；useDefaultListener：是否使用默认监听器来将excel数据行转换为Java对象；extraReadSet：接收额外需要读取内容的set，如评论、超链接、合并单元的内容；readDefaultReturn：对于excel中不点击单元格看不到的内容数据、接收时的格式；
了解这些参数后，我们在读取Excel文件时如何设置呢？先来看看最开始读取文件的代码：
java
EasyExcel.read(fileName, ZhuZi.class, zhuZiListener).sheet().doRead();这行代码中，EasyExcel.read()方法执行后，会返回一个ExcelReaderBuilder对象
执行sheet()方法后会返回一个ExcelReaderSheetBuilder对象
而最后的doRead()方法则是触发真正解析excel、读取数据的步骤
既然如此，那么我们在调用EasyExcel.read()方法后、sheet()方法前，就可以继续调用上面提到的一系列方法设置参数，例如：
java
EasyExcel.read(fileName, ZhuZi.class, zhuZiListener)
.excelType(ExcelTypeEnum.CSV) // 通过excelType()将读取目标的格式切换成了.csv文件
.sheet().doRead();2.2：ExcelReaderSheetBuilder
与ExcelReaderBuilder对象一样，ExcelReaderSheetBuilder内部维护着一个ReadSheet对象，Builder类单纯用于满足链式调用的编程风格。
接触过Excel的小伙伴应该都知道一点，一个Excel文件内部可以维护多个Sheet（工作表单），而ReadSheet就是专门用来读取表单数据的类，前面在聊ExcelReaderBuilder类时提到的公用参数，ReadSheet也同样具备，那么相同的参数作用在不同的对象上，区别是什么？
很简单，如果针对整个工作簿设置的参数，会对所有Sheet生效；单独针对ReadSheet设置的参数，则只针对特定的表单有效。
如果一个文件的不同Sheet数据格式不一样，就可以基于这种特性来实现不同的解析逻辑。那么下面来看看ReadSheet独有的参数：
sheetNo：指定需要读取数据的目标Sheet编码（默认为0，表示读第一个）；sheetName：根据表单名字去匹配要读取数据的目标Sheet。
是的，你没有看错，ReadSheet的独立参数就这两个，如果你在创建表单读取对象时就已经指定了编号、名称，那么这两个参数甚至也用不到。好了，那如何针对不同Sheet设置参数呢？
大家还记得ReadSheet对象是在何时创建的吗？当调用.sheet()方法后创建的，所以为Sheet设置参数很简单
java
EasyExcel.read(fileName, ZhuZi.class, zhuZiListener)
.sheet(1)
.headRowNumber(2) // 表示从第二个Sheet中读取数据，而这个表单里的表头是两行，即：从第三行才正式开始读取数据
.doRead();2.3：ReadListener
读取监听器，EasyExcel框架中的监听器体系结构如下：
Listener：内部为空实现，仅抽象为顶层接口，用于维护体系结构及拓展性；ReadListener：读取监听器的顶层接口，读取excel文件时会被触发；IgnoreExceptionReadListener：读取时发生异常会触发的监听器，可以在这里处理异常确保读取不会终止；AnalysisEventListener：解析事件监听器，每当读取到一行数据，都会触发该类或子类的invoke()方法；PageReadListener：分页读取监听器，当读取的数据量达到指定的数量会被触发，处理完一页后才会读下页数据；ModelBuildEventListener：默认装载的监听器，用于在解析到excel数据行时，将数据转换为指定类对象；SyncReadListener：解析事件监听器的子类，默认会将所有数据行添加到一个Object集合（使用小数据场景）；ZhuZiListener：自定义的监听器，继承自解析事件监听器，内部带有自定义的业务逻辑
在调用EasyExcel.read()方法时，传递的第三个入参就是监听器
或者可以通过registerReadListener()来注册，不过有一点要注意：同一个工作簿或表单读取对象，可以同时注册多个监听器。
这就有点类似于Filter过滤器链一样，而EasyExcel存在多个监听器时，会根据添加的顺序来触发。
上面列出的一堆监听器，重点关注AnalysisEventListener即可，因为在实现导入的业务时，通常会继承它来自定义处理业务数据的逻辑，比如可以在invoke()方法里实现数据校验、落库等逻辑。
3：写对象
关于Excel数据写入的核心类，主要ExcelWriterBuilder、ExcelWriterSheetBuilder、ExcelWriterTableBuilder、WriterHandler这四个
3.1：ExcelWriterBuilder
ExcelWriterBuilder代表一个写入工作簿对象，也就是调用EasyExcel.writer()方法返回的对象，内部维护着一个WriteWorkbook对象，它支持设置的参数列表如下：
converter：数据转换器，如果读取的数据需要特定转换，则可以按需添加；head：excel数据的表头列表（以字符串列表形式指定）；clazz：与excel数据映射的模型类，与head二选一；autoTrim：是否开启自动去除前后空格，开启后写入数据前会对数据去空格；use1904windowing：日期格式是否以1904年开始，兼容特殊的excel文件；useScientificFormat：数字转文本的时候在较大的数值的是否是否采用科学计数法；
上面这些是ExcelReaderBuilder类中也存在通用参数，甚至作用都是一模一样的
registerWriteHandler：注册写入处理器，总共有工作簿、表单、数据行、单元格四个级别；relativeHeadRowIndex：写入到excel时，和顶部间隔几行，默认为0；needHead：是否需要生成数据表头（列头），默认开启；useDefaultStyle：是否使用默认的样式（即简单写入案例中那个样式）；automaticMergeHead：是否开启自动合并头，头中相同的字段名，上下左右都会尝试合并；excludeColumnIndexes：写入数据时，数据模型类中要忽略的字段下标；excludeColumnFieldNames：写入数据时，数据模型类中要忽略的字段名称；includeColumnIndexes：写入数据时，只需要导出的字段下标；includeColumnFieldNames：写入数据时，只需要导出的字段名称；orderByIncludeColumn：是否开启字段排序，默认不开启（根据类字段或指定head排序）；filedCacheLocation：数据模型的字段缓存模式，默认为ThreadLocal，可以改为纯内存或不缓存。
上述参数是当前对象、WriterSheet、WriterTable三者皆备的通用参数
再来看看ExcelWriterBuilder的专属参数：
excelType：写出的excel文件类型；charset：写出的数据编码格式（仅CSV支持）；password：为生成的文件设置查看密码；autoCloseStream：写入完成后是否自动关闭流，默认开启；file：数据要写入的目标文件；outputStream：数据要写入的目标流；templateFile：模板文件（填充场景使用）；templateInputStream：模板文件流（填充场景使用）；inMemory：是否基于内存生成文件，默认不开启，会生成临时文件；writeExcelOnException：写入过程抛出异常时，是否尝试把已有数据写入excel，默认关闭。
这些参数在写入excel时怎么设置呢？同样先来看最开始的写入案例：
java
EasyExcel.write(fileName, ZhuZi.class).sheet("竹子数据").doWrite(zhuZis);- 调用
EasyExcel.write()方法后会得到一个ExcelWriterBuilder对象 - 而执行
sheet()后会返回一个ExcelWriterSheetBuilder对象 - 最后的
doWrite()方法代表真正触发数据写入逻辑。
为此，想要设置这些参数，只要在.write()方法之后、.sheet()方法之前调用对应方法即可
3.2：ExcelWriterSheetBuilder
ExcelWriterSheetBuilder内部维护着一个WriteSheet对象，代表表单写入对象，和表单读取对象类似
与上一个对象的唯一区别就在于：可以针对某一个具体sheet去设置参数，而WriteSheet具备的独立参数也就俩：
sheetNo：将数据写入指定编码的Sheet表单（默认为0）；sheetName：将数据写入到指定名字的表单中。
如果要为单独某一个表单设置参数，则只需要在调用了sheet()方法之后、调用doWrite()方法之前设置即可
3.3：ExcelWriterTableBuilder
与读取Excel时不同，写入时多了一个WriterTable类
这个类的作用是：按表格形式写入数据到Excel文件中，即：可以向一个表单里面写入多个数据表格，
而表格的专属参数只有一个，即：
tableNo：需要写入的表格编码，默认值为0；
如果只往sheet写入一个表格，这时就算把tableNo设置成999都没用。
只有当一个sheet里写入多个表格时，就可以通过这个编号来控制先后顺序
而表格之间可以通过relativeHeadRowIndex这个通用参数来控制间隔。
3.4：WriteHandler
写入处理器WriteHandler，是EasyExcel框架在生成excel时非常重要的组件，它可以在写入过程中执行各种自定义的操作，比如自定义单元格样式、自定义合并单元格、数据行等。
因为框架内部实现了非常多的子类，所以整个WriteHandler体系比读取监听器大上很多，光WriteHandler就有二十多个子类，但其中很多我们用不到，因此就不一一做分析了，这里介绍几个较为重要的子类：
CellWriteHandler：单元格写入处理器，每写入一个单元格时会被触发；RowWriteHandler：数据行写入处理器，每写入一行数据时会被触发；SheetWriteHandler：表单写入处理器，每写入一个表单时会被触发；WorkbookWriteHandler：工作簿写入处理器，写入一个excel文件时被触发；......
其实上面列出的四个类依旧是接口，大家可以根据具体的需求选择性实现，你可以在实现类里精准控制每个单元格的样式、更改内容、合并等，最后将其注册到对应的工作簿、表单写入对象上就能生效
4：导入导出接口
想要实现导入导出接口，关键点就在于如何从网络请求中读取Excel数据，以及如何将生成的excel文件返回
其实这个很简单，回想下前面读写核心类的参数，是不是支持通过流来指定要读取/写入的目标？
因此，我们可以基于输入/输出流来实现：
java
@RestController
@RequestMapping("/excel")
public class SimpleExcelController {
/*
* Excel导入接口（要解析的目标文件传入file字段）
* */
@PostMapping("/import")
public void excelImport(MultipartFile file) {
if (null == file) {
throw new RuntimeException("哎呀，网络出小差啦......");
}
ZhuZiListener listener = new ZhuZiListener();
try {
// 从上传的文件中获取流，并基于流读取excel文件的数据
EasyExcel.read(file.getInputStream(), ZhuZi.class, listener).sheet().doRead();
} catch (IOException e) {
throw new RuntimeException("Excel文件解析失败，请稍后重试~");
}
// 这里会获取到excel里的所有数据行，可以基于该数据进行校验、落库等业务操作
List<ZhuZi> excelData = listener.getData();
}
/*
* Excel导出接口（需要将response作为参数注入）
* */
@GetMapping("/export")
public void excelExport(HttpServletResponse response) {
// 内容类型也可以设置成application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
response.setContentType("application/vnd.ms-excel");
response.setCharacterEncoding("utf-8");
String fileName = "竹子数据-" + System.currentTimeMillis() + ".xlsx";
try {
// 防止中文乱码，使用URLEncoder重新编码
fileName = URLEncoder.encode(fileName, "UTF-8").replaceAll("\\+", "%20");
} catch (UnsupportedEncodingException e) {
throw new RuntimeException("Excel导出失败，请稍后重试");
}
response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName);
// 这里模拟从库里读取的集合数据
List<ZhuZi> zhuZis = new ArrayList<>();
ZhuZi zhuZi = new ZhuZi(1L, "竹子", "男", "熊猫", new Date());
zhuZis.add(zhuZi);
try {
// 这里指定excel数据的输出目标为响应流
EasyExcel.write(response.getOutputStream(), ZhuZi.class).sheet().doWrite(zhuZis);
} catch (IOException e) {
throw new RuntimeException("Excel导出失败，请稍后重试");
}
}
}基于EasyExcel来实现导入、导出格外简单，导入时，只需要通过MultipartFile对象来接收excel文件，然后从它的流中读取数据解析即可。
当然，如果你想对excel表里的数据进行业务处理，可以选择在数据导入完成后，也可以直接在自定义的Listener监听器类中，读到一条数据就处理一次。
再来看导出接口，这里会基于response对象来实现，首先会将响应的数据声明为Excel文件，等待EasyExcel生成数据后，就会通过的OutputStream输出流返回给调用方。
只不过要注意，如果文件名是中文，则需要在内部先做UTF-8编码，否则调用方得到的文件名称就会乱码。