EasyExcel使用

于 2025-05-23 23:16:53 发布
阅读量358 收藏 3
点赞数 8
文章标签： EasyExcel java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hqxstudying/article/details/148177732
版权

EasyExcel 简介

EasyExcel 是阿里巴巴开源的一个基于 Java 的简单、省内存的读写 Excel 工具。在处理大量数据时，它能极大地减少内存占用，提高性能。下面从依赖配置、模板使用到代码调用，进行详细介绍。

添加依赖

若要在项目里使用 EasyExcel，需在 Maven 或 Gradle 配置文件中添加相应依赖。

Maven 依赖：

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

创建数据模型

要映射 Excel 中的数据，需创建对应的 Java 类。通过注解可指定列的索引和标题。

import com.alibaba.excel.annotation.ExcelProperty;

public class DemoData {
    // 索引为 0，列标题是 "字符串"
    @ExcelProperty(index = 0, value = "字符串")
    private String string;

    // 索引为 1，列标题是 "日期"
    @ExcelProperty(index = 1, value = "日期")
    private Date date;

    // 索引为 2，列标题是 "数字"
    @ExcelProperty(index = 2, value = "数字")
    private Double doubleData;

    // 若有复杂的表头，可以使用如下方式
    @ExcelProperty({"主标题", "子标题"})
    private String complexHead;

    // 构造函数、Getter 和 Setter 方法
    public DemoData() {
    }

    public DemoData(String string, Date date, Double doubleData) {
        this.string = string;
        this.date = date;
        this.doubleData = doubleData;
    }

    // Getter 和 Setter 方法
    public String getString() {
        return string;
    }

    public void setString(String string) {
        this.string = string;
    }

    public Date getDate() {
        return date;
    }

    public void setDate(Date date) {
        this.date = date;
    }

    public Double getDoubleData() {
        return doubleData;
    }

    public void setDoubleData(Double doubleData) {
        this.doubleData = doubleData;
    }

    public String getComplexHead() {
        return complexHead;
    }

    public void setComplexHead(String complexHead) {
        this.complexHead = complexHead;
    }
}

读取 Excel 文件

EasyExcel 提供了多种读取 Excel 的方式，下面是一个基本示例。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import com.alibaba.excel.read.builder.ExcelReaderBuilder;
import com.alibaba.excel.read.builder.ExcelReaderSheetBuilder;

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

public class ExcelReaderExample {

    public static void main(String[] args) {
        // 要读取的 Excel 文件路径
        String fileName = "D:\\test.xlsx";

        // 方法一：读取数据并处理
        EasyExcel.read(fileName, DemoData.class, new DemoDataListener()).sheet().doRead();

        // 方法二：读取数据并返回列表
        List<DemoData> dataList = EasyExcel.read(fileName)
                .head(DemoData.class)
                .sheet()
                .doReadSync();
        System.out.println("读取的数据量: " + dataList.size());

        // 方法三：链式调用读取
        ExcelReaderBuilder readerBuilder = EasyExcel.read(fileName, DemoData.class, new DemoDataListener());
        ExcelReaderSheetBuilder sheetBuilder = readerBuilder.sheet();
        sheetBuilder.doRead();
    }

    // 监听器类，用于处理读取到的数据
    public static class DemoDataListener extends AnalysisEventListener<DemoData> {
        private static final int BATCH_COUNT = 100;
        private List<DemoData> list = new ArrayList<>(BATCH_COUNT);

        // 每读取一行数据时调用
        @Override
        public void invoke(DemoData data, AnalysisContext context) {
            System.out.println("读取到数据: " + data);
            list.add(data);
            if (list.size() >= BATCH_COUNT) {
                saveData();
                list.clear();
            }
        }

        // 读取完成后调用
        @Override
        public void doAfterAllAnalysed(AnalysisContext context) {
            saveData();
            System.out.println("所有数据读取完成！");
        }

