EasyExcel的简介和入门案例

技术点 Easy Excel

EasyExcel简介

官网地址：https://easyexcel.opensource.alibaba.com/

EasyExcel 的主要特点如下：

1、高性能：EasyExcel 采用了异步导入导出的方式，并且底层使用 NIO 技术实现，使得其在导入导出大数据量时的性能非常高效。

2、易于使用：EasyExcel 提供了简单易用的 API，用户可以通过少量的代码即可实现复杂的 Excel 导入导出操作。

3、增强的功能“EasyExcel 支持多种格式的 Excel 文件导入导出，同时还提供了诸如合并单元格、数据校验、自定义样式等增强的功能。

4、可扩展性好：EasyExcel 具有良好的扩展性，用户可以通过自定义 Converter 对自定义类型进行转换，或者通过继承 EasyExcelListener 来自定义监听器实现更加灵活的需求。

数据导入导出意义

后台管理系统是管理、处理企业业务数据的重要工具，在这样的系统中，数据的导入和导出功能是非常重要的，其主要意义包括以下几个方面：

1、提高数据操作效率：手动逐条添加或修改数据不仅费时费力，而且容易出错，此时就可以将大量数据从Excel等表格软件中导入到系统中时，通过数据导入功能，可以直接将表格中的数据批量导入到系统中，提高了数据操作的效率。

2、实现数据备份与迁移：通过数据导出功能，管理员可以将系统中的数据导出为 Excel 或其他格式的文件，以实现数据备份，避免数据丢失。同时，也可以将导出的数据文件用于数据迁移或其他用途。

3、方便企业内部协作：不同部门可能会使用不同的系统或工具进行数据处理，在这种情况下，通过数据导入和导出功能，可以方便地转换和共享数据，促进企业内部协作。

入门案例

1.读取Excel数据

需求：对excel数据进行解析，将其存储到对应的List集合中，并遍历List集合

步骤：

1、在pom.xml文件中添加如下依赖：

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

2、定义一个实体类来封装每一行的数据，如下所示：

package com.zmq.spzx.model.vo.product;

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

/**
 * 测试EasyExcel的使用
 * Author: zmq
 * Date: 2024/3/4
 */
@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestExcelVo {

    @ExcelProperty(value = "id",index = 0)
    private Long id;

    @ExcelProperty(value = "姓名",index= 1)
    private String name;

    @ExcelProperty(value = "年龄", index = 2)
    private Integer age;



}

3、定义一个监听器，监听解析到的数据，如下所示：

package com.zmq.spzx.manager.test;

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;

import java.util.ArrayList;
import java.util.List;

/**
 * 定义EasyExcel的监听器，监听解析到的数据
 * Author: zmq
 * Date: 2024/3/4
 */
public class ExcelListener<T> extends AnalysisEventListener<T> {

    //可以通过实例获取该值
    private List<T> datas=new ArrayList<>();


    //每解析一行数据就会调用一次该方法
    @Override
    public void invoke(T t, AnalysisContext analysisContext) {
        //数据存储到list，供批量处理，或后续自己业务逻辑处理
        datas.add(t);
    }

    public List<T> getDatas(){
        return datas;
    }


    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
       //Excel解析完毕以后需要执行的代码
    }
}

4、编写测试方法

package com.zmq.spzx.manager.test;

import com.alibaba.excel.EasyExcel;
import com.zmq.spzx.model.vo.product.TestExcelVo;

import java.util.List;

/**
 * EasyExcel的测试类
 * Author: zmq
 * Date: 2024/3/4
 */
public class EasyExcelTest {

    public static void main(String[] args) {
        readDataExcel();
    }

    //读取Excel中的数据
    public static void readDataExcel(){
        String fileName = "E://ExcelTest.xlsx";
        //创建一个监听器对象
        ExcelListener<TestExcelVo> excelListener = new ExcelListener<>();
        //调用EasyExcel的api解析Excel
        EasyExcel.read(fileName, TestExcelVo.class,excelListener).sheet().doRead();
        //获取解析到的数据
        List<TestExcelVo> excelVoList = excelListener.getDatas();
        //遍历输出解析到数据
        excelVoList.forEach(s->{
            System.out.println(s);
        });
    }
}

读取成功

2.添加数据到Excel

需求：将如下的集合数据存储到Excel中文件中

List<TestExcelVo> list = new ArrayList<>();
        list.add(new TestExcelVo(1L,"小明",18));
        list.add(new TestExcelVo(2L,"小红",19));

代码实现：

 public static void main(String[] args) {
        //readDataExcel();
        //添加数据到Excel文件中
        writeDataToExcel();
    }

    //构造好集合 写入到Excel表中
    private static void writeDataToExcel() {
        List<TestExcelVo> list = new ArrayList<>();
        list.add(new TestExcelVo(1L,"小明",18));
        list.add(new TestExcelVo(2L,"小红",19));
        EasyExcel.write("E://ExcelTest.xlsx", TestExcelVo.class).sheet("数据").doWrite(list);

    }

写入成功