陈老老老板
说明:工作了,学习一些新的技术栈和工作中遇到的问题,边学习边总结,各位一起加油。需要注意的地方都标红了,还有资源的分享. 一起加油。本文是介绍 EasyExcel 详解与 SpringBoot 整合
git资源地址:https://gitee.com/lt_xu/easy-excel-demo.git
一、EasyExcel
1.EasyExcel 简介
简介:可以去官网看看,官网介绍文档也很全面。EasyExcel官网EasyExcel 是一个==基于 Java 的简单、省内存的读写 Excel 的开源项目==。在尽可能节约内存的情况下支持读写百 M 的 Excel。(其实总体来说就是占内存小,响应快,写法简单)
1.2.重写 POI 简化开发
1.3. 特点
在数据模型层面进行了封装,使用简单
重写了 07 版本的 Excel 的解析代码,降低内存消耗,能有效避免 OOM
只能操作 Excel
不能读取图片
2. Apache POI 简介
简介:Apache POI是 Apache 软件基金会的开源函式库,提供跨平台的Java API实现Microsoft Office格式档案读写。但是存在如下一些问题:
2.1 学习使用成本较高
对 POI 有过深入了解的才知道原来 POI 还有 SAX 模式(Dom 解析模式)。但 SAX 模式相对比较复杂,excel 有 03 和 07 两种版本,两个版本数据存储方式截然不同,sax 解析方式也各不一样。
学习这两种解析方式,在转换到自己的业务模块是需要好久的学习时间,并且由于代码过于复杂,之后维护成本非常大。
POI 的 SAX 模式的 API 可以一定程度的解决一些内存溢出的问题,但是 POI 还是有一些缺陷,比如 07 版 Excel 解压缩以及解压后存储都是在内存中完成的,内存消耗依然很大,一个 3M 的 Excel 用 POI 的 SAX 解析,依然需要 100M 左右内存。
2.2 POI 的内存消耗较大
大部分使用 POI 都是使用他的 userModel 模式。userModel 的好处是上手容易使用简单,随便拷贝个代码跑一下,剩下就是写业务转换了,虽然转换也要写上百行代码,相对比较好理解。然而 userModel 模式最大的问题是在于非常大的内存消耗,一个几兆的文件解析要用掉上百兆的内存。现在很多应用采用这种模式,之所以还正常在跑一定是并发不大,并发上来后一定会 OOM 或者频繁的 full gc。
总体上来说,简单写法重度依赖内存,复杂写法学习成本高。
特点
功能强大
代码书写冗余繁杂
读写大文件耗费内存较大,容易 OOM
二、SpringBoot 整合 EasyExcel
1.创建 SpringBoot 项目
2.导入依赖坐标
注:easyexcel 坐标,最新 3.1.1 版本,推荐使用,一直在更新的版本。
<b><b><b><code class="language-xml"> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency></code></b></b></b>
复制代码
注:项目全部坐标,这里用到 lombok 插件,开发更简单。
<b><b><b><code class="language-xml"><dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency>
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency>
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <scope>provided</scope> </dependency> <!--easyExcel--> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency></code></b></b></b>
复制代码
3.创建实体类
注:创建 Student 实体类,用来与 excel 表头映射。 这里实体类顺序必须和 excel 中表头顺序一致,否则会报错,这里应该是最新版本的问题。也可以用注解映射在后面往 excel 写的时候会讲。
<b><b><b><code class="language-java">// 基于lombok@Data@NoArgsConstructor@AllArgsConstructorpublic class Student { /** * 学生姓名 */ private String name; /** * 学生出生日期 */ private Date birthday; /** * 学生性别 */ private String gender; /** * id */ private String id;}</code></b></b></b>
复制代码
fillData 数据测试类
<b><b><b><code class="language-java">@Datapublic class FillData {
private String name; private int age;}</code></b></b></b>
复制代码
4.创建监听器
注:必须继承 AnalysisEventListener<> 实现 invoke 与 doAfterAllAnalysed 方法。
<b><b><b><code class="language-java">public class StudentReadListener extends AnalysisEventListener<Student> { // 每读一次,会调用该invoke方法一次,就是想对获取到的数据进行什么操作 @Override public void invoke(Student data, AnalysisContext context) { System.out.println("data = " + data); log.info(data + "保存成功"); }
// 全部读完之后,会调用该方法(这个暂时用不到) @Override public void doAfterAllAnalysed(AnalysisContext context) { // TODO...... }}</code></b></b></b>
复制代码
5.在测试类中加入数据生成方法
<b><b><b><code class="language-java"> // 数据生成 private static List<Student> initData(){ List<Student> students=new ArrayList<>(); for (int i = 0; i < 10; i++) { Student data=new Student(); data.setName("测试"+i+2); data.setGender("男"); data.setBirthday(new Date()); students.add(data); } System.out.println(students); return students; }</code></b></b></b>
复制代码
三、测试各种功能
1.读取Excel文件
注:这里 read 的第一个参数表示要读 excel 文件地址,先将文件拉取到项目中,右键点击 excel 文件,点击 Copy Path 进行复制。最后点击运行该方法就可以看到读取到 excel 中的数据。
<b><b><b><code class="language-java"> @Test public void test01(){ /** * Build excel the read 构建一个读的工作簿 * * @param pathName 读文件的路径 * File path to read. * @param head 每一行数据存储的到的实体类的类型的class * Annotate the class for configuration information. * @param readListener 监听器 没读一行内容都会调用该对象的invoke,在invoke可以操作使用读取到的数据 * Read listener. * @return Excel reader builder. */// 获取工作簿对象 excel文件位置 最后一个参数是监听器类 ExcelReaderBuilder readWorkBook = EasyExcel.read("E:\blank\EasyExcel\杭州黑马在线202003班学员信息表.xlsx", Student.class, new StudentListener());// 获取工作表对象 ExcelReaderSheetBuilder sheet = readWorkBook.sheet();// 读取表中的内容 sheet.doRead();</code></b></b></b>
复制代码
2.写入 Excel
注:实体类中加入注解 @ExcelProperty,注解中 value 的值代表,写入 excel 的表头。
<b><b><b><code class="language-java">@Data@AllArgsConstructor@NoArgsConstructor@ColumnWidth(20)public class Student {
/** * id */ //index 代表表头的位置,否则默认 各个参数在本类中的位置 //@ExcelProperty(value = "编号",index = 3) //忽略在表中不会显示该字段 @ExcelIgnore private String id; /** * 学生姓名 */ @ExcelProperty(value = "学生姓名") //表示列的宽度 //@ColumnWidth(30) private String name; /** * 学生性别 */ @ExcelProperty(value = "学生性别") private String gender;
/** * 学生出生日期 */ @ExcelProperty(value = "学生出生日期") //@ColumnWidth(20) private Date birthday;}</code></b></b></b>
复制代码
注:测试类中加入写入 excel 的方法
<b><b><b><code class="language-java"> @Test public void test02(){ ExcelWriterBuilder writeWorkBook = EasyExcel.write("E:\blank\EasyExcel\在线学员信息表.xlsx", Student.class); ExcelWriterSheetBuilder sheet = writeWorkBook.sheet(); //doWrite(initData()之前提前加入的生成数据的方法。 sheet.doWrite(initData()); }</code></b></b></b>
复制代码
总结:EasyExcel 简化开发,减少内存,必学。希望对您有帮助,感谢阅读结束语:裸体一旦成为艺术,便是最圣洁的。道德一旦沦为虚伪,便是最下流的。勇敢去做你认为正确的事,不要被世俗的流言蜚语所困扰。
评论