EasyExcel工具的使用指南

已于 2024-12-08 00:27:30 修改
阅读量1.4k 收藏 19
点赞数 21
CC 4.0 BY-SA版权
分类专栏： Java开发 文章标签： java 开发语言
于 2024-12-08 00:27:07 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_39033358/article/details/144305839

在现代数据处理和分析中，Excel 文件是不可或缺的一部分。然而，手动处理大量数据不仅耗时，而且容易出错。为了提高效率和准确性，许多开发者选择使用自动化工具来处理 Excel 文件。EasyExcel 就是这样一款强大的 Java 库，它能够帮助开发者轻松地读取、写入和操作 Excel 文件。下面将详细介绍 EasyExcel 工具的使用方法，帮助你快速上手并掌握其核心功能。

1. 什么是 EasyExcel？

EasyExcel 是一个基于 Java 的 Excel 操作库，它提供了丰富的 API 来处理 Excel 文件。无论是简单的读写操作，还是复杂的数据处理和格式化，EasyExcel 都能轻松应对。它支持多种 Excel 格式，包括 .xls 和 .xlsx，并且兼容多种数据源，如数据库、CSV 文件等。EasyExcel 的设计理念是简单易用，性能高效，特别适合处理大文件。

2. 安装与配置

2.1 引入依赖

在使用 EasyExcel 之前，首先需要在你的项目中引入相关的依赖。如果你使用的是 Maven 项目，可以在 pom.xml 文件中添加以下依赖：

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

在这里插入图片描述

2.2 初始化 EasyExcel

在项目中引入依赖后，你可以通过以下方式初始化 EasyExcel：

import com.alibaba.excel.EasyExcel;

public class EasyExcelExample {
    public static void main(String[] args) {
        // EasyExcel 初始化
    }
}

3. 核心功能

3.1 读取 Excel 文件

EasyExcel 提供了多种方式来读取 Excel 文件，包括基于事件模型的读取和基于注解的读取。事件模型适用于处理大文件，而注解读取则适用于小文件。

3.1.1 准备数据模型
import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;

import java.util.Date;

@Data
public class ExcelEmpData {
    @ExcelProperty("姓名")
    private String name;

    @ExcelProperty("密码")
    private String password;

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

    @ExcelProperty("薪资")
    private Double salary;
}
3.1.2 准备excel文件

在项目的data目录下准备一份excel文件，文件名称：emp.xlsx，sheet页名称：员工信息，文件详情信息如下：
在这里插入图片描述

3.1.3 事件模型读取
import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;

import java.io.File;

public class ExcelReader01 {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";

        EasyExcel.read(filePath, ExcelEmpData.class, new AnalysisEventListener<ExcelEmpData>() {
            @Override
            public void invoke(ExcelEmpData data, AnalysisContext context) {
                // 处理每一行数据
                System.out.println(data);
            }

            @Override
            public void doAfterAllAnalysed(AnalysisContext context) {
                // 所有数据解析完成后的操作
                System.out.println("All data analysed.");
            }
        }).sheet("员工信息").doRead();
    }
}
3.1.4 注解读取
import com.alibaba.excel.EasyExcel;

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

public class ExcelReader02 {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";

        List<ExcelEmpData> dataList = EasyExcel.read(filePath)
                .head(ExcelEmpData.class)
                .sheet()
                .doReadSync();

        dataList.forEach(data -> {
            // 处理每一行数据
            System.out.println(data);
        });
    }
}

在这里插入图片描述

3.2 写入 Excel 文件

EasyExcel 提供了简单易用的 API 来生成 Excel 文件。你可以通过 EasyExcel.write 方法来创建 Excel 文件，并设置样式、格式等。

import com.alibaba.excel.EasyExcel;

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

public class ExcelWriter01 {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";

