EasyExcel进阶教程

EasyExcel进阶教程

Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是非常的耗内存,poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题,但POI还是有一些缺陷,比如07版Excel解压缩以及解压后存储都是在内存中完成的,内存消耗依然很大。
easyexcel重写了poi对07版Excel的解析,一个3M的excel用POI sax解析依然需要100M左右内存,改用easyexcel可以降低到几M,并且再大的excel也不会出现内存溢出;03版依赖POI的sax模式,在上层做了模型转换的封装,让使用者更加简单方便。

——引自EasyExcel官网

概述

EasyExcel官网(其中包括常规的导出模板填充的导出)的基础操作已经很到位了。但也仅仅是基础操作。在实际应用中,对Excel的解析往往会有更加复杂的操作,比如动态表头、表头样式动态设置、单元格内容设置(如下拉框)等等。笔者结合自己的使用经验,对一些官网示范不是很明显的功能在此进行简单介绍,可能会不定时持续更新

一、关于表头

1.1 多级表头

EasyExcel支持多级表头,其表现形式如下图:
在这里插入图片描述
以上例图中,用户数据汇总为一级表头;ID、用户名称为二级表头。多级表头在实际应用中也比较常见。其代码实现也很简单,只需要设置对应实体类中@ExcelProperties注解中的value字段值即可:

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

@Data
public class DemoData {
   
    @ExcelProperty(value = {
   "用户数据汇总", "ID"}, index = 0)
    private String id;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, index = 1)
    private String userName;
}

@ExcelProperties注解中的value字段类型为一个字符串数组,该数组的长度即为Excel中表头级数。而index则为字段的排序,且为严格排序。

1.2 ExcelProperties注解的index字段和order字段的第一个区别

何谓严格排序?换句话说,就是index=0的字段一定会出现在A列,index=2的字段一定会出现在C列。再换句话说,如果你的实体类中的index的值不是连续的,那就意味着你导出的Excel中会有空白列。比如下面的实体类:

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

@Data
public class DemoData {
   
    @ExcelProperty(value = {
   "用户数据汇总", "ID"}, index = 0)
    private String id;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, index = 1)
    private String userName;
    @ExcelProperty(value = {
   "用户数据汇总", "性别"}, index = 3)
    private String gender;
}

注意index的值没有2,这意味着导出的Excel的C列是空的,效果如下:
在这里插入图片描述
那么问题来了:如果我只是想用数字的大小表示字段的排列顺序,而不想空出一列怎么办呢?很简单,不要使用@ExcelPropertiesindex属性,改用其order属性就可以了:

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

@Data
public class DemoData {
   
    @ExcelProperty(value = {
   "用户数据汇总", "ID"}, order = 0)
    private String id;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, order = 1)
    private String userName;
    @ExcelProperty(value = {
   "用户数据汇总", "性别"}, order = 3)
    private String gender;
}

这个实体类的@ExcelProperties注解的order字段的值从1直接跳到了3,效果如下图:
在这里插入图片描述

1.3 ExcelProperties注解的index字段和order字段的第二个区别

@ExcelProperties注解的order字段的值可以重复,但@ExcelProperties注解的index字段的值不可以重复,否则会报错:

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

@Data
public class DemoData {
   
    @ExcelProperty(value = {
   "用户数据汇总", "ID"}, index = 0)
    private String id;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, index = 0)
    private String userName;
}

如上示例代码,id字段和userName字段的索引值都是0,在运行时会抛出com.alibaba.excel.exception.ExcelCommonException异常:
在这里插入图片描述

1.4 表头单元格的合并

另外还需要注意的一点是,@ExcelProperties注解的value字段是用来填充Excel文件的表头的。如果相邻索引的同级表头名称相同,则EasyExcel会自动将他们合并单元格,具体表现形式即为一级表头用户数据汇总那样。为便于直观理解,请看如下示例(Tips:示例代码中排序使用index字段或是order字段,不会影响本小节效果):

import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

@Data
public class DemoData {
   
