EasyExcel是一个快速、简单的Excel操作框架，特别适合大批量数据的读写操作，下面我们就来看看如何在Spring Boot项目中整合EasyExcel框架来实现复杂表格数据的导入导出功能。

实现Excel导出功能

引入依赖

首先我们需要在项目的pom.xml文件中引入EasyExcel相关的依赖，如下所示。


    com.alibaba
    easyexcel
    3.0.5

实现逻辑

创建需要Excel导出的实体类，这里我们实现了一个简单的数据导出操作，在实际场景中可以结合实际业务来实现，如下所示。

@Data
public class UserData {
    @ExcelProperty("用户编号")
    private Long userId;

    @ExcelProperty("用户名")
    private String username;

    @ExcelProperty("邮箱")
    private String email;

    @ExcelProperty("注册时间")
    @DateTimeFormat("yyyy-MM-dd HH:mm:ss")
    private LocalDateTime registerTime;
}

接下来编写一个控制器来处理 Excel 导出请求，如下所示。

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

    @GetMapping("/export")
    public void exportExcel(HttpServletResponse response) throws IOException {
        // 模拟一些导出数据
        List userList = Arrays.asList(
            new UserData(1L, "Alice", "alice@example.com", LocalDateTime.now()),
            new UserData(2L, "Bob", "bob@example.com", LocalDateTime.now())
        );

        // 设置响应头
        response.setContentType("application/vnd.ms-excel");
        response.setCharacterEncoding("utf-8");
        String fileName = URLEncoder.encode("用户数据", "UTF-8").replaceAll("\\+", "%20");
        response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");

        // 写入 Excel
        EasyExcel.write(response.getOutputStream(), UserData.class)
            .sheet("用户信息")
            .doWrite(userList);
    }
}

上面的操作就实现了一个简单的Excel的导出功能，我们可以通过访问数据导出接口来实现Excel数据文件的导出操作。

实现Excel导入功能

和导出一样，导入数据时也需要定义对应的实体类。与导出可以共用实体类，接下来就是实现数据导入操作逻辑处理，如下所示。在使用EasyExcel进行导入时需要实现一个AnalysisEventListener，这样我们可以通过这个监听器来处理每一行的Excel数据，如下所示。

public class UserExcelListener extends AnalysisEventListener {
    
    private List userList = new ArrayList<>();

    // 每读一行数据都会调用该方法
    @Override
    public void invoke(UserData userData, AnalysisContext context) {
        userList.add(userData);
    }

    // 数据全部读完后调用
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 这里可以执行批量插入数据库等操作
        System.out.println("Excel 数据读取完成，共 " + userList.size() + " 条数据");
    }

    public List getUserList() {
        return userList;
    }
}

编写导入控制器，用来接收文件上传数据并使用EasyExcel解析Excel中的数据操作，如下所示。

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

    @PostMapping("/import")
    public String importExcel(@RequestParam("file") MultipartFile file) throws IOException {
        if (file.isEmpty()) {
            return "上传文件为空";
        }

        UserExcelListener listener = new UserExcelListener();
        EasyExcel.read(file.getInputStream(), UserData.class, listener).sheet().doRead();
        List userList = listener.getUserList();

        // 这里可以把数据保存到数据库中
        // userService.saveBatch(userList);

        return "导入成功，共 " + userList.size() + " 条数据";
    }
}

接口接收Excel文件，读取文件内容并通过UserExcelListener将数据解析后存储到userList中，最终返回导入数据的条数。当然在处理完成之后，我们也可以将数据写入到数据库中，或者是其他的持久化机制中。

复杂表格的处理

如果导入导出的Excel表格比较复杂，比如有合并单元格、多级表头等，这样我们就可以通过如下的方式来对相关的操作进行优化。

多级表头的处理

可以使用 @ExcelProperty 注解中的数组来实现多级表头，如下所示。

@Data
public class ComplexUserData {
    @ExcelProperty({"用户信息", "用户编号"})
    private Long userId;

    @ExcelProperty({"用户信息", "用户名"})
    private String username;

    @ExcelProperty({"联系信息", "邮箱"})
    private String email;

    @ExcelProperty({"联系信息", "电话号码"})
    private String phone;
}

合并单元格

要实现合并单元格的操作，需要添加自定义表格合并处理器CellWriteHandler，如下所示，定义一个单元格合并处理器。

public class MergeCellWriteHandler implements CellWriteHandler {

    @Override
    public void afterCellDispose(CellWriteHandlerContext context) {
        WriteSheetHolder sheetHolder = context.getWriteSheetHolder();
        WriteCellData cellData = context.getFirstCellData();

        // 合并逻辑，示例中简单的根据数据情况合并单元格
        if (context.getRowIndex() == 0 && context.getColumnIndex() == 0) {
            CellRangeAddress cellRangeAddress = new CellRangeAddress(0, 0, 0, 1); // 合并第一行的前两列
            sheetHolder.getSheet().addMergedRegion(cellRangeAddress);
        }
    }
}

然后在写入 Excel 时配置，对相关单元格进行合并处理。如下所示。

EasyExcel.write(response.getOutputStream(), ComplexUserData.class)
    .registerWriteHandler(new MergeCellWriteHandler()) // 注册合并单元格处理器
    .sheet("复杂表格")
    .doWrite(complexUserList);