        List<ExcelEmpData> data = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            ExcelEmpData empData = new ExcelEmpData();
            empData.setName("员工" + i);
            empData.setPassword("pw" + i);
            empData.setBirthday(new Date());
            empData.setSalary(10000.0 + i * 100.0);
            data.add(empData);
        }

        EasyExcel.write(filePath, ExcelEmpData.class).sheet("员工信息").doWrite(data);
    }
}

3.3 数据处理与格式化

EasyExcel 支持对 Excel 数据进行各种处理和格式化操作。你可以通过注解来定义数据的格式、样式等。

import com.alibaba.excel.annotation.ExcelProperty;
import com.alibaba.excel.annotation.format.DateTimeFormat;

import lombok.Data;

@Data
public class User {
    @ExcelProperty("姓名")
    private String name;

    @ExcelProperty("年龄")
    private int age;

    @ExcelProperty("出生日期")
    @DateTimeFormat("yyyy-MM-dd")
    private Date birthDate;
}

3.4 自定义样式

EasyExcel 允许你自定义 Excel 文件的样式，包括字体、颜色、边框等。你可以通过 WriteCellStyle 和 HorizontalCellStyleStrategy 来设置样式。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.write.metadata.style.WriteCellStyle;
import com.alibaba.excel.write.metadata.style.WriteFont;
import com.alibaba.excel.write.style.HorizontalCellStyleStrategy;
import org.apache.poi.ss.usermodel.HorizontalAlignment;
import org.apache.poi.ss.usermodel.IndexedColors;

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

public class ExcelStyleExample {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";

        List<ExcelEmpData> data = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            ExcelEmpData empData = new ExcelEmpData();
            empData.setName("员工" + i);
            empData.setPassword("pw" + i);
            empData.setBirthday(new Date());
            empData.setSalary(10000.0 + i * 100.0);
            data.add(empData);
        }// 获取数据列表

        // 设置表头样式
        WriteCellStyle headWriteCellStyle = new WriteCellStyle();
        headWriteCellStyle.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
        WriteFont headWriteFont = new WriteFont();
        headWriteFont.setFontHeightInPoints((short) 12);
        headWriteFont.setColor(IndexedColors.RED.getIndex()); // 设置字体颜色
        headWriteCellStyle.setWriteFont(headWriteFont);

        // 设置内容样式
        WriteCellStyle contentWriteCellStyle = new WriteCellStyle();
        contentWriteCellStyle.setHorizontalAlignment(HorizontalAlignment.RIGHT);

        // 创建样式策略
        HorizontalCellStyleStrategy horizontalCellStyleStrategy = new HorizontalCellStyleStrategy(headWriteCellStyle, contentWriteCellStyle);

        EasyExcel.write(filePath, ExcelEmpData.class)
                .registerWriteHandler(horizontalCellStyleStrategy) // 注册样式策略
                .sheet("员工信息") // 设置工作表名称
                .doWrite(data); // 写入数据
    }
}

代码说明：

  1. 设置表头样式：
    • 使用 WriteCellStyle 类来定义表头的样式。
    • 使用 setFillForegroundColor 方法设置表头的背景颜色，这里我们使用了 IndexedColors.GREY_25_PERCENT.getIndex() 来设置灰色背景。
    • 使用 WriteFont 类来定义表头的字体样式。
    • 使用 setColor 方法设置表头的字体颜色，这里我们使用了 IndexedColors.RED.getIndex() 来设置红色字体。
  2. 设置内容样式：
    • 使用 WriteCellStyle 类来定义内容的样式。
    • 使用 setHorizontalAlignment 方法设置内容的水平对齐方式，这里我们使用了 HorizontalAlignment.RIGHT 来设置右对齐。
  3. 创建样式策略：
    • 使用 HorizontalCellStyleStrategy 类来创建一个样式策略，将表头样式和内容样式结合起来。

在这里插入图片描述

4. 高级功能

4.2 自定义模板

EasyExcel 支持使用自定义模板来生成 Excel 文件。你可以通过 EasyExcel.write 方法的 template 参数来指定模板文件。

