JAVA解析Excel工具EasyExcel

Posted 2022-08-12 傲骄鹿先生

我是傲骄鹿先生，沉淀、学习、分享、成长。

如果你觉得文章内容还可以的话，希望不吝您的「一键三连」，文章里面有不足的地方希望各位在评论区补充疑惑、见解以及面试中遇到的奇葩问法

目录

64M内存20秒读取75M(46W行25列)的Excel（3.0.2+版本）

一、创建项目

1、创建一个普通的maven项目

2、pom中引入xml相关依赖

二、最简单的写

1、创建实体类

2、测试用例

三、指定写入列

四、自定义格式转换

 五、最简单的读

1、创建监听器

2、测试用例

Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是非常的耗内存，poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题，但POI还是有一些缺陷，比如07版Excel解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大。easyexcel重写了poi对07版Excel的解析，一个3M的excel用POI sax解析依然需要100M左右内存，改用easyexcel可以降低到几M，并且再大的excel也不会出现内存溢出；03版依赖POI的sax模式，在上层做了模型转换的封装，让使用者更加简单方便

64M内存20秒读取75M(46W行25列)的Excel（3.0.2+版本）

最新版本

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

一、创建项目

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.10</version>
    </dependency>

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

</dependencies>

二、最简单的写

1、创建实体类

@Data
public class ExcelStudentData 

    @ExcelProperty("姓名")
    private String name;

    @ExcelProperty("生日")
    private Date birthday;

    @ExcelProperty("薪资")
    private Double salary;

    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String password;

2、测试用例

• 07版本的Excel和03版本的写入方式有所不同
• 03版本的Excel写入最多一次可写65536行

public class ExcelWriteTest 

    /**
     * 最简单的写
     */
    @Test
    public void simpleWrite07() 

        String fileName = "d:/excel/01-simpleWrite-07.xlsx";
        // 这里 需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭
        EasyExcel.write(fileName, ExcelStudentData.class).sheet("模板").doWrite(data());
    

    @Test
    public void simpleWrite03() 

        String fileName = "d:/excel/01-simpleWrite-03.xls";
        // 如果这里想使用03 则 传入excelType参数即可
        EasyExcel.write(fileName, ExcelStudentData.class).excelType(ExcelTypeEnum.XLS).sheet("模板").doWrite(data());
    

    private List<ExcelStudentData> data()
        List<ExcelStudentData> list = new ArrayList<>();

        //算上标题，做多可写65536行
        //超出：java.lang.IllegalArgumentException: Invalid row number (65536) outside allowable range (0..65535)
        for (int i = 0; i < 65535; i++) 
            ExcelStudentData data = new ExcelStudentData();
            data.setName("Helen" + i);
            data.setBirthday(new Date());
            data.setSalary(0.56);
            data.setPassword("123"); //即使设置也不会被导出
            list.add(data);
        

        return list;
    

注：需要在文件存储的位置先创建文件夹

三、指定写入列

为列配置 index 属性

@Data
public class ExcelStudentData 

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

    @ExcelProperty(value = "生日", index = 1)
    private Date birthday;

    /**
     * 这里设置3 会导致第二列空的
     */
    @ExcelProperty(value = "薪资", index = 3)
    private Double salary;

    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String password;

四、自定义格式转换

配置@DateTimeFormat 和 @NumberFormat

@Data
public class ExcelStudentData 

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

    @DateTimeFormat("yyyy年MM月dd日HH时mm分ss秒")
    @ExcelProperty(value = "生日")
    private Date birthday;

    @NumberFormat("#.##%")//百分比表示，保留两位小数
    @ExcelProperty(value = "薪资")
    private Double salary;

    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String password;

运行结果：算上标题，最多可以写65536行，超过时会报错。

 五、最简单的读

1、创建监听器

@Slf4j
public class ExcelStudentDataListener extends AnalysisEventListener<ExcelStudentData> 

    /**
     * 每隔5条存储数据库，实际使用中可以3000条，然后清理list ，方便内存回收
     */
    private static final int BATCH_COUNT = 5;
    List<ExcelStudentData> list = new ArrayList<>();

    /**
     * 这个每一条数据解析都会来调用
     *
     * @param data
     *            one row value. Is is same as @link AnalysisContext#readRowHolder()
     * @param context
     */
    @Override
    public void invoke(ExcelStudentData data, AnalysisContext context) 
        log.info("解析到一条数据:", data);
        list.add(data);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (list.size() >= BATCH_COUNT) 
            log.info("存数据库");
            // 存储完成清理 list
            list.clear();
        
    

    /**
     * 所有数据解析完成了 都会来调用
     *
     * @param context
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) 

        log.info("所有数据解析完成！");
    

2、测试用例

public class ExcelReadTest 

    /**
     * 最简单的读
     */
    @Test
    public void simpleRead07() 

        String fileName = "d:/excel/01-simpleWrite-07.xlsx";
        // 这里默认读取第一个sheet
        EasyExcel.read(fileName, ExcelStudentData.class, new ExcelStudentDataListener()).sheet().doRead();
    
    
    @Test
    public void simpleRead03() 

        String fileName = "d:/excel/01-simpleWrite-03.xls";
        // 这里默认读取第一个sheet
        EasyExcel.read(fileName, ExcelStudentData.class, new ExcelStudentDataListener()).excelType(ExcelTypeEnum.XLS).sheet().doRead();
    

测试结果：

参考资料：读Excel（文档已经迁移） · 语雀

系列文章持续更新，微信搜一搜「傲骄鹿先生 」，回复【面试】有准备的一线大厂面试资料。