    @ExcelProperty(value = {
   "用户数据汇总", "ID"}, index = 0)
    private String id;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, index = 1)
    private String userName;
    @ExcelProperty(value = {
   "用户数据汇总", "性别"}, index = 2)
    private String gender;
    @ExcelProperty(value = {
   "用户数据汇总", "性别"}, index = 3)
    private String genderCn;
    @ExcelProperty(value = {
   "用户数据汇总", "生日"}, index = 4)
    private String birthDay;
    @ExcelProperty(value = {
   "用户数据汇总", "用户名称"}, index = 5)
    private String userNameCn;
}

在上面的实体类中,字段gender和genderCn的二级表头同为“性别”且索引值相邻;字段userName和userNameCn的二级表头同为“用户名称”,但索引值不相邻。其效果图如下:
在这里插入图片描述
可以看到,两个性别字段因为相邻且表头名相同,被自动合并单元格了;而两个同为用户名称的字段则因为不相邻,所以并未被合并。

关于表头的一些基础注意事项就写到这里。

二、动态表头

在实际业务中,我们需要导出的Excel表头可能是这样的:
在这里插入图片描述
其中一级表头的“XXXX”都是动态的。即2024年5月导出的一级表头是“2024年05月数据汇总”,而2024年4月份导出的一级表头就成了“2024年04月数据汇总”。EasyExcel可以处理这种场景,但是官网的示例展示的不是很明显。
处理这种业务场景,我们需要自己封装一个处理器,该处理器需要实现EasyExcel的CellWriteHandler处理器,并重写afterCellDispose方法;同时在注解实体类时,要预留出动态值的填充位置:
实体类的注解如下:

import com.alibaba.excel.annotation.ExcelProperty;
import lombok
  • 9
    点赞
  • 27
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
EasyExcel是一个Java操作Excel文件的工具库,它基于Apache POI实现。它提供了简单易用的方法来读取、写入和处理Excel文件。下面是EasyExcel的基本教程: 1. 添加EasyExcel依赖:首先,在你的项目中添加EasyExcel的依赖。可以在你的项目的pom.xml文件中添加以下依赖项: ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.2.12</version> </dependency> ``` 2. 读取Excel文件:使用EasyExcel可以简单地读取Excel文件的内容。通过`read`方法可以读取Excel中的数据并将其映射到Java对象中。以下是一个简单的读取示例: ```java String fileName = "path/to/excel.xlsx"; List<Object> data = EasyExcel.read(fileName).sheet().doReadSync(); ``` 3. 写入Excel文件:使用EasyExcel可以将数据写入Excel文件中。通过`write`方法可以将Java对象的数据写入到Excel文件中。以下是一个简单的写入示例: ```java String fileName = "path/to/excel.xlsx"; List<Object> data = new ArrayList<>(); // 填充数据 EasyExcel.write(fileName).sheet().doWrite(data); ``` 4. 调整行高、列宽和样式:EasyExcel提供了方法来调整Excel文件中的行高、列宽和样式。你可以使用`setXXX`方法来设置行高、列宽、背景色、字体大小等样式。以下是一个示例: ```java TableStyle style = new TableStyle(); // 创建样式对象 style.setTableContentBackGroundColor(IndexedColors.WHITE); // 设置表格内容的背景色为白色 style.setTableContentFontName("Arial"); // 设置表格内容的字体为Arial style.setTableContentFontSize(12); // 设置表格内容的字体大小为12 WriteSheet sheet = EasyExcel.writerSheet().build(); // 创建Sheet对象 sheet.setTableStyle(style); // 设置Sheet的样式 EasyExcel.write(fileName).withTemplate(templateFileName).sheet().doWrite(data); ``` 需要注意的是,EasyExcel的控制方式与使用原生POI类似,但相对来说更加简洁易用。另外,EasyExcel能够处理大文件时,会减少内存消耗,并且不容易发生内存溢出的情况。 总结一下,EasyExcel是一个方便易用的Java操作Excel文件的工具库,它提供了简单的读取和写入方法,并且支持调整行高、列宽和样式。它基于Apache POI实现,并且能够处理大文件时减少内存消耗。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值