SpringBoot集成EasyExcel实现Excel导入

本文档介绍了如何在SpringBoot应用中集成EasyExcel实现Excel文件上传和解析。通过添加EasyExcel依赖,创建实体类和监听器,以及设置Controller处理MultipartFile,实现了从前端接收Excel并进行数据读取的功能。同时,展示了EasyExcel的不同Read方法,便于根据不同场景选择合适的方法。文章还提供了测试步骤和代码示例。
摘要由CSDN通过智能技术生成

SSpringBoot集成EasyExcel实现Excel导入

第一次正式的写文章进行分享,如果文章中有什么问题,欢迎大家在文末的群内反馈。

一、背景

为什么会用Easyexcel来做Excel上传

平时项目中经常使用EasyExcel从本地读取Excel中的数据,还有一个前端页面对需要处理的数据进行一些配置(如:Excel所在的文件夹,Excel的文件名,以及Sheet列名、处理数据需要的某些参数),由于每次都是读取的本地的文件,我就在想,如果某一天需要通过前端上传excel给我,让我来进行处理我又应该怎么办呢?我怎么才能在尽量少修改代码的前提下实现这个功能呢(由于公司经常改需求,项目已经重新写了3次了)?后来查了很多资料,发现Excel可以使用InPutStream流来读取Excel,我就突然明白了什么。

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

二、集成EasyExcel?

萨达

1、 在pom.xml中添加EasyExcel依赖
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>easyexcel</artifactId>
            <version>2.1.3</version>
        </dependency>
2、创建EasyExcel映射实体类
import com.alibaba.excel.annotation.ExcelProperty;

public class ExcelEntity {
    // ExcelProperty中的参数要对应Excel中的标题
    @ExcelProperty("ID")
    private int ID;

    @ExcelProperty("NAME")
    private String name;

    @ExcelProperty("AGE")
    private int age;

    public ExcelEntity() {
    }

    public ExcelEntity(int ID, String name, int age) {
        this.ID = ID;
        this.name = name;
        this.age = age;
    }

    public int getID() {
        return ID;
    }

    public void setID(int ID) {
        this.ID = ID;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}
3、创建自定义Easyexcel的监听类
  • 这个监听类里面每一个ExcelEntity对象代表一行数据

  • 在这个监听类里面可以对读取到的每一行数据进行单独操作

  • 这里的读取的数据是按照Excel中每一条数据的顺序进行读取的

import com.alibaba.excel.context.AnalysisContext;
import com.alibaba.excel.event.AnalysisEventListener;
import java.util.ArrayList;
import java.util.List;

public class UploadExcelListener extends AnalysisEventListener<ExcelEntity> {

    private static final Logger logger = LoggerFactory.getLogger(LoggerItemController.class);
    public static final List<ExcelEntity> list = new ArrayList<>();

    @Override
    public void invoke(ExcelEntity excelEntity, AnalysisContext context) {
        logger.info(String.valueOf(excelEntity.getID()));
        logger.info(excelEntity.getName());
        logger.info(String.valueOf(excelEntity.getAge()));
        list.add(excelEntity);
    }
4、创建controller
import com.alibaba.excel.EasyExcel;
import com.alibaba.excel.ExcelReader;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

@RestController
@CrossOrigin
@RequestMapping("/loggerItem")
public class LoggerItemController {


