Spring Boot整合 EasyExcel 实现复杂 Excel 表格的导入与导出功能

本文介绍: EasyExcel 是阿里巴巴开源的一款基于 Java 的简单、快速、强大的 Excel 处理工具。在实际应用中，Excel 的导入与导出是常见的需求，而 EasyExcel 提供了简便的 API，使得这些操作变得非常容易。本文将介绍如何在 Spring Boot 项目中整合 EasyExcel，实现复杂 Excel 表格的导入与导出功能。

Alt

EasyExcel 是阿里巴巴开源的一款基于 Java 的简单、快速、强大的 Excel 处理工具。在实际应用中，Excel 的导入与导出是常见的需求，而 EasyExcel 提供了简便的 API，使得这些操作变得非常容易。本文将介绍如何在 Spring Boot 项目中整合 EasyExcel，实现复杂 Excel 表格的导入与导出功能。
在这里插入图片描述

在 pom.xml 文件中引入 EasyExcel 的依赖：

<dependencies>
    <!-- EasyExcel -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>easyexcel</artifactId>
        <version>2.4.3</version>
    </dependency>
    
    <!-- Spring Boot Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

创建与 Excel 表格对应的实体类，注解 @ExcelProperty 用于指定属性与 Excel 列的映射关系：

public class User {

    @ExcelProperty("ID")
    private Long id;

    @ExcelProperty("姓名")
    private String name;

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

    // 省略 getter 和 setter
}

创建导入功能的 Controller 类，使用 @PostMapping 注解处理导入请求：

@RestController
@RequestMapping("/excel")
public class ExcelController {

    @PostMapping("/import")
    public String importExcel(@RequestParam("file") MultipartFile file) {
        try (InputStream inputStream = file.getInputStream()) {
            List<User> userList = EasyExcel.read(inputStream).head(User.class).sheet().doReadSync();
            // 处理导入的数据，例如保存到数据库
            return "导入成功";
        } catch (Exception e) {
            e.printStackTrace();
            return "导入失败";
        }
    }
}

创建导入页面，使用 HTML 表单上传 Excel 文件：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Excel导入</title>
</head>
<body>
    <form action="/excel/import" method="post" enctype="multipart/form-data">
        <input type="file" name="file" accept=".xls,.xlsx">
        <button type="submit">导入</button>
    </form>
</body>
</html>

创建导出功能的 Controller 类，使用 @GetMapping 注解处理导出请求：

@RestController
@RequestMapping("/excel")
public class ExcelController {

    // 导出数据的模拟数据
    private List<User> mockData() {
        List<User> userList = new ArrayList<>();
        userList.add(new User(1L, "Alice", 25));
        userList.add(new User(2L, "Bob", 30));
        userList.add(new User(3L, "Charlie", 22));
        return userList;
    }

    @GetMapping("/export")
    public void exportExcel(HttpServletResponse response) {
        try (OutputStream outputStream = response.getOutputStream()) {
            response.setContentType("application/vnd.ms-excel");
            response.setCharacterEncoding("utf-8");
            response.setHeader("Content-disposition", "attachment;filename=user.xlsx");

            EasyExcel.write(outputStream, User.class).sheet("用户信息").doWrite(mockData());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Excel导出</title>
</head>
<body>
    <a href="/excel/export">导出Excel</a>
</body>
</html>