        // 保存数据的方法
        private void saveData() {
            System.out.println("当前批次保存 " + list.size() + " 条数据");
            // 这里可以添加保存数据到数据库等操作
        }
    }
}

写入 Excel 文件

下面是使用 EasyExcel 将数据写入 Excel 文件的几种常见方法。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.write.builder.ExcelWriterBuilder;
import com.alibaba.excel.write.builder.ExcelWriterSheetBuilder;

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

public class ExcelWriterExample {

    public static void main(String[] args) {
        // 写入文件的路径
        String fileName = "D:\\write.xlsx";

        // 方法一：直接写入数据
        writeExcelDirectly(fileName);

        // 方法二：使用构建器写入
        writeExcelWithBuilder(fileName);

        // 方法三：写入多个 sheet
        writeMultipleSheets(fileName);
    }

    // 方法一：直接写入数据
    private static void writeExcelDirectly(String fileName) {
        // 创建测试数据
        List<DemoData> dataList = createTestData();

        // 直接写入数据
        EasyExcel.write(fileName, DemoData.class).sheet("模板").doWrite(dataList);
    }

    // 方法二：使用构建器写入
    private static void writeExcelWithBuilder(String fileName) {
        // 创建测试数据
        List<DemoData> dataList = createTestData();

        // 使用构建器写入
        ExcelWriterBuilder writerBuilder = EasyExcel.write(fileName, DemoData.class);
        ExcelWriterSheetBuilder sheetBuilder = writerBuilder.sheet("模板");
        sheetBuilder.doWrite(dataList);
    }

    // 方法三：写入多个 sheet
    private static void writeMultipleSheets(String fileName) {
        // 创建测试数据
        List<DemoData> dataList1 = createTestData();
        List<DemoData> dataList2 = createTestData();

        // 写入多个 sheet
        try (ExcelWriterBuilder writerBuilder = EasyExcel.write(fileName, DemoData.class)) {
            // 第一个 sheet
            writerBuilder.sheet("第一个 sheet").doWrite(dataList1);
            // 第二个 sheet
            writerBuilder.sheet("第二个 sheet").doWrite(dataList2);
        }
    }

    // 创建测试数据
    private static List<DemoData> createTestData() {
        List<DemoData> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            DemoData data = new DemoData();
            data.setString("字符串" + i);
            data.setDate(new Date());
            data.setDoubleData(0.56 + i);
            list.add(data);
        }
        return list;
    }
}

使用模板导出 Excel

若需要使用模板导出 Excel，可按以下方式操作。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.write.builder.ExcelWriterSheetBuilder;
import com.alibaba.excel.write.metadata.WriteSheet;

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

public class ExcelTemplateExample {

    public static void main(String[] args) {
        // 模板文件路径
        String templateFileName = "D:\\template.xlsx";
        // 输出文件路径
        String outputFileName = "D:\\template_output.xlsx";

        // 填充数据并导出
        fillTemplateAndExport(templateFileName, outputFileName);
    }

    private static void fillTemplateAndExport(String templateFileName, String outputFileName) {
        // 创建填充数据
        Map<String, Object> data = new HashMap<>();
        data.put("name", "张三");
        data.put("date", "2023-01-01");
        data.put("total", 1000.00);

        // 创建列表数据
        List<Map<String, Object>> list = new ArrayList<>();
        for (int i = 0; i < 5; i++) {
            Map<String, Object> item = new HashMap<>();
            item.put("line", i + 1);
            item.put("description", "项目" + i);
            item.put("amount", 100.00 + i);
            list.add(item);
        }
        data.put("list", list);

        // 使用模板填充数据
        EasyExcel.write(outputFileName)
                .withTemplate(templateFileName)
                .sheet()
                .doFill(data);
    }
}

处理复杂表头和合并单元格

对于复杂表头和合并单元格的情况，EasyExcel 也能很好地处理。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.write.merge.LoopMergeStrategy;

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

public class ComplexHeadExample {

