EasyExcel写入List＜Map＞数据

背景

在使用EasyExcel库进行数据写入时，通常我们会使用实体类来存储数据。但是当遇到动态查询，无法确定属性数量和名称时，就需要使用Map来接收数据。然而，直接将Map中的数据写入Excel表格并不是一件简单的事情。接下来，我将介绍如何使用EasyExcel库将Map数据写入Excel表格。

示例

以一个下载接口为例：

@Autowired
    HttpServletResponse response;

    @GetMapping("download")
    public void download(String title) throws IOException {
        //  excel 文件名定义
        String fileName = title + ".xlsx";
        // 下载接口响应内容定义
        response.setHeader("Charset", String.valueOf(StandardCharsets.UTF_8));
        response.setHeader("Content-Type", "application/octet-stream;charset=" + String.valueOf(StandardCharsets.UTF_8));
        response.setHeader("Content-Disposition", "attachment; filename="
                + URLEncoder.encode(fileName, String.valueOf(StandardCharsets.UTF_8)));

        // 正式写入excel数据
        // 第一步：先确定列名，也就是列标题，这个要和查出来的字段数量相一致,可以根据动态查询的字段动态生成
        String[] colums = new String[]{"姓名", "年龄"};
        List<List<String>> head = new ArrayList<>(colums.length);
        for (String colum : colums) {
            List<String> list = new ArrayList(1);
            list.add(colum);
            head.add(list);
        }
        // 创建模拟数据
        List<Map> maps = new ArrayList<>();
        Map<String, Object> map = new HashMap();
        map.put("name", "123");
        map.put("age", "456");
        maps.add(map);
        // 确定模拟数据key
        List<String> mapKey = map.keySet().stream().map(String::toString).collect(Collectors.toList());
        // 创建接收转换好数据的容器
        List<List<Object>> sheetData = new ArrayList<>();
        // 将模拟数据转换成需要的格式
        // 解释：map类型无法直接按照key值导入，需要转换成list类型的数据，依次导入
        for (Map m : maps) {
            List list = new ArrayList(mapKey.size());
            for (String colum : mapKey) {
                // valueOf是为了防止数据类型不一致导致报错，需要特殊表格类型的自行解决
                list.add(String.valueOf(m.get(colum)));
            }
            sheetData.add(list);
        }
        // 到这里就可以直接写入数据了
        // 写入数据流，设置表头，设置自适应表头宽度
        EasyExcel.write(
                        response.getOutputStream())         // 响应的数据流
                        .head(head)                         // 设置列标题
                        .needHead(true)                     // 表示需要生成列标题
                        .sheet(title)                       // sheet页的名称，可省略
                        //.table()                          // 没用到推荐不写，如果写了则会生成双标题
                        //.registerWriteHandler(new SimpleColumnWidthStyleStrategy(50)) // 设置自定义列宽
                        .registerWriteHandler(new LongestMatchColumnWidthStyleStrategy())// 设置自适应列宽
                        .doWrite(sheetData);                // 将数据写入
    }

我这里是创建了模拟数据 List

mybatis:
  configuration:
    call-setters-on-nulls: true

总结：

使用EasyExcel写入map数据的关键点在于map在被写入时，进行类解析时解析出来的是map的属性，而不是key值，所以无法直接进行导入，所以只有将map转换成 List<List> 类型才能顺利导入，每个List代表一行数据，通过列标题的下标取List中指定下标的数据进行填充。

注：这里没有考虑转换性能消耗的问题，数据量过大或者速度过慢或者内存占用过大需要自行改动，仅针对map数据如何导入进行示例。