EasyExcel太简单易用了,强烈推荐!


文章来源:【公众号:程序新视界】‍

目录

  • 背景

  • 项目构建及依赖

  • 创建实体类

  • 生成 Excel

  • 解析 Excel

  • 其他相关特殊用法

  • 小结

背景

系统中经常要导出大量的数据,格式基本上都是 Excel,然而每次导表都是对系统内存的一次挑战。

在 Java 领域,生成或解析 Excel 的框架比较有名的当属 Apache 的 poi 和 jxl 了。但使用它们,会面临着严重的内存损耗问题。

如果系统的并发量还不行,一旦导出大量数据,便会出现 JVM 频繁 full gc,甚至导致 OOM。

EasyExcel 是阿里巴巴开源的一个 Excel 处理框架,使用简单、节省内存。节省内存的原理也很简单,在解析 Excel 时没有将文件数据全部加载到内存当中,而是从磁盘文件中一行行读取。

今天这篇文章就带大家来了解一下 EasyExcel 的使用,个人使用后的感慨是:太简单易用了。

项目构建及依赖

首先创建一个 Maven 项目,在 pom 文件中添加如下依赖:

<dependency>
     <groupId>com.alibaba</groupId>
     <artifactId>easyexcel</artifactId>
     <version>2.2.8</version>
</dependency>

当引入该依赖之后,会发现在项目的依赖文件中同时多出了 poi 的类库。

也就是说,EasyExcel 是基于 poi 来进行实现的,间接地引入了如下依赖:

<dependency>
     <groupId>org.apache.poi</groupId>
     <artifactId>poi</artifactId>
     <version>3.17</version>
</dependency>
<dependency>
     <groupId>org.apache.poi</groupId>
     <artifactId>poi-ooxml</artifactId>
     <version>3.17</version>
</dependency>

所以,当你的项目中已经引入了 poi 的依赖,要考虑一下版本的兼容问题。

创建实体类

EasyExcel 易用性的体现之一就是可以通过在实体类中使用注解的形式,来与 Excel 中的表头进行绑定。

现在直接上实体类:

@Data
public class UserData {

 @ExcelProperty(index = 0, value = "姓名")
 private String username;

 @ExcelProperty(index = 1, value = "年龄")
 private int age;

 @DateTimeFormat("yyyy-MM-dd")
 @ExcelProperty(index = 2, value = "生日")
 private Date birthday;
}

在上面的实体类中 @Data 为 Lombok 的注解,当然你可以自行生成 getter/setter 方法,其他的注解均为 EasyExcel 提供的:

  • @ExcelProperty:用于设置 Excel 表头,其中 index 用户表头的编号,从 0 开始;value 为表头对应的内容。

  • @DateTimeFormat:用于日期的格式化。

完成上述功能准备工作之后,我们先来生成一个 Excel。

生成 Excel

下面直接展示生成 Excel 的示例代码:

public class EasyExcelDemo {

 public static void main(String[] args) {
  // 实现excel写操作
  //1.设置写入文件夹地址和excel文件名称
  String fileName = "/Users/zzs/temp/excel/write.xlsx";
  //调用easyExcel里面的方法实现写操作
  //2个参数,第一个参数是文件名称,第二个参数是实体类
  EasyExcel.write(fileName, UserData.class).sheet("学生信息表").doWrite(getData());
 }

 //创建方法返回list集合
 public static List<UserData> getData() {
  List<UserData> list = new ArrayList<>();

  UserData userData1 = new UserData();
  userData1.setUsername("张三");
  userData1.setAge(22);
  userData1.setBirthday(formatDate("2000-10-11"));
  list.add(userData1);

  UserData userData2 = new UserData();
  userData2.setUsername("李四");
  userData2.setAge(23);
  userData2.setBirthday(formatDate("1999-5-3"));
  list.add(userData2);

  return list;
 }

 public static Date formatDate(String birthday) {
  SimpleDateFormat sdf = new SimpleDateFormat("yyy-MM-dd");
  try {
   return sdf.parse(birthday);
  } catch (ParseException e) {
   e.printStackTrace();
  }
  return null;
 }
}

除了准备数据的代码,核心代码只有 main 方法中调用的 EasyExcel.write 方法,就是如此的简单。

EasyExcel 的 write 方法会根据传入的数据和实体类 UserData 进行绑定,生成 Excel 文件。

我们来看一下 Excel 的效果:

3f72f7d0f69b7f871aa094f5b41c0e17.png
write-excel

生成效果还不错,而且使用起来是不是非常简单?

解析 Excel

再来看看解析 Excel 的操作,直接用上面生成的 Excel 文件。

首先创建一个监听器 ExcelListener,集成 EasyExcel 提供 AnalysisEventListener 类:

public class ExcelListener extends AnalysisEventListener<UserData> {

 /**
  * 一行一行的读取excel内容
  */
 @Override
 public void invoke(UserData data, AnalysisContext analysisContext) {
  System.out.println("****" + data);
 }

 /**
  * 读取表头内容
  */
 @Override
 public void invokeHeadMap(Map<Integer, String> headMap, AnalysisContext context) {
  System.out.println("表头" + headMap);
 }

