Java使用EasyExcel操作读写excel方式

更新时间：2025年05月23日 09:30:56 作者：水星国王

这篇文章主要介绍了Java使用EasyExcel操作读写excel方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

前言

EasyExcel是一个基于Java的、快速、简洁、解决大文件内存溢出的Excel处理工具。

他能让你在不用考虑性能、内存的等因素的情况下，快速完成Excel的读、写等功能。

EasyExcel基于POI进行封装优化，降低内存使用，再大的excel也不会出现内存溢出，让使用更加简单方便。

官网： https://easyexcel.opensource.alibaba.com/
github: https://github.com/alibaba/easyexcel

特点：阿里巴巴开源的工具，代码简化，占用内存少，优化OOM(内存溢出异常)

引入EasyExcel依赖

<!--easyExcel依赖-->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.2.0-beta2</version>
</dependency>

easyExcel写

准备一个实体类因为easyexcel根据实体类自动生成的表效率非常的高

package com.wyh.entity;

import com.alibaba.excel.annotation.ExcelIgnore;
import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

import java.util.Date;

/**
 * @program: JavaExecl
 * @description: easyExcel实体类 可以用它生成excel
 * @author: 魏一鹤
 * @createDate: 2021-12-18 23:03
 **/
@Data
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String ignore;
}

它对应生成的就是这样

写一个基本的写入操作

  
//根据list写入excel
@Test
public void simpleWrite() {
    // 写法1 JDK8+
    // since: 3.0.0-beta1
    //生成的文件名和文件所在位置
    String fileName =path+"easyExcel.xlsx";
    //开始写入 这里说下几个参数
    //1 fileName 是一个io流 自动生成excel
    //2 DemoData.class根据哪个类的规则去生成excel
    //3 sheetName 生成的表的名字
    //4 进行写出,写入到规则就是我们上面定义的方法循环
    EasyExcel.write(fileName,DemoData.class).sheet("模板").doWrite(data());
}

完整的代码

package com.wyh.Test;

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.ExcelWriter;
import com.alibaba.excel.write.metadata.WriteSheet;
import com.wyh.entity.DemoData;
import org.apache.commons.collections4.ListUtils;
import org.junit.Test;

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

/**
 * @program: JavaExecl
 * @description: easyExcel写操作
 * @author: 魏一鹤
 * @createDate: 2021-12-18 23:08
 **/

public class EasyExcelWrite {
    //全局路径,供我们操作使用方便
    static String path="D:\\Tools\\JavaWorkSpace\\JavaExecl\\";
    private List<DemoData> data() {
        List<DemoData> list = new ArrayList<DemoData>();
        for (int i = 0; i < 10; i++) {
            DemoData data = new DemoData();
            data.setString("字符串" + i);
            data.setDate(new Date());
            data.setDoubleData(0.56);
            list.add(data);
        }
        return list;
    }
    //根据list写入excel
    @Test
    public void simpleWrite() {
        // 写法1 JDK8+
        // since: 3.0.0-beta1
        //生成的文件名和文件所在位置
        String fileName =path+"easyExcel.xlsx";
        //开始写入 这里说下几个参数
        //1 fileName 是一个io流 自动生成excel
        //2 DemoData.class根据哪个类的规则去生成excel
        //3 sheetName 生成的表的名字
        //4 进行写出,写入到规则就是我们上面定义的方法循环
        EasyExcel.write(fileName,DemoData.class).sheet("模板").doWrite(data());
    }
}

运行完毕之后发现已经生成了，而且和我们想要的数据格式是一样的

easyExcel读

需要一个实体,我们已经有了,可以直接用上面的DemoData

package com.wyh.entity;

import com.alibaba.excel.annotation.ExcelIgnore;
import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

import java.util.Date;

/**
 * @program: JavaExecl
 * @description: easyExcel实体类 可以用它生成excel
 * @author: 魏一鹤
 * @createDate: 2021-12-18 23:03
 **/
@Data
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String ignore;
}

需要一个监听器

package com.wyh.Test;

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import com.alibaba.excel.metadata.CellData;
import com.alibaba.excel.metadata.CellExtra;
import com.alibaba.excel.read.listener.ReadListener;
import com.alibaba.fastjson.JSON;
import com.wyh.entity.DemoData;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.collections4.ListUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

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

/**
 * @program: JavaExecl
 * @description: easyExcel监听器
 * @author: 魏一鹤
 * @createDate: 2021-12-18 23:30
 **/
// 有个很重要的点 DemoDataListener 不能被spring管理，要每次读取excel都要new,然后里面用到spring可以构造方法传进去
public class DemoDataListener extends AnalysisEventListener<DemoData> {