import com.alibaba.excel.EasyExcel;

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

public class TemplateExample {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";
        String templatePath = path + File.separator + "data" + File.separator + "file.xlsx";

        List<ExcelEmpData> data = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            ExcelEmpData empData = new ExcelEmpData();
            empData.setName("员工" + i);
            empData.setPassword("pw" + i);
            empData.setBirthday(new Date());
            empData.setSalary(10000.0 + i * 100.0);
            data.add(empData);
        }


        EasyExcel.write(filePath, ExcelEmpData.class)
                .needHead(false) // 设置首行不写入
                .withTemplate(templatePath) // 使用模板文件
                .sheet("Sheet1") // 设置工作表名称
                .doWrite(data); // 写入数据
    }
}

4.3 数据校验

EasyExcel 提供了数据校验功能，可以在读取数据时进行校验，确保数据的准确性。

import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;

import java.io.File;

public class DataValidationExample {
    public static void main(String[] args) {
        String path = System.getProperty("user.dir");
        // String filePath = path + File.separator + "aJavaBasic" + File.separator + "data" + File.separator + "emp.xlsx";
        String filePath = path + File.separator + "data" + File.separator + "emp.xlsx";

        EasyExcel.read(filePath, ExcelEmpData.class, new AnalysisEventListener<ExcelEmpData>() {
            @Override
            public void invoke(ExcelEmpData emp, AnalysisContext context) {
                if (emp.getSalary() < 10300) {
                    throw new RuntimeException("Invalid salary: " + emp.getSalary());
                }
                // 处理每一行数据
                System.out.println(emp);
            }

            @Override
            public void doAfterAllAnalysed(AnalysisContext context) {
                // 所有数据解析完成后的操作
                System.out.println("All data analysed.");
            }
        }).sheet().doRead();
    }
}

在这里插入图片描述

5. 总结

EasyExcel 是一个功能强大且易于使用的 Java 库，适用于各种 Excel 文件的处理需求。无论是简单的读写操作，还是复杂的数据处理和格式化，EasyExcel 都能提供高效的解决方案。通过本文的介绍，你应该已经掌握了 EasyExcel 的基本使用方法，并能够将其应用到实际项目中。

