如何實現JeecgBoot單表數據導出多sheet

# 如何實現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 實現步驟

1. 創建multi_sheet_view視圖
2. 添加@ExcelCollection注解
3. 自定義導出處理器

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字，包含了實現方案、代碼示例、優化建議等完整內容?？筛鶕嶋H需要調整代碼細節部分。建議在實際開發時： 1. 添加適當的異常處理 2. 對大數據量進行性能測試 3. 考慮增加進度提示功能