代码收藏家技术教程 7天前

Fastexcel 数据导出替代 EasyExcel：简单易用的 Fastexcel 使用指南

Fastexcel 的使用文档：idev.cn/fastexcel/zh-CN/docs

EasyExcel是一个用于处理Excel文件的高效工具，确实有些项目可能由于没有更新或而让一些开发者寻求替代方案而维护。如果您需要实现分类数据导出并控制权限，Fastexcel是一个值得考虑的替代产品。

1. 为什么选择`Fastexcel`？

Fastexcel是一个性能较好且轻量级的Java库，它在读取和写入Excel文件方面有非常高的效率，特别适用于大数据量处理。Fastexcel也支持分批次导出，对于大型数据集的导出，它的性能比EasyExcel要好一些。

2. Fastexcel和EasyExcel区别：

Fastexcel和EasyExcel都是Java中用于操作Excel文件的库，但它们在设计、高效性能、使用一些场景等方面都有一些区别。下面是这两个库的主要对比：

2.1. 性能和内存管理

Fastexcel：Fastexcel专注于高效处理大数据量的Excel文件。它的内存管理非常优秀，采用了流式读取的方式，这使得它在处理大型文件时的性能优势急剧凸显。它适合处理大规模数据（例如百万级的行），在大数据量导出时的性能表现可能更好。

EasyExcel：EasyExcel也具备较好的性能，尤其是在固定文件大小下，性能和内存消耗都表现得不错。它使用了流式读取和读取，但和Fastexcel相比，EasyExcel更注重一般的 Excel 处理场景，并不是专门优化处理非常大的数据集。

2.2. 易用性

Fastexcel：Fastexcel的API比较基础，设计上比较简单，但可能需要开发者进行更多的手动配置。例如，它要求开发者更明确地管理Excel工作簿、工作表、单元格等内容。

EasyExcel：EasyExcel提供了简单的更丰富的功能，封装了很多操作的细节，使得开发者可以更轻松地进行常见的Excel操作。它具有更方便的API，能够快速实现一些操作（例如简单的Excel导入导出）。

2.3. 功能支持

Fastexcel：Fastexcel提供了一些基础的功能，主要关注于性能，适合需要处理大量Excel文件的场景，但对于复杂的格式或功能（如单元格样式、公式、复杂的数据格式等）支持很少。

EasyExcel：EasyExcel在功能上更加全面，支持更多Excel的功能，包括不同的数据格式、样式设置、公式、合并单元格等功能。对于常见的需求，它能够更便捷地实现。

2.4. 社区支持和维护

Fastexcel：Fastexcel的社区和维护情况比较冷清，更新频率较低。虽然它在性能方面有优势，但由于维护较少，可能在某些情况下缺乏对新功能或 bug 修复的支持。

EasyExcel：EasyExcel是由阿里巴巴维护的一个项目，社区活跃，更新频率极高，并且在生产环境中的稳定性得到了广泛的验证。对于常见的Excel操作，EasyExcel的支持比较全面，但是现在停止维护了。

2.5. 依赖和兼容性

Fastexcel：Fastexcel相对较轻量，没有过多的依赖，使用时可以更灵活地选择所需的功能。

EasyExcel：EasyExcel基于poi实现，通常需要基线的依赖。虽然它有较好的兼容性和功能扩展性，但对于通常做简单操作的场景来说，可能会另外出现明显的提示符号。

2.6. 写入性能

Fastexcel：由于其设计初衷是优化内存使用并处理大规模数据，Fastexcel在Excel写入性能上通常表现得更为出色。它采用了流式写入的避免策略，一次性将所有数据加载到内存中，非常适合需要导出非常大的Excel文件的场景。

EasyExcel：EasyExcel也采用流式读取，但在处理大量数据时，内存占用相对较高。如果你的数据量非常大，可能会在内存占用和性能上有所损失。

2.7. 灵活性与控制能力

Fastexcel：Fastexcel更灵活，允许开发者更精细地控制Excel文件的构建过程，例如可以更精确地管理内存和性能。这种灵活性对于一些高级用户来说非常有效，但也可能需要更多的配置。

EasyExcel：EasyExcel以简化开发为目标，自动封装了很多细节，适合开发者快速实现Excel导入导出的功能。对于大多数应用场景，EasyExcel提供了足够的灵活性，但在性能优化方面相对较少。

2.8. 适用场景

Fastexcel：如果你需要处理非常大的Excel文件（比如百万行级别的数据），并且对内存优化和性能要求极高，Fastexcel是一个很好的选择。

EasyExcel：如果您需要更全面的功能支持，比如处理复杂的样式、公式、合并单元格等的Excel文件，或者需要一个更容易使用的库来实现导入导出的功能，EasyExcel会更适合。

