Fesod：高性能低内存的Java Excel处理解决方案

Fesod是由EasyExcel原作者开发的新一代Excel处理工具，专为解决大规模Excel文件处理场景设计。作为一款开源Java库，它通过创新的内存优化技术，在保持与EasyExcel完全兼容的基础上，显著降低了内存占用并提升了处理速度，为企业级应用提供了可靠的Excel读写解决方案。

认识Fesod核心价值

Fesod重新定义了Java Excel处理的性能标准，其核心价值体现在三个维度：

• 超低内存占用：采用流式处理架构，避免将整个文件加载到内存，处理1GB文件仅需数十MB内存
• 卓越处理性能：相比传统POI库，读取速度提升300%，写入速度提升200%
• 无缝迁移体验：完全兼容EasyExcel的API设计，现有项目可零成本迁移

这些特性使Fesod成为处理大型报表、数据导入导出、批量数据处理等场景的理想选择，尤其适合需要处理百万级数据量的企业级应用。

配置开发环境

环境要求

• JDK 8或更高版本
• Maven 3.5+构建工具
• 支持Excel 2003(.xls)至2021(.xlsx)所有格式

添加依赖

在项目的pom.xml文件中添加以下依赖：

<dependency>
    <groupId>org.apache.fesod</groupId>
    <artifactId>fesod-sheet</artifactId>
    <version>1.0.0</version>
</dependency>

如需使用最新快照版本，需添加快照仓库配置。

实现基础Excel读写

创建数据模型

定义与Excel表格结构对应的Java类：

public class UserData {
    @ExcelProperty("姓名")  // 对应Excel表头
    private String name;
    
    @ExcelProperty("年龄")
    private Integer age;
    
    @ExcelProperty("注册日期")
    private LocalDateTime registerDate;
    
    // Getter和Setter方法
    // ...
}

读取Excel文件

实现数据监听器处理解析结果：

public class UserDataListener implements ReadListener<UserData> {
    private List<UserData> dataList = new ArrayList<>();
    
    @Override
    public void invoke(UserData data, AnalysisContext context) {
        dataList.add(data);
        // 每1000条数据处理一次，避免内存堆积
        if (dataList.size() >= 1000) {
            processData();
            dataList.clear();
        }
    }
    
    @Override
    public void doAfterAllAnalysed(AnalysisContext context) {
        // 处理剩余数据
        processData();
    }
    
    private void processData() {
        // 业务处理逻辑
        System.out.println("处理" + dataList.size() + "条数据");
    }
}

执行读取操作：

public void readExcel() {
    String fileName = "user_data.xlsx";
    FastExcel.read(fileName, UserData.class, new UserDataListener())
             .sheet()  // 读取第一个Sheet
             .doRead(); // 执行读取
}

写入Excel文件

public void writeExcel() {
    String fileName = "output.xlsx";
    List<UserData> dataList = generateSampleData();
    
    FastExcel.write(fileName, UserData.class)
             .sheet("用户数据")  // 指定Sheet名称
             .doWrite(dataList); // 执行写入
}

private List<UserData> generateSampleData() {
    List<UserData> list = new ArrayList<>();
    // 添加示例数据
    // ...
    return list;
}

掌握高级功能特性

实现复杂数据填充

Fesod支持多区域复合填充功能，适用于复杂报表生成场景：

public void complexFill() {
    // 创建填充配置
    FillConfig fillConfig = FillConfig.builder()
        .forceNewRow(true)  // 强制新建行
        .build();
    
    // 准备填充数据
    List<FillData> dataList = createFillData();
    
    // 执行复合填充
    try (ExcelWriter excelWriter = FastExcel.write("complex_fill.xlsx")
            .withTemplate("template.xlsx")
            .build()) {
        WriteSheet writeSheet = WriteSheet.createNewSheet();
        excelWriter.fill(dataList, fillConfig, writeSheet);
    }
}

插入图片到Excel