 /**
  * 读取完成操作
  */
 @Override
 public void doAfterAllAnalysed(AnalysisContext analysisContext) {
  System.out.println("读取Excel完毕");
 }
}

在该监听器中,通过重写 AnalysisEventListener 的方法来获得解析的数据、表头信息,以及解析完毕之后执行的操作信息。

同样写 Excel 一样,通过 EasyExcel 类的静态方法来执行读操作:

public class EasyExcelReadDemo {

 public static void main(String[] args) {
  // 实现excel写操作
  //1.设置写入文件夹地址和excel文件名称
  String fileName = "/Users/zzs/temp/excel/write.xlsx";
  //调用easyExcel里面的方法实现写操作
  //2个参数,第一个参数是文件名称,第二个参数是实体类
  EasyExcel.read(fileName, UserData.class, new ExcelListener()).sheet().doRead();
 }
}

执行上述方法,打印信息如下:

表头{0=姓名, 1=年龄, 2=生日}
****UserData(username=张三, age=22, birthday=Wed Oct 11 00:00:00 CST 2000)
****UserData(username=李四, age=23, birthday=Mon May 03 00:00:00 CST 1999)
读取Excel完毕

最先是打印了表头信息,这里也可以看到表头的排序是从 0 开始的。然后,读取并打印了对应的 Excel 内容,两条数据;最后,执行读取完的方法中的日志打印。

看完了上面的整个操作,解析 Excel 是不是变得非常简单了?再也不为解析 Excel 犯愁了。

其他相关特殊用法

上面提到的 @DateTimeFormat 注解可转换日期格式,还有其他类似功能的注解和自定义转换器。

①自定义转换器

通过自定义转换器,比如将 1、0 转换成男、女的实例:

import com.alibaba.excel.converters.Converter;
import com.alibaba.excel.enums.CellDataTypeEnum;
import com.alibaba.excel.metadata.CellData;
import com.alibaba.excel.metadata.GlobalConfiguration;
import com.alibaba.excel.metadata.property.ExcelContentProperty;

public class SexConverter implements Converter<Integer> {

    @Override
    public Class<Integer> supportJavaTypeKey() {
        return Integer.class;
    }

    @Override
    public CellDataTypeEnum supportExcelTypeKey() {
        return CellDataTypeEnum.STRING;
    }

    @Override
    public Integer convertToJavaData(CellData cellData, ExcelContentProperty excelContentProperty, GlobalConfiguration globalConfiguration) throws Exception {
        return "男".equals(cellData.getStringValue()) ? 1 : 0;
    }

    @Override
    public CellData<String> convertToExcelData(Integer integer, ExcelContentProperty excelContentProperty, GlobalConfiguration globalConfiguration) throws Exception {
        return new CellData<>(integer.equals(1) ? "男" : "女");
    }
}

性别属性注入 SexConverter 转换器:

@ExcelProperty(value = "性别", converter = SexConverter.class)
private Integer sex;

再次生成 Excel,性别字段内容便显示为:男、女字样。

②保留两位小数

比如体重需要保留两位小数,可通过 @NumberFormat 注解实现:

@ExcelProperty(value = "体重KG")
@NumberFormat("0.##") // 会以字符串形式生成单元格,要计算的列不推荐
private BigDecimal weight;

另外一种方法是使用 @ContentStyle 注解:

@ContentStyle(dataFormat = 2)
private BigDecimal weight2;

这样也能达到保留两位小数的效果。当然,也可以使用实现 Converter 接口的方式实现(同性别实现)。

③排除指定 Excel 列

在很多场景下,Excel 的列与实体类可能并不完全一致,这时就需要排除一些实体类的字段。

方式一:类上加注解 @ExcelIgnoreUnannotated,过滤属性没有 @ExcelProperty 注解的字段。

@Data
@ToString
@AllArgsConstructor
@NoArgsConstructor  // 一定要有无参构造方法
@ExcelIgnoreUnannotated
public class UserData {
    .....
}

方式二:指定字段加 @ExcelIgnore 注解。

@ExcelIgnore // 该字段不生成excel
private String remark;

方式三:代码指定过滤字段,通过 excludeColumnFiledNames 方法:

EasyExcel.write(fileName, UserData.class).sheet("学生信息表").excludeColumnFiledNames(Arrays.asList("remark")).doWrite(getData());

这种方法的好处是:同一 Excel 可以在调用方法时排除不同的数据列。

小结

本文介绍了 EasyExcel 的使用,整体而言操作简单、使用方便,提供了不少注解,方便与实体对象之间的关系绑定。而且官网也提供了相关的性能数据,更多的 API 使用大家还可以继续探索。

无论从性能或易用性上来说,都值得你尝试。特别是临时写一个 Excel 的解析或生成的工具,再也不用惆怅一行行的解析了,赶紧收藏用起来吧。

-------------  END  -------------
扫码免费获取600+页石杉老师原创精品文章汇总PDF



原创技术文章汇总


点个在看你最好看
  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

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

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值