    //  MultipartFile 这个类一般是用来接受前台传过来的文件
    @PostMapping("/upload")
    public List<ExcelEntity> upload(@RequestParam(value = "multipartFile") MultipartFile multipartFile){
        if (multipartFile == null){
            return null;
        }

        InputStream in = null;
        try {
            // 从multipartFile获取InputStream流
            in = multipartFile.getInputStream();

            /*
             *  EasyExcel 有多个不同的read方法,适用于多种需求
             *  这里调用EasyExcel中通过InputStream流方式读取Excel的Read方法
             *  他会返回一个ExcelReaderBuilder类型的返回值
             *  ExcelReaderBuilder中有一个doReadAll方法,会读取所有的Sheet
             */
            EasyExcel.read(in,ExcelEntity.class,new UploadExcelListener())
                    .sheet("Sheet1")
                    .doRead();

            //  每次EasyExcel的read方法读取完之后都会关闭流,我这里为了试验doReadAll方法,所以重新获取了一次
            in = multipartFile.getInputStream();
            /*
             * ExcelReaderBuilder中的Sheet方法,需要添加读取的Sheet名作为参数
             * 并且不要忘记在后面再调用一下doReadAll方法,否则不会进行读取操作
             */

            EasyExcel.read(in,ExcelEntity.class,new UploadExcelListener()).doReadAll();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return UploadExcelListener.list;
    }
}
5、application.yml配置
server:
  # 指定端口号
  port: 8080
spring:
  servlet:
    multipart:
      # 配置单个上传文件大小
      file-size-threshold: 100M
      # 配置总上传大小
      max-request-size: 300M
6、测试

我们先搞一个简单的Excel,用来测试

在这里插入图片描述

然后通过Postman模拟发送请求

  • 选择Post请求并输入请求地址
  • 在下面选择Body
  • Key的框中输入controller中的请求的方法中的参数,后面的下拉框中选择File
  • VALUE框中有一个Select File ,点击后选择自己刚才创建的测试的Excel
  • 最后点击Send发送请求

在这里插入图片描述

返回值如下:

由于我读了两次都放在同一个List中返回,所以返回值中有8个对象。

[
    {
        "name": "小黑",
        "age": 25,
        "id": 1
    },
    {
        "name": "小白",
        "age": 22,
        "id": 2
    },
    {
        "name": "小黄",
        "age": 22,
        "id": 3
    },
    {
        "name": "小绿",
        "age": 23,
        "id": 4
    },
    {
        "name": "小黑",
        "age": 25,
        "id": 1
    },
    {
        "name": "小白",
        "age": 22,
        "id": 2
    },
    {
        "name": "小黄",
        "age": 22,
        "id": 3
    },
    {
        "name": "小绿",
        "age": 23,
        "id": 4
    }
]

三、EasyExcel中的Read方法汇总

/**
     * Build excel the read
     *
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read() {
        return new ExcelReaderBuilder();
    }

    /**
     * Build excel the read
     *
     * @param file
     *            File to read.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(File file) {
        return read(file, null, null);
    }

    /**
     * Build excel the read
     *
     * @param file
     *            File to read.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(File file, ReadListener readListener) {
        return read(file, null, readListener);
    }

    /**
     * Build excel the read
     *
     * @param file
     *            File to read.
     * @param head
     *            Annotate the class for configuration information.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(File file, Class head, ReadListener readListener) {
        ExcelReaderBuilder excelReaderBuilder = new ExcelReaderBuilder();
        excelReaderBuilder.file(file);
        if (head != null) {
            excelReaderBuilder.head(head);
        }
        if (readListener != null) {
            excelReaderBuilder.registerReadListener(readListener);
        }
        return excelReaderBuilder;
    }

    /**
     * Build excel the read
     *
     * @param pathName
     *            File path to read.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(String pathName) {
        return read(pathName, null, null);
    }

    /**
     * Build excel the read
     *
     * @param pathName
     *            File path to read.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(String pathName, ReadListener readListener) {
        return read(pathName, null, readListener);
    }

    /**
     * Build excel the read
     *
     * @param pathName
     *            File path to read.
     * @param head
     *            Annotate the class for configuration information.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(String pathName, Class head, ReadListener readListener) {
        ExcelReaderBuilder excelReaderBuilder = new ExcelReaderBuilder();
        excelReaderBuilder.file(pathName);
        if (head != null) {
            excelReaderBuilder.head(head);
        }
        if (readListener != null) {
            excelReaderBuilder.registerReadListener(readListener);
        }
        return excelReaderBuilder;
    }

    /**
     * Build excel the read
     *
     * @param inputStream
     *            Input stream to read.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(InputStream inputStream) {
        return read(inputStream, null, null);
    }

    /**
     * Build excel the read
     *
     * @param inputStream
     *            Input stream to read.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(InputStream inputStream, ReadListener readListener) {
        return read(inputStream, null, readListener);
    }

    /**
     * Build excel the read
     *
     * @param inputStream
     *            Input stream to read.
     * @param head
     *            Annotate the class for configuration information.
     * @param readListener
     *            Read listener.
     * @return Excel reader builder.
     */
    public static ExcelReaderBuilder read(InputStream inputStream, Class head, ReadListener readListener) {
        ExcelReaderBuilder excelReaderBuilder = new ExcelReaderBuilder();
        excelReaderBuilder.file(inputStream);
        if (head != null) {
            excelReaderBuilder.head(head);
        }
        if (readListener != null) {
            excelReaderBuilder.registerReadListener(readListener);
        }
        return excelReaderBuilder;
    }

所有的方法都在这儿了,其实如果看不懂到底应该调用哪一个read方法的话,可以以根据自己所能得到的参数来判断。

四、扩展

