Spring Boot中Excel的导入导出的实现之EasyPoi框架使用教程

文章目录

  • 前言
  • 一、EasyPoi的使用
    • [1. 添加EasyPoi依赖](#1. 添加EasyPoi依赖)
    • [2. 创建实体类](#2. 创建实体类)
    • [3. 编写Controller](#3. 编写Controller)
    • [4. 编写导出Excel的方法](#4. 编写导出Excel的方法)
    • [5. 编写导入Excel的方法](#5. 编写导入Excel的方法)
    • [6. 编写导出Excel的方法](#6. 编写导出Excel的方法)
    • [7. 创建ExcelUtil工具类(可选)](#7. 创建ExcelUtil工具类(可选))
  • [二、EasyPoi 的注解](#二、EasyPoi 的注解)
  • 总结

前言

  EasyPoi功能如同名字easy,主打的功能就是容易,让一个没见接触过poi的人员 就可以方便的写出Excel导出,Excel模板导出,Excel导入,Word模板导出,通过简单的注解和模板 语言(熟悉的表达式语法),完成以前复杂的写法。

开源仓库地址:


一、EasyPoi的使用

当使用Spring Boot结合EasyPoi进行Excel导入导出时,你需要考虑以下详细步骤:

1. 添加EasyPoi依赖

确保在你的Spring Boot项目的pom.xml文件中添加EasyPoi的依赖:

xml 复制代码
<dependency>
    <groupId>cn.afterturn</groupId>
    <artifactId>easypoi-spring-boot-starter</artifactId>
    <version>2.3.0</version>
</dependency>

引入的依赖版本根据自己的需求自行选择

2. 创建实体类

创建用于映射Excel中数据的实体类,确保字段名称和Excel中的列名对应。你可以使用EasyPoi提供的注解来指定Excel中的格式和样式。

示例:

java 复制代码
import cn.afterturn.easypoi.excel.annotation.Excel;
import lombok.Data;

@Data
public class User {
    @Excel(name = "ID", width = 20)
    private Long id;

    @Excel(name = "姓名", width = 20)
    private String name;

    @Excel(name = "年龄", width = 20)
    private Integer age;
}

3. 编写Controller

编写一个Controller来处理Excel导入导出的请求。在这里,你需要使用@RestController和@RequestMapping注解来标识该类和映射URL。

4. 编写导出Excel的方法

在Controller中编写导出Excel的方法,使用EasyPoi提供的API来生成Excel文件并将其返回给前端。

示例:

java 复制代码
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

@RestController
public class UserController {

    @GetMapping("/exportUsers")
    public void exportUsers(HttpServletResponse response) throws IOException {
        List<User> userList = getUserList(); // 从数据库或其他地方获取用户数据
        ExcelUtil.exportExcel(userList, "用户列表", "用户信息", User.class, "用户信息.xls", response);
    }

    private List<User> getUserList() {
        // 从数据库或其他地方获取用户数据
        return new ArrayList<>();
    }
}

5. 编写导入Excel的方法

在Controller中编写导入Excel的方法,使用EasyPoi提供的API来解析上传的Excel文件,并将数据存储到数据库或进行其他相应的处理。

示例:

java 复制代码
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import java.util.List;

@RestController
public class UserController {

    @PostMapping("/importUsers")
    public String importUsers(@RequestParam("file") MultipartFile file) {
        List<User> userList = ExcelUtil.importExcel(file, 1, 1, User.class);
        // 将用户数据保存到数据库或进行其他处理
        return "导入成功";
    }
}

6. 编写导出Excel的方法

在 ExportService 类中,编写了一个导出用户数据的方法,通过 EasyPoi 的 ExcelExportUtil.exportExcel 方法将用户数据导出为 Excel 文件。最后在 Controller 类中,定义了一个导出接口,当请求该接口时触发导出操作。

java 复制代码
// 导出逻辑的 Service 类
@Service
public class ExportService {
    public void exportUsers(HttpServletResponse response) {
        List<User> userList = userService.getAllUsers(); // 假设从数据库获取用户数据

        // 设置响应头
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        response.setHeader("Content-disposition", "attachment;filename=users.xlsx");

        // 使用 EasyPoi 进行导出
        ExcelExportUtil.exportExcel(new ExportParams("用户列表", "用户"), User.class, userList, response.getOutputStream());
    }
}

// Controller 类
@RestController
@RequestMapping("/export")
public class ExportController {
    @Autowired
    private ExportService exportService;

    @GetMapping("/users")
    public void exportUsers(HttpServletResponse response) {
        exportService.exportUsers(response);
    }
}

7. 创建ExcelUtil工具类(可选)

为了更好地组织代码,你可以创建一个工具类来封装EasyPoi的导入导出方法。

示例:

java 复制代码
import cn.afterturn.easypoi.excel.ExcelExportUtil;
import cn.afterturn.easypoi.excel.ExcelImportUtil;
import cn.afterturn.easypoi.excel.entity.ExportParams;
import cn.afterturn.easypoi.excel.entity.ImportParams;
import org.apache.poi.ss.usermodel.Workbook;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;

public class ExcelUtil {

    public static void exportExcel(List<?> dataList, String sheetName, String title, Class<?> clazz, String fileName, HttpServletResponse response) throws IOException {
        ExportParams exportParams = new ExportParams(title, sheetName);
        Workbook workbook = ExcelExportUtil.exportExcel(exportParams, clazz, dataList);
        response.setContentType("application/vnd.ms-excel");
        response.setHeader("Content-disposition", "attachment;filename=" + fileName);
        workbook.write(response.getOutputStream());
    }

    public static <T> List<T> importExcel(MultipartFile file, int titleRows, int headerRows, Class<T> clazz) {
        ImportParams importParams = new ImportParams();
        importParams.setTitleRows(titleRows);
        importParams.setHeadRows(headerRows);
        try {
            return ExcelImportUtil.importExcel(file.getInputStream(), clazz, importParams);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }
}

以上是使用Spring Boot结合EasyPoi进行Excel导入导出的详细步骤和示例代码,仅供参考。


二、EasyPoi 的注解

以下是一个表格列出 EasyPoi 的注解详细介绍:

注解 作用 属性
@Excel 标识实体类的字段,在 Excel 中指定列名、宽度等属性 name, width, replace, type
@ExcelIgnore 标识实体类的字段,表示在 Excel 导入导出过程中忽略该字段 无
@ExcelCollection 标识实体类中的集合类型字段,表示该字段为一个子表格 name
@ExcelTarget 标识实体类,指定 Excel 中一个 Sheet 页与之对应 value
@ExcelEntity 标识实体类中的嵌套实体字段,表示该字段为一个嵌套表格 name
@ExcelProperty 标识 DTO 类中的字段,指定在 Excel 中的列名和顺序 value, index

这个表格可以帮助你更清晰地了解每个 EasyPoi 注解的作用和属性。


总结

  • 本文简单讲述了Spring Boot中Excel的导入导出的实现之EasyPoi框架使用教程,涉及到EasyPoi的使用步骤以及一些注解的介绍。
  • 欢迎大家提出建议以及批评,有任何问题可以私信。
相关推荐
果果软件8 小时前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
Sashtok12 小时前
cpp基础知识(10)
c++·后端
CoderYanger13 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
行百里er13 小时前
【Spring Insight 技术分享】runtime-settings.json 的妙用
后端·开源·监控
databook14 小时前
处理一批 PDF,怎么算真的处理完了
后端·python
苏三说技术15 小时前
为什么越来越多人用 Docling ? - 苏三说技术
后端
nice_lcj52015 小时前
【从零理解计算机网络 · 12】登录态的载体:Cookie、Session、Token 在网络层怎么走
后端·计算机网络·面试·jwt·token·cookie·session
学长毕设16 小时前
基于SpringBoot 博物馆文物租赁及修复管理系统-附源码
大数据·数据库·spring boot
考虑考虑16 小时前
JDK27中的加密对象的 PEM 编码
java·后端·java ee
Coder_shen16 小时前
汇川 EVO 系列 PLC EtherNet/IP(CIP)协议通信驱动的 C# 实现
后端