    private static final Logger LOGGER = LoggerFactory.getLogger(DemoDataListener.class);
    /**
     * 每隔5条存储数据库，实际使用中可以3000条，然后清理list ，方便内存回收
     */
    private static final int BATCH_COUNT = 5;
    List<DemoData> list = new ArrayList<DemoData>();
    /**
     * 假设这个是一个DAO，当然有业务逻辑这个也可以是一个service。当然如果不用存储这个对象没用。
     */
    private DemoDAO demoDAO;
    public DemoDataListener() {
        // 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
        demoDAO = new DemoDAO();
    }
    /**
     * 如果使用了spring,请使用这个构造方法。每次创建Listener的时候需要把spring管理的类传进来
     *
     * @param demoDAO
     */
    public DemoDataListener(DemoDAO demoDAO) {
        this.demoDAO = demoDAO;
    }
    /**
     * 这个每一条数据解析都会来调用
     *
     * @param data
     *            one row value. Is is same as {@link AnalysisContext#readRowHolder()}
     * @param context
     */
    @Override
    public void invoke(DemoData data, AnalysisContext context) {
        System.out.println(JSON.toJSONString(data));
        list.add(data);
        System.out.println(list);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (list.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            list.clear();
        }
    }
    /**
     * 所有数据解析完成了 都会来调用
     *
     * @param context
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据，确保最后遗留的数据也存储到数据库
        saveData();
        LOGGER.info("所有数据解析完成！");
    }
    /**
     * 加上存储数据库
     */
    private void saveData() {
        demoDAO.save(list);
    }
}

然后写一个基本的读操作

package com.wyh.Test;

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.ExcelReader;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.read.listener.ReadListener;
import com.alibaba.excel.read.metadata.ReadSheet;
import com.alibaba.fastjson.JSON;
import com.wyh.entity.DemoData;
import org.apache.commons.collections4.ListUtils;
import org.junit.Test;

import java.io.File;
import java.util.List;

/**
 * @program: JavaExecl
 * @description: excel读数据
 * @author: 魏一鹤
 * @createDate: 2021-12-18 23:38
 **/

public class EasyExcelRead {

    //全局路径,供我们操作使用方便
    static String path="D:\\Tools\\JavaWorkSpace\\JavaExecl\\";
    @Test
    public void simpleRead() {
        //文件路径
        String fileName = path + "easyExcel.xlsx";
        //重点注意监听器读取的逻辑
        //fileName 文件
        //DemoData 类规则
        //DemoDataListener 监听器
        //sheet().doRead() 表的读取
        EasyExcel.read(fileName,DemoData.class,new DemoDataListener()).sheet().doRead();


    }

}

启动发现全部数据被正常读取到

总结下easyExcel的步骤和要点

1 写入根据固定的类格式进行写入

2 读取根据监听器设置规则进行读取

要点：尽量提前准备好模板

最后

EasyExcel真的比POI要强大太多，先不说防止OOM,就代码量，前者就已经赢太多了

本次只是带来了Java简单操作EasyExcel入门案例，也是官方的一个demo

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

Spring事务失效的一种原因关于this调用的问题
这篇文章主要介绍了Spring事务失效的一种原因关于this调用的问题,本文给大家分享问题原因及解决办法，通过实例代码给大家介绍的非常详细，需要的朋友可以参考下
2021-10-10
SpringBoot+Redis执行lua脚本的方法步骤
这篇文章主要介绍了SpringBoot+Redis执行lua脚本的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-11-11
springboot手动动态注入controller和service方式
这篇文章主要介绍了springboot手动动态注入controller和service方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-03-03
Java接口和抽象类实现抽象和多态的方法示例
接口和抽象类是 Java 中两种实现抽象和多态的方法。它们之间有一些区别，但也有一些相似之处。这一节我们将通过详细的例子来更深入地了解接口和抽象类
2023-05-05
Springboot如何使用Map将错误提示输出到页面
这篇文章主要介绍了Springboot如何使用Map将错误提示输出到页面,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-08-08
Java代码编译和反编译的那些事儿
这篇文章主要给大家介绍了关于Java代码编译和反编译的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用Java具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
详解Servlet3.0新特性（从注解配置到websocket编程）
Servlet3.0的出现是servlet史上最大的变革，其中的许多新特性大大的简化了web应用的开发，为广大劳苦的程序员减轻了压力，提高了web开发的效率。
2017-04-04
springboot配置Jackson返回统一默认值的实现示例
在项目开发中，我们返回的数据或者对象没有的时候一般直接返回的null，那么如何返回统一默认值，感兴趣的可以了解一下
2021-07-07
Java判断是否为简体中文字符的实现方法
在应用开发中,判断简体中文字符是一个重要但常被忽视的任务,简体中文和繁体中文在字符上有显著的区别,因此在某些场景下我们需要判断输入的文本是否为简体中文,本文将介绍如何使用Java进行此判断,并提供相应的代码示例,帮助开发者更好地理解这一过程
2024-09-09
Java高级语法学习之反射详解
java的泛型和反射机制一直很难理解和应用,下面这篇文章主要给大家介绍了关于Java高级语法学习之反射的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-01-01