EasyExcel的基本使用及在项目中的应用

这里只是对EasyExcel的基本使用介绍，如果有需要可以根据自己的业务要求去官网查看更多的使用方法

官方网站（访问速度较慢）：

https://github.com/alibaba/easyexcel

---

快速开始（访问速度快文档清晰）：

https://www.yuque.com/easyexcel/doc/easyexcel

一、Excel导入导出

Excel导入导出的重要性

在针对运营商（移动、联通、电信、铁塔）的信息类的系统中，由于相关的从业人员习惯于Excel的办公思维。导致在做该类系统中时，Excel的导入导出功能，几乎成了每个有列表展示的页面上必备功能。因此，有必要对Excel导入导出功能进行了解。

Excel导入导出的应用场景

1、数据导入:减轻录入工作量

2、数据导出:统计信息归档

3、数据传输:异构系统之间数据传输

二、EasyExce的介绍

EasyExcel出现的背景

Java领域解析、生成Excel比较有名的框架有Apache poi、jxl等。
但他们都存在一个严重的问题就是非常的耗内存。如果你的系统并发量不大的话可能还行，但是一旦并发上来后一定会OOM或者JVM频繁的full gc。

EasyExcel的介绍

EasyExcel是阿里巴巴开源的一个excel处理框架，以使用简单、节省内存著称。EasyExcel能大大减少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中，而是从磁盘上一行行读取数据，逐个解析。

EasyExcel的工作模式

EasyExcel采用一行一行的解析模式，并将一行的解析结果以观察者的模式通知处理（AnalysisEventListener）。

三、EasyExce的简单写

1、创建一个普通的maven项目名为：alibaba-easyexcel

2、pom中引入xml相关依赖

<dependencies>

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

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>1.7.5</version>
    </dependency>

    <dependency>
        <groupId>org.apache.xmlbeans</groupId>
        <artifactId>xmlbeans</artifactId>
        <version>3.1.0</version>
    </dependency>

    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.12</version>
    </dependency>

    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>

</dependencies>

3、创建实体类

@Data
public class ExcelStudentDto {
    //指定列名
    @ExcelProperty(value = "学生姓名")
    private String name;
    @ExcelProperty(value = "学生生日")
    private Date birthday;
    @ExcelProperty(value = "学生薪水")
    private Double salary;
}

4、创建测试类

public class ExcelWriteTest {

    @Test
    public void TestSimpleWrite(){
        // 文件名 .xlsx扩展版后缀节省空间 xls老版本
        String fileName = "D:\\Excel\\simpleWrite.xlsx";
        // 这里 需要指定写用哪个class去写（就是封装的数据对象），
        // 然后写到第一个sheet，名字为模板 然后文件流会自动关闭
        // 如果这里想使用03版后缀为xls 则 传入excelType参数即可
        EasyExcel.write(fileName, ExcelStudentDto.class)
                .excelType(ExcelTypeEnum.XLSX)
                .sheet("模板")
                .doWrite(data());
        System.out.println("写入成功");
    }

    private List<ExcelStudentDto> data(){
        List<ExcelStudentDto> list = new ArrayList<>();
        //写入10条记入
        for (int i = 0; i < 11; i++) {
            ExcelStudentDto data = new ExcelStudentDto();
            data.setName("字符串"+i);
            data.setBirthday(new Date());
            data.setSalary(1001.1);
            list.add(data);
        }
        return list;
    }
}

5、测试结果

03版的excel写入

@Test
public void simpleWriteXls() {
    String fileName = "d:/excel/simpleWrite.xls";
    // 如果这里想使用03 则 传入excelType参数即可
    EasyExcel.write(fileName, ExcelStudentDTO.class)
    .excelType(ExcelTypeEnum.XLS)
    .sheet("模板").doWrite(data());
}

注意：

xls 版本的Excel最多一次可写0 …65535行
xlsx 版本的Excel最多一次可写0…1048575行

四、EasyExce的简单读

1、创建监听器

public class ExcelStudentDtoListener extends AnalysisEventListener<ExcelStudentDto> {

    //每条数据解析都会调用这个方法
    @Override
    public void invoke(ExcelStudentDto excelStudentDto, AnalysisContext analysisContext) {
        System.out.println("解析到一条记入："+excelStudentDto);
    }

    //所有的数据解析完成了会调用
    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {
        System.out.println("所有记入解析完成");
    }
}

2、测试

public class ExcelReadTest {
    @Test
    public void TestSimpleRead(){
        // 有个很重要的点 DemoDataListener 不能被spring管理，要每次读取excel都要new,然后里面用到spring可以构造方法传进去
        String fileName = "D:\\Excel\\simpleWrite.xlsx";
        // 这里 需要指定读用哪个class去读，然后读取第一个sheet 文件流会自动关闭
        EasyExcel.read(fileName, ExcelStudentDto.class, new ExcelStudentDtoListener()).sheet().doRead();
    }
}

3.测试结果

五、EasyExce的项目中的应用

需求分析

点击导出excel按钮 将数据字典从数据库导出到excel文件中，点击导入excel按钮 将excel文件导入到数据库中。

