easyExcel

gyhwjy2024-07-22 12:06

easy Excel

EasyExcel官方文档 - 基于Java的Excel处理工具 | Easy Excel 官网

**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模式，在上层做了模型转换的封装，让使用者更加简单方便

完成写

  1. 导入依赖
xml 复制代码 
<!-- EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.1</version>
</dependency>
  1. 创建实体类
java 复制代码 
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    @ExcelProperty(value = "姓名", index = 0)
    private String name;
    @ExcelProperty(value = "年龄", index = 1)
    private Integer age;
    @ExcelProperty(value = "性别", index = 2)
    private String sex;
    @ExcelProperty(value = "地址", index = 3)
    private String address;
}
  1. 测试
java 复制代码 
@Test
    void write(){
        // 文件输出的路径
        String fileName = System.currentTimeMillis() + ".xlsx";
        // 这里 需要指定写用哪个class去写，然后写到第一个sheet，名字为模板 然后文件流会自动关闭
        List<Student> list = new ArrayList<>();
        list.add(new Student("张三丰", 25,"男","驻马店"));
        list.add(new Student("郭靖", 29,"男", "上蔡县"));
        list.add(new Student("蓉儿", 25,"女", "东洪镇"));
        list.add(new Student("云朵", 15,"女", "赵楼村"));
        EasyExcel.write(fileName, Student.class).sheet("学生信息").doWrite(list);

    }

web 的下载数据

  1. 依赖
xml 复制代码 
<!-- EasyExcel -->
<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>easyexcel</artifactId>
  <version>3.3.1</version>
</dependency>
  1. controller 层
java 复制代码 
@GetMapping("/download")
public void download(HttpServletResponse response) throws IOException {
    // 这里注意 有同学反应使用swagger 会导致各种问题，请直接用浏览器或者用postman
    response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
    response.setCharacterEncoding("utf-8");
    // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
    String fileName = URLEncoder.encode("测试", "UTF-8").replaceAll("\\+", "%20");
    response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");

    /*后面这些数据可以从数据库中查到*/
    List<Student> list = new ArrayList<>();
    list.add(new Student("张三丰", 25,"男","驻马店"));
    list.add(new Student("郭靖", 29,"男", "上蔡县"));
    list.add(new Student("蓉儿", 25,"女", "东洪镇"));
    list.add(new Student("云朵", 15,"女", "赵楼村"));

    EasyExcel.write(response.getOutputStream(), Student.class).sheet("模板").doWrite(list);
}
  1. 测试

http://localhost:8080/download 浏览器直接打开立马下载

读操作

  1. 导入依赖
xml 复制代码 
<!-- EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.1</version>
</dependency>
  1. 创建实体类
java 复制代码 
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    @ExcelProperty(value = "姓名", index = 0)
    private String name;
    @ExcelProperty(value = "年龄", index = 1)
    private Integer age;
    @ExcelProperty(value = "性别", index = 2)
    private String sex;
    @ExcelProperty(value = "地址", index = 3)
    private String address;
}
  1. 创建监听器
java 复制代码 
public class DemoDataListener implements ReadListener<Student> {

    /**
     * 每隔5条存储数据库，实际使用中可以100条，然后清理list ，方便内存回收
     */
    private static final int BATCH_COUNT = 100;
    /**
     * 缓存的数据
     */
    private List<Student> cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
    /**
     * 假设这个是一个DAO，当然有业务逻辑这个也可以是一个service。当然如果不用存储这个对象没用。
     */
    private final StudentDao studentDao;

    public DemoDataListener() {
        // 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
        studentDao = new StudentDao();
    }

    /**
     * 如果使用了spring,请使用这个构造方法。每次创建Listener的时候需要把spring管理的类传进来
     *
     * @param studentDao s
     */
    public DemoDataListener(StudentDao studentDao) {
        this.studentDao = studentDao;
    }

    /**
     * 这个每一条数据解析都会来调用
     */
    @Override
    public void invoke(Student student, AnalysisContext context) {
        cachedDataList.add(student);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (cachedDataList.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
        }
    }

    /**
     * 所有数据解析完成了 都会来调用
     *
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据，确保最后遗留的数据也存储到数据库
        saveData();
        System.out.println("所有数据解析完成！");
    }

    /**
     * 加上存储数据库
     */
    private void saveData() {
        System.out.println("{"+cachedDataList.size()+"}条数据，开始存储数据库！");
        studentDao.save(cachedDataList);
        System.out.println("存储数据库成功！");
    }
}

:::tips
监听器：

  • 由于这里的监听器类并未交给 spring 管理因此上面的 StudenDao不能通过自动注入的方式来直接写，这里采用构造器的方式注入。
  • 这里调用的方法，后面真正调用时就直接存入到数据库了，（最好采用批量添加的方式）
    :::
  1. StudentDao
java 复制代码 
@Repository
public class StudentDao {
    public void save(List<Student> students) {
        // 我们这里测试先打印出来，后面可以直接添加到数据库
        students.forEach(System.out::println);
        System.out.println("保存成功");
    }
}
  1. 测试
java 复制代码 
@Test
    void read() throws UnsupportedEncodingException, FileNotFoundException {
        // 文件的绝对路径
        String fileName = "D:\\IdeaProjects\\easyExcel\\easyExcel\\AAA1721460305714.xlsx";
        // 这里默认读取第一个sheet
        EasyExcel.read(fileName, Student.class, new DemoDataListener()).sheet().doRead();
    }

