EasyExcel快速入门（详解）

蔚落 2024-03-30 17:34 74阅读 0赞

### EasyExcel 和 POI 优劣对比 ###

POI一直以来被行业所诟病的问题，就是非常的消耗内存，

EasyExcel底层对POI进行了封装，重写了poi的方法。在解析Excel时没有将文件数据一次性全部加载到内存中，而是从磁盘上一行行读取数据，逐个解析，遇到再大的excel都不会出现内存溢出的问题，能够将一个原本3M的excel文件，POI来操作将会占用内存100M，使用EasyExcel降低到几KB，并且使用起来更加简单。

![a90f4e4d565b1b3e60763d1663d9d706.png][]

![a9aeea036c23e99e8523b792a8e5ceeb.png][]

### EasyExcel的使用 ###

使用EasyExcel需要引入alibaba第三方依赖

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

*  #### EasyExcel的读 ####

一次完整的读取

public static void completeRead(String path) {
            #1. 配置信息
            //创建ExcelReaderBuilder实例
            ExcelReaderBuilder readerBuilder = EasyExcel.read();
    
            //映射制定对象，需要创建实体类，使用@ExcelProperty注解完成实体类成员变量和Excel字段的映射
            //解析Excel文件时候直接指定实体类即可
            //head()方法指定解析实体类类型
            //不指定默认Object类型，实质是Object的子类LinkedHashMap,断点调试的形式可以看到
            readerBuilder.head(FactorLibrary.class);
            //获取文件对象
            readerBuilder.file(path);
            //指定sheet，不指定去读所有
            readerBuilder.sheet("车站");
            //自动关闭输入流
            readerBuilder.autoCloseStream(true);
            //设置Excel文件格式
            readerBuilder.excelType(ExcelTypeEnum.XLSX);
            //注册监听器进行数据的解析
            readerBuilder.registerReadListener(new AnalysisEventListener<FactorLibrary.class> {
                /**
                   这里需要重写两个方法：
                       invoke 回调方法
                              一行数据读取完成之后的回调，即
                              读取一行数据就会进入回调函数当中，
                              这就是观察者模式
    
                       doAfterAllAnalysed  结束方法
                              当读取完最后一条数据后，会进入到此方法
                */
    
                //可以通过泛型制定数据类型，Map集合
                //如果泛型制定的是特定类型，需要在head()方法中指定
                //如readerBuilder.head(FactorLibrary.class);
                @Override
                public void invoke(FactorLibrary.class factorLi, AnalysisContext analysisContext) {
                    System.out.println(integerStringMap);  //每次读取到的数据，即表中的一行数据
                }
    
                @Override
                public void doAfterAllAnalysed(AnalysisContext analysisContext) {
                    //通知读取文件读取完毕
                    System.out.println("数据读取完毕");
                }
            });
    
            #2. 进行读取
            //以上是进行读取配置，下面开始真正的读取操作
            //构建读取器
            ExcelReader reader = readerBuilder.build();
            //读取数据
            reader.readAll();
            //读取完毕
            reader.finish();        
        }

实际开发中，可以对上述代码进行简化

public static void simpleRead(String path) {
            //直接读取,连着去写
            EasyExcel.read(path)
                    .head(FactorLibrary.class)       
                    .sheet("桥梁")
                    .registerReadListener(new AnalysisEventListener<FactorLibrary>() {
    
                        @Override
                        public void invoke(FactorLibrary factorLibrary, AnalysisContext analysisContext) {
                            System.out.println(factorLibrary);
                        }
    
                        @Override
                        public void doAfterAllAnalysed(AnalysisContext analysisContext) {
                            System.out.println("数据读取完毕");
                        }
                    }).doRead();
    }

@Data
    public class FactorLibrary {
    
        @ExcelProperty("电算代号")
        private String computerCode;
    
        @ExcelProperty("材料名称")
        private String materialName;
    
        @ExcelProperty("材料单位")
        private String materialUnit;
    
        @ExcelProperty("(原)材料种类")
        private String materialType;
    
        @ExcelProperty("碳排放因子")
        private String carbonEmissionFactor;
    
        @ExcelProperty("碳排放因子单位")
        private String carbonEmissionFactorUnit;
    
        @ExcelProperty("来源")
        private String origin;
    }

*  #### EasyExcel的写 ####

EasyExcel的读写操作格式几乎一致，这里写采用简单的格式作为实例

public static void simpleWrite(String path) {
            //要写入的数据，假设list有数据
            List<FactorLibrary> list = null;
            //list写入Excel文件
            EasyExcel.write("E:\\")
                    .head(FactorLibrary.class) //设置表头，不设置生成的excel表没有标题行，参数也可以是List
                    .excelType(ExcelTypeEnum.XLSX)
                    .sheet()
                    .doWrite(list);
    }

这就是EasyExcel的读写操作，是不是很简单？不要有任何畏惧，就这！

以上操作可以满足我们几乎所有需求。当然也会有一些复杂的操作，小伙伴们感兴趣可以深入学习

至于在实际开发中，随机应变，对症下药即可。

[a90f4e4d565b1b3e60763d1663d9d706.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/32fdff7e1509430eb9a510bce0fc9131.png
[a9aeea036c23e99e8523b792a8e5ceeb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/75601fc97ff64b8cbcf853e1ad4bcfb8.png