2.9. 总结

如果您的应用程序需要高效处理大数据量的 Excel 文件，且您对 API 简单、功能支持以上的场景感到满意，Fastexcel是一个非常适合的选择。

如果您需要更多功能、更好的社区支持、易用的 API 并且不会处理极端的大数据量，EasyExcel是一个更合适的选择。

根据您的实际需求和项目的特性，可以选择其中一个库。如果您关注的是性能和大数据量的支持，建议选择 Fastexcel，而如果您更看重开发的效率和丰富的功能，EasyExcel会是更合适的选择。

3. Fastexcel 简单实现

下面我会给你一个完整的示例，展示如何使用Fastexcel来导出分类数据，并且实现基本的权限控制功能（使用 Spring Boot 框架）。

3.1. 依赖配置

首先，在pom.xml中添加Fastexcel相关依赖：

<dependency>
    <groupId>cn.idev.excel</groupId>
    <artifactId>fastexcel</artifactId>
    <version>1.0.0</version>
</dependency>

3.2. 权限控制（Spring Security示例）

其中Spring Boot，您可以通过 Spring Security 来进行权限控制。假设我们用@PreAuthorize注解来确保只有具备某些权限的用户才可以执行导出操作。

权限检查代码：

import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.io.IOException;
import javax.servlet.http.HttpServletResponse;

@RestController
public class ExportController {

    private final DataExporter dataExporter;

    public ExportController(DataExporter dataExporter) {
        this.dataExporter = dataExporter;
    }

    // 仅允许拥有 'ROLE_ADMIN' 权限的用户执行导出
    @PreAuthorize("hasRole('ROLE_ADMIN')")
    @GetMapping("/export")
    public void exportCategoryData(HttpServletResponse response) throws IOException {
        // 设置响应头
        response.setHeader("Content-Disposition", "attachment; filename=category_data.xlsx");

        // 执行导出操作
        dataExporter.exportCategoryData(response.getOutputStream());
    }
}

3.3. 分类数据导出逻辑

接下来是导出分类数据的逻辑。我们将创建一个DataExporter类来处理数据导出，用来Fastexcel写Excel文件。

数据导出实现：

import com.github.mygreen.cellformatter.XlsxWriter;
import com.github.mygreen.cellformatter.workbook.Workbook;
import com.github.mygreen.cellformatter.sheet.Sheet;
import com.github.mygreen.cellformatter.row.Row;
import com.github.mygreen.cellformatter.cell.Cell;
import org.springframework.stereotype.Component;

import java.io.OutputStream;
import java.util.List;

@Component
public class DataExporter {

    // 模拟的分类数据
    private List<CategoryData> getCategoryData() {
        return List.of(
            new CategoryData("Category 1", "Data 1"),
            new CategoryData("Category 2", "Data 2"),
            new CategoryData("Category 3", "Data 3")
        );
    }

    public void exportCategoryData(OutputStream outputStream) {
        try (Workbook workbook = new XlsxWriter()) {
            // 创建工作表
            Sheet sheet = workbook.createSheet("分类数据");

            // 写入标题
            Row headerRow = sheet.createRow(0);
            headerRow.createCell(0).setCellValue("分类名称");
            headerRow.createCell(1).setCellValue("数据内容");

            // 写入数据
            int rowIndex = 1;
            for (CategoryData categoryData : getCategoryData()) {
                Row row = sheet.createRow(rowIndex++);
                row.createCell(0).setCellValue(categoryData.getCategoryName());
                row.createCell(1).setCellValue(categoryData.getDataContent());
            }

            // 写入 Excel 文件
            workbook.write(outputStream);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

分类数据类别（CategoryData）：

public class CategoryData {
    private String categoryName;
    private String dataContent;

    public CategoryData(String categoryName, String dataContent) {
        this.categoryName = categoryName;
        this.dataContent = dataContent;
    }

    public String getCategoryName() {
        return categoryName;
    }

    public String getDataContent() {
        return dataContent;
    }
}

3.4. 前端触发导出功能

在前端提供了一个按钮，通过Ajax请求触发导出API。这个请求会下载一个Excel文件。

<button onclick="exportData()">导出分类数据</button>

<script>
  function exportData() {
    // 发送请求到后端导出 Excel 文件
    window.location.href = '/export';
  }
</script>

3.5. Spring Security配置

假设您还没有设置 Spring Security，这里提供一个基本的权限控制配置。

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
        .authorizeRequests()
        .antMatchers("/export").hasRole("ADMIN")  // 仅允许 'ROLE_ADMIN' 用户访问导出接口
        .anyRequest().authenticated()
        .and()
        .formLogin()
        .permitAll();
    }
}