easyexcel 导入的实现技巧

发布时间：2023-05-20

一、Excel文件导入的背景与现状

Excel文件是一种常见的办公文档格式，随着各项业务的数字化，Excel导入功能在很多企业和个人开发中得到了广泛应用。传统的Excel导入方式存在着很多问题，比如繁琐的代码实现、稳定性和效率低下等问题。那么如何高效、便捷地实现Excel文件导入呢？easyexcel是一种快速实现Excel导入的工具，下面我们将逐一讲解。

二、easyexcel 导入的使用方法及原理

Easyexcel 是一个基于Java语言的Excel读写工具，它是基于POI实现的，使用注解和类型转换完成 Java Bean 的映射，能够快速方便地实现 Excel 的导入和导出。easyexcel 是由阿里巴巴的千牛团队开发的开源项目，github 地址为 https://github.com/alibaba/easyexcel 。 使用easyexcel 导入文件时，需要引入easyexcel 依赖，如下所示：

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

导入程序样式如下：

public class EasyExcelImport {
   public static void main(String[] args) {
         String fileName = "/xxx/xxx.xlsx";
         EasyExcel.read(fileName, DemoData.class, new DemoDataListener()).sheet().doRead();
   }
}

上面演示的是单个Sheet页数据的导入，如果有多个Sheet页，可以使用sheet(int sheetNo)方法指定具体的Sheet页码，如 sheet(2)，表示导入第2个Sheet页的数据。

三、easyexcel 导入的注意事项

easyexcel 导入需要注意的问题如下：

  1. Excel 表格中的第一行必须是标题行。
  2. 通过注册监听器来获取解析到的数据，示例代码如下：
public class DemoDataListener extends AnalysisEventListener<DemoData>{
  List<DemoData> list = new ArrayList<>();
  @Override
  public void invoke(DemoData data, AnalysisContext context) {
      list.add(data);
  }
  @Override
  public void doAfterAllAnalysed(AnalysisContext context) {
      //do something
  }
}
  1. Excel 单元格值存在样式和格式化问题，easyexcel 提供了一些默认值和注解，来解决这些问题，示例代码如下：
public class DemoData {
   // 格式化 ： 1.0 -> 美元 1 (Excel中是￥1.00)
   @NumberFormat("##.##")
   private BigDecimal price;
   // 自定义转换器
   @TableField(value = "日期")
   private Date date;
   // 导入表头名称为“人名”
   @TableField(value = "人名")
   private String name;
   // 导入表头名称为“性别”
   @TableField(value = "性别")
   private String gender;
   // 导入表头名称为“年龄”，字符串转数字
   @TableField(value = "年龄")
   private Integer age;
 }

四、easyexcel 导入的常见问题及解决方法

easyexcel 导入中常见的问题有：空指针异常、FileNotFoundException 文件不存在、IllegalArgumentException 参数错误等。解决这些问题的方法如下：

  1. 空指针异常。在数据解析过程中，很可能会出现某些字段为空或是出现空指针的错误，提示空指针异常。这个问题可以通过增加对数据校验的处理来解决。示例代码如下：
@NotNull(message="这个属性不能为空")
private String name;
  1. FileNotFoundException 文件不存在。如果导入的 Excel 文件不存在，会出现FileNotFoundException 异常。这个问题可以通过增加对文件是否存在的校验来解决。
  2. IllegalArgumentException 参数错误。easyexcel 读取 Excel 数据时，会有一些参数要求类型等，如果发生参数错误，会提示IllegalArgumentException 异常。这个问题可以通过检查参数类型是否正确，以及各个参数在代码中是否被正确引用来解决。

五、总结

本文介绍了easyexcel 导入的使用方法、原理及注意事项，同时也介绍了常见的easyexcel 导入问题及解决方法。总的来说，使用easyexcel 导入数据，需要注意一些细节问题，特别是需要注意数据格式等，就可以比较好地解决数据导入问题。

推荐文章