Fesod支持多种图片来源和插入方式：

public void writeImage() {
    List<ImageData> dataList = new ArrayList<>();
    ImageData data = new ImageData();
    
    // 从文件插入
    data.setFile(new File("logo.png"));
    // 从字节数组插入
    data.setByteArray(Files.readAllBytes(Paths.get("image.jpg")));
    // 从URL插入
    data.setUrl(new URL("https://example.com/image.png"));
    
    dataList.add(data);
    
    FastExcel.write("image_excel.xlsx", ImageData.class)
             .sheet()
             .doWrite(dataList);
}

应用场景解决方案

大数据量分批处理

处理百万级数据时，采用分批读取策略：

public void batchProcessExcel() {
    // 每批处理5000条数据
    final int BATCH_SIZE = 5000;
    
    FastExcel.read("large_data.xlsx", BigData.class, new ReadListener<BigData>() {
        private List<BigData> batchList = new ArrayList<>(BATCH_SIZE);
        
        @Override
        public void invoke(BigData data, AnalysisContext context) {
            batchList.add(data);
            if (batchList.size() >= BATCH_SIZE) {
                saveBatchData(batchList);  // 批量保存到数据库
                batchList.clear();
            }
        }
        
        @Override
        public void doAfterAllAnalysed(AnalysisContext context) {
            if (!batchList.isEmpty()) {
                saveBatchData(batchList);  // 处理剩余数据
            }
        }
    }).sheet().doRead();
}

Spring Boot集成方案

在Web应用中实现Excel导入导出：

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

    @PostMapping("/import")
    public ResponseEntity<String> importExcel(@RequestParam("file") MultipartFile file) {
        try {
            FastExcel.read(file.getInputStream(), UserData.class, new UserDataListener())
                     .sheet()
                     .doRead();
            return ResponseEntity.ok("导入成功");
        } catch (Exception e) {
            return ResponseEntity.status(500).body("导入失败: " + e.getMessage());
        }
    }
    
    @GetMapping("/export")
    public void exportExcel(HttpServletResponse response) throws IOException {
        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
        response.setHeader("Content-Disposition", "attachment;filename=users.xlsx");
        
        List<UserData> dataList = userService.getAllUsers();
        FastExcel.write(response.getOutputStream(), UserData.class)
                 .sheet("用户列表")
                 .doWrite(dataList);
    }
}

性能优化实践

内存优化策略

1. 禁用不必要的功能：

FastExcel.read(fileName, UserData.class, listener)
         .excludeColumnFiledNames("password")  // 排除不需要的字段
         .sheet()
         .doRead();

2. 使用Sax模式读取：

FastExcel.read(fileName, UserData.class, listener)
         .saxRead(true)  // 启用Sax模式，内存占用更低
         .sheet()
         .doRead();

性能对比数据

操作场景	Fesod	EasyExcel	POI
100万行读取	18秒	42秒	内存溢出
100万行写入	22秒	58秒	内存溢出
内存占用	45MB	180MB	>1GB

最佳实践总结

核心使用建议

• 选择合适的API：简单读取使用FastExcel.read()，复杂场景使用ExcelReader
• 合理设置批处理大小：根据数据复杂度调整，建议5000-10000条/批
• 优先使用注解配置：通过@ExcelProperty等注解减少代码量
• 异常处理：实现AnalysisEventListener的onException方法捕获错误

进阶学习资源

• 官方文档：website/docs/introduce.md
• 示例代码：fesod-examples/fesod-sheet-examples/src/test/java/org/apache/fesod/sheet/demo
• 性能测试报告：website/docs/performance.md

通过本指南，您已经掌握了Fesod的核心功能和最佳实践。无论是处理日常办公文档还是企业级大数据量Excel文件，Fesod都能提供高效、稳定的解决方案，帮助您的应用轻松应对各种Excel处理挑战。

要深入了解更多高级特性和底层实现原理，请参考官方完整文档和源代码实现。