Jeecg-Boot中实现多Sheet的Map数据导出方案

概述

在Jeecg-Boot 3.6.1版本中，系统提供了强大的Excel导出功能，支持多Sheet页导出。本文将详细介绍如何使用Map数据结构来实现多Sheet页的Excel导出功能，相比实体类导出方式，Map方式更加灵活，适用于动态数据结构场景。

核心实现原理

Jeecg-Boot的Excel导出功能基于Spring MVC的视图解析机制，通过NormalExcelConstants.JEECG_EXCEL_VIEW视图实现。多Sheet导出需要构建一个包含多个Sheet配置的列表，每个Sheet可以独立配置参数、数据源和映射关系。

具体实现步骤

1. 准备导出数据

首先需要准备一个List<Map<String, Object>>集合，每个Map代表一个Sheet页的配置：

List<Map<String, Object>> exportParamList = Lists.newArrayList();

2. 构建每个Sheet的配置

对于每个Sheet页，需要构建包含以下三个关键参数的Map：

Map<String, Object> valueMap = Maps.newHashMap();
valueMap.put(NormalExcelConstants.PARAMS, view.getExportParams());  // 导出参数
valueMap.put(NormalExcelConstants.DATA_LIST, view.getDataList());  // 数据列表
valueMap.put(NormalExcelConstants.CLASS, view.getCls());          // 映射类
exportParamList.add(valueMap);

3. 设置导出文件名

在ModelMap中设置导出文件名：

modelMap.put(NormalExcelConstants.FILE_NAME, new DateTime().toString("yyyyMMddHHmmss"));

4. 设置多Sheet配置

将准备好的多Sheet配置列表放入ModelMap：

modelMap.put(NormalExcelConstants.MAP_LIST, exportParamList);

5. 返回视图

最后返回Jeecg的Excel视图：

return NormalExcelConstants.JEECG_EXCEL_VIEW;

完整示例代码

// 准备导出参数列表
List<Map<String, Object>> exportParamList = Lists.newArrayList();

// 获取业务数据（根据实际情况调整）
ExportMoreView moreView = this.getBaseTransferService().mergeExportView(templateTypeCode);

// 迭代导出对象，配置每个Sheet页
for(ExportView view : moreView.getMoreViewList()) {
    Map<String, Object> valueMap = Maps.newHashMap();
    valueMap.put(NormalExcelConstants.PARAMS, view.getExportParams());
    valueMap.put(NormalExcelConstants.DATA_LIST, view.getDataList());
    valueMap.put(NormalExcelConstants.CLASS, view.getCls());
    exportParamList.add(valueMap);
}

// 设置导出文件名
modelMap.put(NormalExcelConstants.FILE_NAME, new DateTime().toString("yyyyMMddHHmmss"));

// 设置多Sheet配置
modelMap.put(NormalExcelConstants.MAP_LIST, exportParamList);

// 返回Excel视图
return NormalExcelConstants.JEECG_EXCEL_VIEW;

注意事项

1. 数据格式：确保view.getDataList()返回的是Map列表，每个Map代表一行数据，key对应表头

2. 映射配置：view.getExportParams()应包含表头与数据key的映射关系

3. 性能考虑：大数据量导出时，建议分批处理数据，避免内存溢出

4. 样式定制：如需自定义样式，可通过ExportParams设置

扩展应用

这种多Sheet导出方式特别适用于以下场景：

• 需要导出多个关联数据表
• 数据结构动态变化的报表
• 需要将不同类型数据分开展示的场景
• 需要为每个Sheet设置不同表头的复杂报表

通过灵活运用Jeecg-Boot提供的多Sheet导出功能，开发者可以轻松实现各种复杂的Excel导出需求，提高开发效率。