    public static void main(String[] args) {
        // 输出文件路径
        String fileName = "D:\\complex_head.xlsx";

        // 创建测试数据
        List<ComplexHeadData> dataList = createComplexHeadData();

        // 写入复杂表头的 Excel
        // 每 2 行合并一次
        LoopMergeStrategy mergeStrategy = new LoopMergeStrategy(2, 0);

        EasyExcel.write(fileName, ComplexHeadData.class)
                .registerWriteHandler(mergeStrategy)
                .sheet("复杂表头")
                .doWrite(dataList);
    }

    private static List<ComplexHeadData> createComplexHeadData() {
        List<ComplexHeadData> list = new ArrayList<>();
        for (int i = 0; i < 4; i++) {
            ComplexHeadData data = new ComplexHeadData();
            data.setHead1("头部1-" + i);
            data.setHead2("头部2-" + i);
            data.setHead3("头部3-" + i);
            data.setHead4("头部4-" + i);
            list.add(data);
        }
        return list;
    }

    // 复杂表头的数据模型
    public static class ComplexHeadData {
        @ExcelProperty({"主标题", "一级标题1", "二级标题1"})
        private String head1;

        @ExcelProperty({"主标题", "一级标题1", "二级标题2"})
        private String head2;

        @ExcelProperty({"主标题", "一级标题2", "二级标题3"})
        private String head3;

        @ExcelProperty({"主标题", "一级标题2", "二级标题4"})
        private String head4;

        // Getter 和 Setter 方法
        public String getHead1() {
            return head1;
        }

        public void setHead1(String head1) {
            this.head1 = head1;
        }

        public String getHead2() {
            return head2;
        }

        public void setHead2(String head2) {
            this.head2 = head2;
        }

        public String getHead3() {
            return head3;
        }

        public void setHead3(String head3) {
            this.head3 = head3;
        }

        public String getHead4() {
            return head4;
        }

        public void setHead4(String head4) {
            this.head4 = head4;
        }
    }
}

注意事项

  1. 日期格式处理：对于日期类型的数据，可使用 @DateTimeFormat 注解进行格式化。
  2. 数字格式处理：对于数字类型的数据，可使用 @NumberFormat 注解进行格式化。
  3. 内存优化：读取大文件时，建议采用监听器分批读取的方式，以避免内存溢出。
  4. 异常处理：在实际应用中，要对文件不存在、权限不足等异常情况进行处理。
  5. 并发操作：EasyExcel 不是线程安全的，在多线程环境下使用时，要注意同步问题。
