JeecgBoot中实现多Sheet的Map数据导出方案

概述

在JeecgBoot 3.6.1版本中，系统提供了强大的Excel导出功能，支持基于实体类的数据导出。但在实际业务场景中，我们经常需要导出多个Sheet页，且每个Sheet页的数据结构可能不同，使用Map数据结构比实体类更加灵活。本文将详细介绍如何在JeecgBoot框架中实现多Sheet的Map数据导出。

核心实现原理

JeecgBoot的Excel导出功能基于Spring MVC的视图解析机制，通过NormalExcelConstants类提供了一系列常量来配置导出参数。对于多Sheet导出，关键在于构建正确的MAP_LIST参数，其中每个Sheet对应一个Map配置。

具体实现步骤

1. 准备导出数据

首先需要为每个Sheet准备两个核心数据：

• 数据列表：List<Map<String, Object>>格式
• 表头映射：定义Excel列名与数据key的对应关系

// 示例：准备第一个Sheet的数据
List<Map<String, Object>> sheet1Data = new ArrayList<>();
Map<String, Object> row1 = new HashMap<>();
row1.put("name", "张三");
row1.put("age", 25);
sheet1Data.add(row1);

// 表头映射
Map<String, String> sheet1Header = new HashMap<>();
sheet1Header.put("name", "姓名");
sheet1Header.put("age", "年龄");

2. 构建导出参数

每个Sheet需要构建一个包含以下参数的Map：

Map<String, Object> sheet1Params = new HashMap<>();
// 表头标题
sheet1Params.put("title", "员工信息");
// 表头映射
sheet1Params.put("entity", sheet1Header);
// 数据列表
sheet1Params.put("data", sheet1Data);

3. 组装多Sheet导出配置

将所有Sheet的配置放入List中：

List<Map<String, Object>> exportParamList = new ArrayList<>();

Map<String, Object> sheet1Map = new HashMap<>();
sheet1Map.put(NormalExcelConstants.PARAMS, sheet1Params);
sheet1Map.put(NormalExcelConstants.DATA_LIST, sheet1Data);
exportParamList.add(sheet1Map);

// 可以继续添加更多Sheet...

4. 控制器方法实现

在Controller中设置导出参数并返回视图：

@RequestMapping("/exportExcel")
public ModelAndView exportExcel() {
    ModelMap modelMap = new ModelMap();
    
    // 设置文件名
    modelMap.put(NormalExcelConstants.FILE_NAME, "多Sheet导出示例");
    
    // 设置多Sheet配置
    modelMap.put(NormalExcelConstants.MAP_LIST, exportParamList);
    
    return new ModelAndView(new JeecgMapExcelView(), modelMap);
}

高级配置选项

自定义列顺序

如果需要控制列的顺序，可以使用LinkedHashMap：

Map<String, String> orderedHeader = new LinkedHashMap<>();
orderedHeader.put("id", "ID");
orderedHeader.put("name", "姓名");
orderedHeader.put("age", "年龄");

设置Sheet名称

默认情况下Sheet会按顺序命名，也可以自定义：

sheet1Params.put("sheetName", "员工信息表");

数据类型格式化

可以在数据准备阶段进行格式化：

row1.put("birthday", DateFormatUtils.format(birthDate, "yyyy-MM-dd"));

常见问题解决

1. 表头不显示：确保在PARAMS中正确设置了entity映射
2. 数据错位：检查Map中的key是否与表头映射一致
3. 性能问题：大数据量导出建议分批次查询

总结

JeecgBoot框架提供了灵活的多Sheet导出机制，通过Map数据结构可以避免为每个导出场景创建实体类，大大提高了开发效率。掌握这种导出方式后，可以应对各种复杂的Excel导出需求，特别是那些数据结构不固定或需要动态生成的场景。