EasyExcel 基础入门
1. 简介:
EasyExcel是一个基于Java的简单、省内存的读写Excel的开源项目。在尽可能节约内存的情况下支持读写百M的Excel。
2.官方网站
https://github.com/alibaba/easyexcel
快速开始:https://www.yuque.com/easyexcel/doc/easyexcel
3. EasyExcel特点
- Java领域解析、生成Excel比较有名的框架有Apache poi、jxl等。但他们都存在一个严重的问题就是非常的耗内存。如果你的系统并发量不大的话可能还行,但是一旦并发上来后一定会OOMZ或者JVM频繁的full gc。
- EasyExcel是阿里巴巴开源的一个excel处理框架,以使用简单、节省内存著称。EasyExcel能大大减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中,而是从磁盘上一行行读取数据,逐个解析(代码中会有体现)。
- EasyExcel采用一行一行的解析模式,并将一行的解析结果以观察者的模式通知处理(AnalysisEventListener)。
pom.xml 引入依赖
<dependencies>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>2.1.7</version>
</dependency>
<dependency>
<groupId>org.apache.xmlbeans</groupId>
<artifactId>xmlbeans</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.10</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
4.最简单的写
1.创建实体类
package com.atguigu.easyexcel.entity;
@Data
public class ExcelStudentData {
@ExcelProperty("姓名")
private String name;
@ExcelProperty("生日")
private Date birthday;
@ExcelProperty("薪资")
private Double salary;
/**
* 忽略这个字段
*/
@ExcelIgnore
private String password;
}
2.测试用例
- 07版本的Excel和03版本的写入方式有所不同
- 03版本的Excel写入最多一次可写65536行 !!!!!(取除表格65535行,其实就怕占用过多内存,让机器宕机)
public class WriteTest {
@Test
public void simpleExcelWrit07(){
String fileName = "G:\\5.项目\\谷粒学院\\java\\aliyunEasyExcel\\test01-07.xlsx";
EasyExcel.write(fileName, ExcelStudentData.class)
.sheet("Sheet1")
.doWrite(data());
}
@Test
public void simpleExcelWrit03(){
String fileName = "G:\\5.项目\\谷粒学院\\java\\aliyunEasyExcel\\test01-03.xls";
EasyExcel.write(fileName, ExcelStudentData.class)
.excelType(ExcelTypeEnum.XLS)
.sheet("Sheet1")
.doWrite(data());
}
public List<ExcelStudentData> data(){
List<ExcelStudentData> list = new ArrayList<ExcelStudentData>();
for (int i = 0; i < 10; i++) {
ExcelStudentData student = new ExcelStudentData();
student.setName("summer"+i);
student.setBirthday(new Date());
student.setSalary(0.232);
list.add(student);
}
return list;
}
}
03写的时候:
EasyExcel.write(fileName, ExcelStudentData.class)
.excelType(ExcelTypeEnum.XLS)
.sheet("Sheet1")
.doWrite(data());
多一个.excelType(ExcelTypeEnum.XLS)
注意:
使用07写的方式确实可以写03版的Excel,但是这样写出的文件再使用03版读不出来了。
我们在写的时候一定要注意文件后缀
03 -> .xls
07 ->.xlsx
3.指定写入列
为列配置 index 属性
package com.atguigu.easyexcel.entity;
@Data
public class ExcelStudentData {
@ExcelProperty(value = "姓名", index = 0)
private String name;
@ExcelProperty(value = "生日", index = 1)
private Date birthday;
/**
* 这里设置3 会导致第二列空的
*/
@ExcelProperty(value = "薪资", index = 3)
private Double salary;
/**
* 忽略这个字段
*/
@ExcelIgnore
private String password;
}
4.自定义格式转换
配置时间格式:@DateTimeFormat
配置数字格式:@NumberFormat
package com.atguigu.easyexcel.entity;
@Data
public class ExcelStudentData {
@ExcelProperty(value = "姓名")
private String name;
@DateTimeFormat("yyyy年MM月dd日HH时mm分ss秒")
@ExcelProperty(value = "生日")
private Date birthday;
@NumberFormat("#.##%")//百分比表示,保留两位小数
@ExcelProperty(value = "薪资")
private Double salary;
/**
* 忽略这个字段
*/
@ExcelIgnore
private String password;
}
5.最简单的读
1、参考文档
https://www.yuque.com/easyexcel/doc/read
2、创建监听器
EasyExcel是阿里巴巴开源的一个excel处理框架,以使用简单、节省内存著称。EasyExcel能大大减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中,而是从磁盘上一行行读取数据,逐个解析(代码中会有体现)。
public class ExcelStudentDataListener extends AnalysisEventListener<ExcelStudentData> {
// 设置阈值当读取行数达到阈值时,就将数据存入数据库
// 避免内占用过多,导致内存溢出
private final static int BASE_COUNT = 3;
// 使用list集合存储数据
private List<ExcelStudentData> list = new ArrayList<ExcelStudentData>();
/**
* 每读一行就执行一次invoke
* @param data 每行数据
* @param context
*/
public void invoke(ExcelStudentData data, AnalysisContext context) {
System.out.println(data);
list.add(data);
if (list.size()>BASE_COUNT){
System.out.println("数据存入数据库");
System.out.println("清空list");
list.clear();
}
}
/**
* Excel全部数据读取结束执行此方法
* @param context
*/
public void doAfterAllAnalysed(AnalysisContext context) {
System.out.println("将剩余的数据读入数据库");
System.out.println("数据读取结束");
}
}
3、测试用例
public class ReadTest {
/**
* 最简单的读
*/
@Test
public void ReadTest07(){
String fileName = "G:\\5.项目\\谷粒学院\\java\\aliyunEasyExcel\\test01-07.xlsx";
// 这里默认读取第一个sheet
EasyExcel.read(fileName, ExcelStudentData.class, new ExcelStudentDataListener()).sheet().doRead();
}
@Test
public void ReadTest03(){
String fileName = "G:\\5.项目\\谷粒学院\\java\\aliyunEasyExcel\\test01-03.xls";
// 这里默认读取第一个sheet
EasyExcel.read(fileName, ExcelStudentData.class, new ExcelStudentDataListener()).excelType(ExcelTypeEnum.XLS).sheet(0).doRead();
}
}