读操作 web

  1. 引入依赖
xml 复制代码 
<!-- EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.3.1</version>
</dependency>
<!-- 文件上传依赖 -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>
  1. 创建实体类
java 复制代码 
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Student {
    @ExcelProperty(value = "姓名", index = 0)
    private String name;
    @ExcelProperty(value = "年龄", index = 1)
    private Integer age;
    @ExcelProperty(value = "性别", index = 2)
    private String sex;
    @ExcelProperty(value = "地址", index = 3)
    private String address;
}
  1. 创建监听器
java 复制代码 
public class DemoDataListener implements ReadListener<Student> {

    /**
     * 每隔5条存储数据库，实际使用中可以100条，然后清理list ，方便内存回收
     */
    private static final int BATCH_COUNT = 100;
    /**
     * 缓存的数据
     */
    private List<Student> cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
    /**
     * 假设这个是一个DAO，当然有业务逻辑这个也可以是一个service。当然如果不用存储这个对象没用。
     */
    private final StudentDao studentDao;

    public DemoDataListener() {
        // 这里是demo，所以随便new一个。实际使用如果到了spring,请使用下面的有参构造函数
        studentDao = new StudentDao();
    }

    /**
     * 如果使用了spring,请使用这个构造方法。每次创建Listener的时候需要把spring管理的类传进来
     *
     * @param studentDao s
     */
    public DemoDataListener(StudentDao studentDao) {
        this.studentDao = studentDao;
    }

    /**
     * 这个每一条数据解析都会来调用
     */
    @Override
    public void invoke(Student student, AnalysisContext context) {
        cachedDataList.add(student);
        // 达到BATCH_COUNT了，需要去存储一次数据库，防止数据几万条数据在内存，容易OOM
        if (cachedDataList.size() >= BATCH_COUNT) {
            saveData();
            // 存储完成清理 list
            cachedDataList = ListUtils.newArrayListWithExpectedSize(BATCH_COUNT);
        }
    }

    /**
     * 所有数据解析完成了 都会来调用
     *
     */
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里也要保存数据，确保最后遗留的数据也存储到数据库
        saveData();
        System.out.println("所有数据解析完成！");
    }

    /**
     * 加上存储数据库
     */
    private void saveData() {
        System.out.println("{"+cachedDataList.size()+"}条数据，开始存储数据库！");
        studentDao.save(cachedDataList);
        System.out.println("存储数据库成功！");
    }
}

:::tips
监听器：

  • 由于这里的监听器类并未交给 spring 管理因此上面的 StudenDao不能通过自动注入的方式来直接写，这里采用构造器的方式注入。
  • 这里调用的方法，后面真正调用时就直接存入到数据库了，（最好采用批量添加的方式）
    :::
  1. StudentDao
java 复制代码 
@Repository
public class StudentDao {
    public void save(List<Student> students) {
        // 我们这里测试先打印出来，后面可以直接添加到数据库
        students.forEach(System.out::println);
        System.out.println("保存成功");
    }
}
  1. controller 层
java 复制代码 
@Autowired
    private StudentDao studentDao;

    @ResponseBody
    @PostMapping("/upload")
    public String upload(MultipartFile file) throws IOException {
        EasyExcel.read(file.getInputStream(), Student.class, new DemoDataListener(studentDao)).sheet().doRead();
        return "success";
    }
  1. 这里的测试需要借助 **Apipost**** 或 ****postman**

:::tips
这里的参数名和类型都要选择正确，否者就会报空指针异常

:::

相关推荐
itzixiao7 分钟前
L1-067 洛希极限（10分）[java][python]
java·开发语言·算法
java1234_小锋14 分钟前
Spring AI 2.0 开发Java Agent智能体 - Spring AI项目调用本地Ollama模型
java·人工智能·spring·spring ai2.0
二哈赛车手14 分钟前
新人笔记---多策略搭建策略执行链实现RAG检索后过滤
java·笔记·spring·设计模式·ai·策略模式
PESS ABIN15 分钟前
JavaWeb项目打包、部署至Tomcat并启动的全程指南（图文详解）
java·tomcat
AI进化营-智能译站21 分钟前
ROS2 C++开发系列15-模板实现通用算法｜宏定义ROS2调试开关｜一次编码适配多平台
java·c++·算法·ai
刀法如飞24 分钟前
Java数组去重的20种实现方式——指导AI解决不同问题的思路
java·算法·面试
薪火铺子33 分钟前
SpringMVC请求处理流程源码解析（第1篇）：请求入口与处理器映射
java·后端·spring
ch.ju33 分钟前
Java程序设计(第3版)第二章——参数(实参 形参)
java
椰猫子35 分钟前
SpringMVC（SpringMVC简介、请求与响应（请求映射路径、请求参数、日期类型参数传递、响应json数据））
java·前端·数据库
海兰37 分钟前
【开篇】Spring AI、OpenClaw 和Hermes
java·人工智能·spring·spring ai
热门推荐
01要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法02GitHub 镜像站点03【AI】2026 年具身智能模型和世界模型总结04裂开！ChatGPT 居然开始要手机号验证，附详细解决方法05Codex 接入 DeepSeek API 完整配置文档062026年AI前瞻：量子AI、具身智能与科学发现的新纪元07零基础教你claude code 接入 deepseek V408在Windows 11上安装Docker的踩坑记录09实测可用｜小米 MiMo 百万亿 Token 免费领，开发者速冲102026年4月AI大事件深度解读：大模型竞争进入“深水区“