1.1、先容
EasyExcel是一个基于Java的大略、省内存的读写Excel的开源项目。在尽可能节约内存的情形下支持读写百M的Excel。
1.2、特点
Java领域解析、天生Excel比较有名的框架有Apache poi、jxl等。但他们都存在一个严重的问题就是非常的耗内存。如果你的系统并发量不大的话可能还行,但是一旦并发上来后一定会OOM或者JVM频繁的full gc。EasyExcel是阿里巴巴开源的一个excel处理框架,以利用大略、节省内存著称。EasyExcel能大大减少占用内存的紧张缘故原由是在解析Excel时没有将文件数据一次性全部加载到内存中,而是从磁盘上一行行读取数据,逐个解析。EasyExcel采取一行一行的解析模式,并将一行的解析结果以不雅观察者的模式关照处理(AnalysisEventListener)。2、入门利用
2.1、创建项目并引入依赖
创建一个测试用Maven项目,并导入以下依赖
<dependencies> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.7</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> <version>1.7.5</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>
2.2、最大略的写
创建实体类
利用@ExcelProperty表明可以指定excel列名,即name对应excel中的”姓名”列,birthday属性对应excel中的生日列…利用Lombok插件简化开拓可以利用@ExcelIgnore字段来让EasyExcel忽略该属性@Datapublic class ExcelEmpData { @ExcelProperty(34;姓名") private String name; @ExcelProperty("生日") private Date birthday; @ExcelProperty("薪资") private Double salary; / 利用@ExcelIgnore表明来使EasyExcel忽略这个属性 / @ExcelIgnore private String password;}
测试用例,在test包下创建一个TestWriteExcelData测试类,用于测试EasyExcel的写功能
07版本的Excel和03版本的写入办法有所不同03版本的Excel写入最多一次可写65536行编写一个静态方法,这个方法用于天生测试数据
private static List<ExcelEmpData> getEmpData() { List<ExcelEmpData> excelEmpDataList = new ArrayList<>(); ExcelEmpData data = null; for (int i = 0; i < 65535; i++) { data = new ExcelEmpData(); data.setName("java" + i); //password属性的值不会被写入Excel中 data.setPassword("123"); data.setSalary(43.96); data.setBirthday(new Date()); excelEmpDataList.add(data); } return excelEmpDataList;}
在测试类中编写一个testWrite07方法,用于对.xlsx文件进行数据写入
@Testpublic void testWrite07() { // 指天命据写入到哪个excel文件 String fileName = "F:/testExcel/01-simpleWrite-07.xlsx"; // 这里 须要指定写用哪个class去写,然后写到第一个sheet,名字为模板 然后文件流会自动关闭 EasyExcel.write(fileName, ExcelEmpData.class).sheet("模板").doWrite(getEmpData()); System.out.println("excel写入成功!
");}
结果
在测试类中编写一个testWrite03方法,用于对.xls文件进行数据写入
@Testpublic void simpleWrite03() { String fileName = "F:/testExcel/02-simpleWrite-03.xls"; // 如果这里想利用03 则 传入excelType参数即可 EasyExcel.write(fileName, ExcelEmpData.class).excelType(ExcelTypeEnum.XLS).sheet("模板").doWrite(getEmpData()); System.out.println("excel写入成功!
结果
");}
向.xls文件写入数据时,一次最多写入65536行
将getData()函数中的循环次数提高到65537@Testpublic void testWrongWrite03() { String fileName = "F:/testExcel/03-simpleWrite-03.xls"; // 如果这里想利用03 则 传入excelType参数即可 EasyExcel.write(fileName, ExcelEmpData.class).excelType(ExcelTypeEnum.XLS).sheet("模板").doWrite(getEmpData()); System.out.println("excel写入成功!
");}
结果
2.3、指定easyExcel的写入列
为实体类中的字段配置index属性
@Datapublic class ExcelEmpData { @ExcelProperty(value = "姓名",index = 1) private String name; @ExcelProperty(value = "生日",index = 3) private Date birthday; @ExcelProperty(value = "薪资",index = 5) private Double salary; / 利用@ExcelIgnore表明来使EasyExcel忽略这个属性 / @ExcelIgnore private String password;}
重新实行测试方法
@Testpublic void testWrite07() { // 指天命据写入到哪个excel文件 String fileName = "F:/testExcel/04-simpleWrite-07.xlsx"; // 这里 须要指定写用哪个class去写,然后写到第一个sheet,名字为模板 然后文件流会自动关闭 EasyExcel.write(fileName, ExcelEmpData.class).sheet("模板").doWrite(getEmpData()); System.out.println("excel写入成功!
");}
结果
2.4、指定属性的格式化
根据实体类属性的类型为属性添加不同的格式化表明
@Datapublic class ExcelEmpData { @ExcelProperty(value = "姓名") private String name; @DateTimeFormat("yyyy年MM月dd日HH时mm分ss秒") @ExcelProperty(value = "生日") private Date birthday; @NumberFormat("#.##%")//百分比表示,保留两位小数 @ExcelProperty(value = "薪资") private Double salary; / 利用@ExcelIgnore表明来使EasyExcel忽略这个属性 / @ExcelIgnore private String password;}
重新实行方法
@Testpublic void testWrite07() { // 指天命据写入到哪个excel文件 String fileName = "F:/testExcel/05-simpleWrite-07.xlsx"; // 这里 须要指定写用哪个class去写,然后写到第一个sheet,名字为模板 然后文件流会自动关闭 EasyExcel.write(fileName, ExcelEmpData.class).sheet("模板").doWrite(getEmpData()); System.out.println("excel写入成功!
");}
2.5、xlsx和xls的差异
存储相同数量的数据,用xlsx占用的空间较小
xls一次性最多写入65536条数据
3、利用EasyExcel读取文件3.1、创建监听器
@Slf4jpublic class ExcelEmpDataListener extends AnalysisEventListener<ExcelEmpData> { / 每隔5条存储数据库,实际利用中可以3000条,然后清理list ,方便内存回收 / private static final int BATCH_COUNT = 5; List<ExcelEmpData> list = new ArrayList<>(); / 这个每一条数据解析都会来调用 @param data one row value. Is is same as {@link AnalysisContext#readRowHolder()} @param context / @Override public void invoke(ExcelEmpData data, AnalysisContext context) { log.info("解析到一条数据:{}", data); list.add(data); // 达到BATCH_COUNT了,须要去存储一次数据库,防止数据几万条数据在内存,随意马虎OOM if (list.size() >= BATCH_COUNT) { log.info("存数据库"); // 存储完成清理 list list.clear(); } } / 所有数据解析完成了 都会来调用 @param context / @Override public void doAfterAllAnalysed(AnalysisContext context) { log.info("所有数据解析完成!
"); }}
3.2、测试
创建testRead.xlsx文件,添加测试数据
创建测试方法
/ 最大略的读 /@Testpublic void simpleRead07() { String fileName = "F:/testExcel/testRead.xlsx"; // 这里默认读取第一个sheet EasyExcel.read(fileName, ExcelEmpData.class, new ExcelEmpDataListener()).sheet().doRead();}@Testpublic void simpleRead03() { String fileName = "F:/testExcel/testRead.xls"; // 这里默认读取第一个sheet EasyExcel.read(fileName, ExcelEmpData.class, new ExcelEmpDataListener()).excelType(ExcelTypeEnum.XLS).sheet().doRead();}
结果
成功!