数据字典介绍

数据字典负责管理系统常用的分类数据或者一些固定数据，例如：省市区三级联动数据、民族数据、行业数据、学历数据等，数据字典帮助我们方便的获取和适用这些通用数据。

数据字典设计

parent_id：上级id，通过id与parent_id构建上下级关系，例如：我们要获取所有学历相关的数据，那么只需查询parent_id=30000的数据

name：名称，例如：填写用户信息，我们要select标签选择民族，“汉族”就是数据字典的名称

value：值，例如：填写用户信息，我们要select标签选择民族，“1”（汉族的标识）就是数据字典的值

dict_code：编码，编码是我们自定义的，全局唯一，例如：我们要获取行业数据，我们可以通过parent_id获取，但是parent_id是不确定的，所以我们可以根据编码来获取行业数据

导出excel的实现

1、实体类

@Data
public class DictEeVo {

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

	@ExcelProperty(value = "上级id" ,index = 1)
	private Long parentId;

	@ExcelProperty(value = "名称" ,index = 2)
	private String name;

	@ExcelProperty(value = "值" ,index = 3)
	private String value;

	@ExcelProperty(value = "编码" ,index = 4)
	private String dictCode;

}

2、controller层

 @ApiOperation("Excel数据的导出")
    @GetMapping("/exportData")
    public void export(HttpServletResponse response){

        try {
            response.setContentType("application/vnd.ms-excel");
            response.setCharacterEncoding("utf-8");
            
            // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
            String fileName = URLEncoder.encode("mydict", "UTF-8")
                    .replaceAll("\\+", "%20");
            response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");
            
            EasyExcel.write(response.getOutputStream(), DictEeVo.class)
                    .sheet("数据字典")
                    .doWrite(dictService.listDictData());

        } catch (IOException e) {
            //EXPORT_DATA_ERROR(104, "数据导出失败"),
            throw  new BusinessException(ResultCodeEnum.EXPORT_DATA_ERROR, e);
        }
    }

3、service层

@Override
    public List<DictEeVo> listDictData() {
        List<Dict> dicts = baseMapper.selectList(null);
        //创建ExcelDictDTO列表 将dict转换为ExcelDictDTO列表
        ArrayList<DictEeVo> list=new ArrayList<>(dicts.size());
        dicts.forEach(dict->{
            DictEeVo excelDictDTO = new DictEeVo();
            BeanUtils.copyProperties(dict,excelDictDTO);
            list.add(excelDictDTO);
        });
        return list;
    }

4、测试：数据成功导出

导入excel的实现

controller层

 @ApiOperation("excel数据的批量导入")
    @PostMapping("/importData")
    public Result batchImport(
            @ApiParam(value = "excel数据字典文件",required = true)
            @RequestParam("file") MultipartFile file){
        InputStream is = null;
        try {
            is = file.getInputStream();
            dictService.ImportData(is);

            return Result.ok().message("数据字典批量导入成功");
        } catch (Exception e) {
            throw new BusinessException( ResultCodeEnum.UPLOAD_ERROR,e);
        }

    }

mapper层

public interface DictMapper extends BaseMapper<Dict> {
    void insertBatch(List<DictEeVo> list);
}

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.yygh.dict.mapper.DictMapper">
    <insert id="insertBatch">
        insert into dict (
        id ,
        parent_id ,
        name ,
        value ,
        dict_code
        ) values
        <foreach collection="list" item="item" index="index" separator=",">
            (
            #{item.id} ,
            #{item.parentId} ,
            #{item.name} ,
            #{item.value} ,
            #{item.dictCode}
            )
        </foreach>
    </insert>
</mapper>

service层

 @Override
    public void ImportData(InputStream is) {
        EasyExcel.read(is, DictEeVo.class,new DictEeVoDTOListener(baseMapper)).sheet().doRead();
        log.info("excel导入成功");
    }

监听器

@Slf4j
public class DictEeVoDTOListener extends AnalysisEventListener<DictEeVo> {
    private DictMapper dictMapper;

    public DictEeVoDTOListener(DictMapper dictMapper) {
        this.dictMapper = dictMapper;
    }

    public DictEeVoDTOListener() {
    }


    //数据列表用于批量存入数据库
    List<DictEeVo> list=new ArrayList();
    //每100条数据批量存储一次
    public static final int BATCH_COUNT=100;
    @Override
    public void invoke(DictEeVo data, AnalysisContext analysisContext) {
      log.info("解析到一条数据：{}",data);
      list.add(data);
        if (list.size()>=BATCH_COUNT) {
            saveData();
            list.clear();
        }


    }

    private void saveData() {
        log.info("{}条被存储到数据库....",list.size());
        //调用mapper层的save方法把list对象批量插入到数据库
        dictMapper.insertBatch(list);
        log.info("{}条被存储到数据库成功....",list.size());
    }

    @Override
    public void doAfterAllAnalysed(AnalysisContext analysisContext) {

        //将不足BATCH_COUNT的数据时最终一次性存储到数据库
        saveData();
         log.info("解析完成");
    }
}

导入成功

页面展示