如何实现JeecgBoot单表数据导出多sheet

发布时间：2021-10-09 18:00:01 作者：iii
来源：亿速云阅读：434

# 如何实现JeecgBoot单表数据导出多Sheet

## 前言

在企业管理系统的开发中，数据导出是高频需求之一。JeecgBoot作为一款基于SpringBoot的低代码开发平台，内置了强大的在线报表功能。但当遇到单表数据需要按不同维度拆分到Excel多个Sheet页的场景时，常规的导出方式往往无法满足需求。本文将详细介绍三种实现方案，并提供完整代码示例。

## 一、需求场景分析

### 1.1 典型业务场景
- 销售数据按地区分Sheet展示
- 学生成绩按班级分Sheet统计
- 设备信息按类型分类导出

### 1.2 技术难点
- 如何动态生成多个Sheet
- 大数据量下的内存控制
- 保持统一的表头格式
- 性能优化问题

## 二、方案一：基于EasyExcel原生API

### 2.1 实现原理
利用EasyExcel的`ExcelWriter`支持多次`write`的特性

```java
// 示例代码片段
ExcelWriter excelWriter = EasyExcel.write(outputStream).build();

// Sheet1
WriteSheet sheet1 = EasyExcel.writerSheet(0, "华北地区")
        .head(headList).build();
excelWriter.write(dataList1, sheet1);

// Sheet2  
WriteSheet sheet2 = EasyExcel.writerSheet(1, "华东地区")
        .head(headList).build();
excelWriter.write(dataList2, sheet2);

excelWriter.finish();

2.2 完整实现代码

public void exportMultiSheet(HttpServletResponse response) {
    try {
        // 1. 准备数据
        List<Map<String, Object>> northData = getDataByRegion("north");
        List<Map<String, Object>> eastData = getDataByRegion("east");
        
        // 2. 设置响应头
        response.setContentType("application/vnd.ms-excel");
        response.setHeader("Content-Disposition", "attachment;filename=multi_sheet.xlsx");
        
        // 3. 创建ExcelWriter
        ExcelWriter excelWriter = EasyExcel.write(response.getOutputStream()).build();
        
        // 4. 写入Sheet1
        WriteSheet sheet1 = EasyExcel.writerSheet(0, "北方数据")
                .head(getHeader())
                .registerWriteHandler(new CustomCellStyleStrategy())
                .build();
        excelWriter.write(northData, sheet1);
        
        // 5. 写入Sheet2
        WriteSheet sheet2 = EasyExcel.writerSheet(1, "东方数据")
                .head(getHeader())
                .build();
        excelWriter.write(eastData, sheet2);
        
        // 6. 关闭资源
        excelWriter.finish();
    } catch (Exception e) {
        log.error("导出失败", e);
    }
}

2.3 优缺点分析

优点： - 直接使用底层API，灵活性高 - 支持自定义样式和处理器

缺点： - 需要手动处理每个Sheet - 大数据量时需配合分页查询

三、方案二：扩展Jeecg导出注解

3.1 自定义注解设计

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface JMultiSheetExport {
    String[] sheetNames() default {};
    String[] queryParams() default {};
}

3.2 AOP切面实现

@Around("@annotation(exportAnnotation)")
public Object around(ProceedingJoinPoint joinPoint, 
                   JMultiSheetExport exportAnnotation) throws Throwable {
    
    String[] sheetNames = exportAnnotation.sheetNames();
    String[] queryParams = exportAnnotation.queryParams();
    
    // 创建ExcelWriter
    ExcelWriter excelWriter = ...;
    
    for(int i=0; i<sheetNames.length; i++){
        // 动态设置查询参数
        setQueryParam(queryParams[i]);
        
        // 执行原导出方法获取数据
        Object result = joinPoint.proceed();
        
        // 写入Sheet
        WriteSheet sheet = EasyExcel.writerSheet(i, sheetNames[i])
                                   .build();
        excelWriter.write((List)result, sheet);
    }
    
    excelWriter.finish();
    return null;
}

四、方案三：基于Jeecg视图增强

4.1 实现步骤

创建multi_sheet_view视图
添加@ExcelCollection注解
自定义导出处理器

public class SysUser {
    
    @ExcelCollection(name="部门数据")
    private List<DeptData> deptSheet;
    
    @ExcelCollection(name="角色数据") 
    private List<RoleData> roleSheet;
}

4.2 视图SQL示例

CREATE VIEW multi_sheet_view AS
SELECT 
    'dept' AS sheet_type,
    dept_name,
    user_count
FROM dept_stats
UNION ALL
SELECT
    'role' AS sheet_type,
    role_name,
    user_count  
FROM role_stats

五、性能优化建议

5.1 大数据量处理

使用SXSSFWorkbook流式写入
设置autoTrim减少内存占用
分批次查询数据

5.2 缓存优化

// 启用模板缓存
WriteSheet sheet = EasyExcel.writerSheet()
    .useDefaultStyle(false)
    .build();

5.3 异步导出

@Async
public void asyncExport(params){
    // 导出逻辑
}

六、完整案例演示

6.1 学生成绩表导出

需求：按班级分Sheet导出期末考试数据

实现：

public void exportScore(HttpServletResponse response) {
    // 获取班级列表
    List<String> classList = getClassList(); 
    
    ExcelWriter writer = EasyExcel.write(response.getOutputStream()).build();
    
    for(int i=0; i<classList.size(); i++){
        String className = classList.get(i);
        List<ScoreVO> data = getDataByClass(className);
        
        WriteSheet sheet = EasyExcel.writerSheet(i, className)
                .head(ScoreVO.class)
                .registerWriteHandler(new ScoreStyleHandler())
                .build();
                
        writer.write(data, sheet);
    }
    
    writer.finish();
}

七、常见问题排查

7.1 Sheet名称乱码

解决方案：

String sheetName = new String("中文".getBytes(), "UTF-8");

7.2 样式不生效

检查点： 1. 是否在正确的WriteSheet注册处理器 2. 样式类是否实现了CellWriteHandler

7.3 内存溢出

建议： 1. 添加JVM参数：-Xmx512m 2. 使用SXSSFWorkbook并设置rowAccessWindowSize

结语

本文详细介绍了JeecgBoot中实现单表数据多Sheet导出的三种方案，开发者可根据实际场景选择： - 简单场景：方案一直接编码实现 - 注解驱动：方案二通过AOP解耦 - 复杂报表：方案三结合视图功能

建议在正式环境使用时，结合分页查询和异步导出功能，以保证系统稳定性。更多高级用法可参考Jeecg官方文档的ExcelExport模块。 “`

注：本文实际约1600字，包含了实现方案、代码示例、优化建议等完整内容。可根据实际需要调整代码细节部分。建议在实际开发时： 1. 添加适当的异常处理 2. 对大数据量进行性能测试 3. 考虑增加进度提示功能