hqxstudying
关注
【Java】- EasyExcel模板导出
用来当笔记本
12-16 977
根据自定义模板导出Excel，包含图片、表格，采用EasyExcel导出
EasyExcel 使用文档说明
TokyoCatZ的博客
05-04 456
【代码】EasyExcel 使用文档说明。
Java中使用EasyExcel技术进行简单的写操作（maven）
m0_70545163的博客
09-04 978
摘要：使用EasyExcel技术实现对Excel文件的写操作（最简单的写Excel，快速开始）
Java中使用alibaba easyexcel导出Excel，合并单元格
SUMMERENT的博客
08-23 5901
Java中导出xlsx文件，合并单元格，简单上手
Java中使用EasyExcel技术进行简单的读操作（maven）
m0_70545163的博客
09-25 1142
在这篇文章中我对java中使用EasyExcel技术中的读操作进行快速入门
EasyExcel简单使用
dante1987的博客
05-11 1527
​ 如果是在listener中进行插库操作，那需要把service注入进来，但是在listener中不能用@Autowired，所以重写一个带参的构造方法，把注入好的service直接传进来使用即可，我下面将注入好的。​ 之前一直用的Apache POI来做数据的导入导出，但听说阿里的EasyExcel也拥有POI的功能的同时，在处理大数据量的导入导出的时候性能上比POI更好，所以就来尝试使用一下。​ 定义一个导出数据模型类，用于设置excel文件的格式，通过注解的方式可以定义excel中的格式。
EasyExcel使用的相关的jar包
01-21
本篇将详细介绍EasyExcel的使用及其相关的jar包。 首先，让我们了解EasyExcel的核心功能。EasyExcel提供了一种简单易用的方式来读取和写入Excel文件，而无需预先定义实体类或模版。通过反射机制，它可以自动将Excel...
easyexcel使用
li_xiao_ning的博客
01-16 823
一、easyexcel介绍 Java解析、生成Excel比较有名的框架有Apache poi、jxl。但他们都存在一个严重的问题就是非常的耗内存，poi有一套SAX模式的API可以一定程度的解决一些内存溢出的问题，但POI还是有一些缺陷，比如07版Excel解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大。easyexcel重写了poi对07版Excel的解析，能够原本一个...
EasyExcel使用详解
最新发布
ning的博客
01-27 1469
通过注解映射 Excel 列名或索引，@Data@ExcelProperty("用户ID")@ExcelProperty(value = "姓名", index = 1) // 指定列索引@ExcelProperty("创建时间")@ExcelIgnore // 不参与读写实现@Slf4j@Override// 模拟入库操作@Overrideif (!log.info("所有数据解析完成！");// 实际业务中调用 DAO 层EasyExcel 凭借其高性能。
easyExcel的maven依赖（备忘）
weixin_40434637的博客
09-18 2万+
pom依赖如下 <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.6</version> </dependency> <dependency> <groupId>org.apache.poi</group
EasyExcel 模板导入导出
qq_43538925的博客
01-14 8878
文章介绍了阿里巴巴的easyEXcel 模板导出工具的使用方式,以及完整的代码!不需要编辑导入模板即可导入数据,效率高,方面修改,支持注解。
JAVA-EasyExcel使用
hero_xs的博客
06-21 2628
Java-Alibaba EasyExcel，对excel处理
解决maven依赖冲突，这篇就够了！
lyl54545的博客
06-15 2235
什么是依赖冲突依赖冲突是指项目依赖的某一个jar包，有多个不同的版本，因而造成了包版本冲突。依赖冲突的原因我们在maven项目的pom中 一般会引用许许多多的。例如，项目A有这样的依赖关系： X是A的，但是两条依赖路径上有两个版本的X,那么哪个X会被Maven解析使用呢? 两个版本都被解析显然是不对的，因为那会造成依赖重复，因此必须选择一个。至于怎么选肯定有它的规则（下面会讲），这里我们先假设最终引用的版本，这样会不会有问题呢？当然会有的1、你想如果B引用X(2.0)的新创建的类，但因为最终被解析的是X
Maven中EasyExcel的使用
AlexWang30的博客
11-21 8351
首先，在maven项目的pom.xml引入依赖： <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.1</version> </dependency> excel的导出：
EasyExcel 使用教程
gitblog_00859的博客
09-14 501
EasyExcel 使用教程 EasyExcel NetCore excel 导入，导出 项目地址: https://gitcode.com/gh_mirrors/easy/EasyExcel ...
EasyExcel详解（结合官方文档）
热门推荐
Bananaaay的博客
12-27 2万+
EasyExcel的学习分享
Alibaba-Easyexcel 使用总结
北执南念的博客
08-21 2223
阿里 easy excel 使用总结
阿里easyExcel学习笔记（maven）
weixin_37775583的博客
04-28 7512
阿里easyExcel（导出）学习笔记（maven） 背景 生成Excel比较有名的框架有poi和jxl。这两个方法有一个严重的问题就是非常消耗内存。虽然poi有一些api可以在一定程度上解决一些内存溢出的问题。但是poi在操作07版excel的解压缩以及解压后存储都是在内存中完成的，内存消耗依然很大。easyExcel 重写了 poi 对 07 版 Excel 的解析，使原本需要 100M 左右...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值