JAVA：探索 EasyExcel 的技术指南
木头
11-13 1290
JAVA：探索 EasyExcel 的技术指南
阿里出品Excel工具EasyExcel使用小结
java_beautiful的博客
06-23 588
笔者做小数据和零号提数工具人已经有一段时间，服务的对象是运营和商务的大佬，一般要求导出的数据是Excel文件，考虑到初创团队机器资源十分有限的前提下，选用了阿里出品的Excel工具EasyExcel。这里简单分享一下EasyExcel的使用心得。EasyExcel从其依赖树来看是对apache-poi的封装，笔者从开始接触Excel处理就选用了EasyExcel，避免了广泛流传的apache-poi导致的内存泄漏问题。...
EasyExcel 在实际项目中的使用
qq_50970746的博客
10-20 807
EasyExcel在项目中的使用
EasyExcel简单使用
weixin_43994244的博客
05-25 3169
EasyExcel简单使用1.导入依赖2.写入Excel1.简单写入-方式一2.简单写入-方式二3.排除模板对象中的某些列4.按照顺序排列5.复杂头6.重复写到同一个excel的sheet标签中7.重复写到同一个excel的不同sheet标签中7.数字日期格式化8.插入图片-4种方式9.设置表格列宽和行高10.设置表格样式11.合并单元格3.读文件1.简单读文件-方式一2.简单读文件-方式二2.读一个excel的多个sheet--数据模板都一样3.读一个excel的多个sheet--数据模板不一样4.文件上
EasyExcel学习笔记
最新发布
m0_56064238的博客
06-20 1101
EasyExcel是阿里开源的一款Java Excel处理工具，具有内存占用小、读写性能高的特点，适合处理大文件。文章主要介绍了EasyExcel的简单读写操作、批量处理和模板填充、综合案例等现方式。
EasyExcel的使用
beginner1227的博客
11-04 1181
Java领域解析、生成Excel比较有名的框架有Apache poi、jxl等。但他们都存在一个严重的问题就是 非常的耗内存。如果你的系统并发量不大的话可能还行，但是一旦并发上来后一定会OOM或 者JVM频繁的full gc。EasyExcel是阿里巴巴开源的一个excel处理框架，以使用简单、节省内存著称。EasyExcel能大大减 少占用内存的主要原因是在解析Excel时没有将文件数据一次性全部加载到内存中，而是从磁盘上一 行行读取数据，逐个解析。
easyexcel简单使用
杨某人的Java学习加油站
07-12 4766
EasyExcel是一个基于Java的简单、省内存的读写Excel的开源项目。在尽可能节约内存的情况下支持读写百M的Excel。github地址: https://github.com/alibaba/easyexcel官方文档: https://www.yuque.com/easyexcel/doc/easyexcel
EasyExcel使用教程
tttalk的博客
03-09 9341
文章目录一、EasyExcel简介二、EasyExcel使用介绍 一、EasyExcel简介 1.EasyExcel介绍：EasyExcel是阿里巴巴开源的一个excel处理框架。 2.特性：使用简单、节省内存。 (1)数据解析时，不像之前的Apache poi、jxl等Excel解析框架将数据一次性全部加载到内存中，而是从磁盘上一行行读取数据，逐个解析，并将一行的解析结果以观察者的模式通知处理（AnalysisEventListener）。 (2)相对poi框架，03版本的excel最多只有 65535
EasyExcel工具类：简化Excel数据处理的Java工具包
7. EasyExcel工具类的文件结构：该工具包包含多个文件，如ExcelReader3.java是实现Excel文件读取功能的Java文件，Excel批量导入.md是提供Excel批量导入功能的使用指南，Snipaste_2023-11-28_09-27-36.png可能是一个...
EasyExcel快速入门指南
EasyExcel是一个强大的Excel文件操作工具，可以帮助用户快速、简单地处理Excel文件，提供了丰富的API接口，支持各种操作，如读、写、编辑Excel文件，同时支持大数据量的处理。 ## 1.2 EasyExcel的优势和特点 - ...
easyexcel工具类3.x
05-01
### EasyExcel 3.x 版本工具类使用指南 #### 易用性和性能提升 EasyExcel 是阿里巴巴开源的一个轻量级 Excel 处理库，相较于传统 Apache POI，在处理大数据量场景下具有显著的性能优势[^1]。它通过减少内存消耗以及...
easyexcel使用教程-导出篇
热门推荐
chenxjuc的博客
03-16 3万+
easyExcel使用教程–导出篇 开始准备工作 1、导入Maven依赖 <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.2.10</version> </dependency> <dependency> <groupId>or
EasyExcel入门使用教程
m0_50281408的博客
11-14 1785
数据导入导出意义后台管理系统是管理、处理企业业务数据的重要工具，在这样的系统中，数据的导入和导出功能是非常重要的，其主要意义包括以下几个方面：1、提高数据操作效率：手动逐条添加或修改数据不仅费时费力，而且容易出错，此时就可以将大量数据从Excel等表格软件中导入到系统中时，通过数据导入功能，可以直接将表格中的数据批量导入到系统中，提高了数据操作的效率。2、实现数据备份与迁移：通过数据导出功能，管理员可以将系统中的数据导出为 Excel 或其他格式的文件，以实现数据备份，避免数据丢失。
easyExcel的使用
luosuss的博客
09-01 697
【代码】easyExcel的使用。
EasyExcel入门
伏颜的博客
07-29 1735
EasyExcel入门学习记录---学习自b站黑马
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

AllenBright

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值