  • 读取本地Excel

    public static void main(String[] args) {
        EasyExcel.read("C:/Users/Lonely Programmer/Desktop/新建 Microsoft Excel 工作表.xlsx"
                       ,ExcelEntity.class
                       ,new UploadExcelListener())
            .doReadAll();
    }
    

    读取本地的Excel和通过InPutStream流读取的方式是一样的,只是参数变了,原本传的是InPutStream流,现在传的是文件的绝对路径。我这里监听类和映射实体类都没有变,和上传用的是同一个,大家也可以根据需求来设定自己的监听类与实体类

  • MultipartFile文档

    MultipartFile文档地址:https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/web/multipart/MultipartFile.html

    翻译是通过Google Chrome自带翻译插件进行翻译的,建议大家使用Google Chrome打开,自带翻译功能
    在这里插入图片描述

最后欢迎大家进群交流:251199521

平时上班比较忙,所以一般更新也不会很快,操作过程中如果遇到什么问题,可以群内提问,我看到了的话,有时间基本上都会回复的。

其实百度才是最好的老师。

  • 2
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 4
    评论
要在Spring Boot集成easyexcel进行导入,您需要进行以下步骤: 1. 首先,您需要在您的项目中添加easyexcel的相关依赖。在您的pom.xml文件中添加以下依赖: ``` <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>2.1.4</version> </dependency> ``` 2. 您需要创建一个控制器类来处理导入请求。在该类中,您可以使用`@PostMapping`注解来处理导入请求,并将上传的文件作为`MultipartFile`参数。在该方法中,您可以调用相应的服务类来处理导入逻辑。以下是一个示例控制器类的代码: ```java @RestController @RequestMapping("/excel") public class ExcelController { @Autowired private ExcelService excelService; @PostMapping("/user/excelImport") public String excelImport(@RequestParam("file") MultipartFile file) throws IOException { excelService.excelImport(file); return "success"; } } ``` 3. 您还需要创建一个服务类来处理导入逻辑。在该类中,您可以使用easyexcel提供的API来读取并处理Excel文件。以下是一个示例服务类的代码: ```java @Service public class ExcelService { public void excelImport(MultipartFile file) throws IOException { // 使用easyexcel API读取并处理Excel文件 InputStream inputStream = file.getInputStream(); EasyExcel.read(inputStream, YourDataClass.class, new YourDataListener()).sheet().doRead(); } } ``` 4. 最后,您还需要创建一个数据监听器类来处理导入Excel数据。您可以在此类中实现`AnalysisEventListener`接口,并重写对应的方法来处理每一行的数据。以下是一个示例数据监听器类的代码: ```java public class YourDataListener extends AnalysisEventListener<YourDataClass> { @Override public void invoke(YourDataClass data, AnalysisContext context) { // 处理每一行的数据 } @Override public void doAfterAllAnalysed(AnalysisContext context) { // 所有数据解析完成后的操作 } } ``` 以上就是在Spring Boot集成easyexcel进行导入的基本步骤。您可以根据您的具体需求进行相应的调整和扩展。<span class="em">1</span><span class="em">2</span><span class="em">3</span><span class="em">4</span>
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值