springboot集成easypoi并使用其模板导出功能和遇到的坑

1.背景

最近在做个使用poi导出excel的需求，由于所需要的excel较为复杂，所以我准备使用easypoi的模板导出功能去实现

2.使用

2.1 集成

  <!--excel-->
        <!--这里如果直接引入easypoi集成springboot的包即easypoi-spring-boot-starter，
那么启动需要spring-boot-starter-web，而不是spring-boot-starter-->
        <dependency>
            <groupId>cn.afterturn</groupId>
            <artifactId>easypoi-spring-boot-starter</artifactId>
            <version>4.1.2</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

使用起来很简单，我就使用测试数据来说明我遇到的坑：

模板如下图所示

数据回显：

3 .坑

3.1 文档上说使用$fe循环时，可以定义item的名称，但是我实际操作发现，这是不行的，不能去定义t，或者将其命名为其他字符，否则展示不出来，下图就是错误的师范

正确写法：只能写成如下所示的写法：

3.2 写循环的时候注意只能单行或单列，不能合并单元格，否则效果不会是你想要的

如下图：合并了纵向的单元格

出来的效果是：

即只有遍历的第一行和最后一行格式正确，中间的都不正确，中间的都是按照单行去遍历的

合并列也是一样的：模板如下

出来的格式：

即只有第一行正确，其他行都是按照单列去处理的

所以在遍历时一定要注意不要去合并单元格，如果你就是想合并单元格，那继续往下看

3.3 遍历的列中不能有空单元格

这样就是错误的，如果你真不想有内容，就使用&NULL&去代替。如下图

3.4 遍历合并单元格

那遍历完后如果我想合并单元格怎么做呢？使用

PoiMergeCellUtil这个类的方法即可，通过mergeCells（合并行单元格）或addMergedRegion（合并列单元格或合并某个区域）方法去合并单元格

3.5 遍历中使用常量

如果在遍历中你想有一列是固定的某些字符串，那么你就需要使用单引号，如下图所示：

注意：在单元格中输入单引号时，一定要在第一个单引号前使用一下空格键，如果不使用空格键，保存后虽然上面的文本中有单引号，但是单元格中的就只剩后面一个单引号了，这就是有问题的。

4.多层循环的bug

使用模板多层循环的功能时，发现有一个bug：

我的模板如下：

h是一个list集合，装有map对象，然后map里面有3个key，in1,in2,in3,循环出来后的结果：

其他行都是正确的，唯独第一行，不知道为什么就少了，我看数据也没有问题，所以这个问题我是没有解决的

但是我发现使用fe或!fe去遍历数据是对的，但是又会有一个问题，如果你的list数据下还存在数据，那么就会被覆盖，如下图所示：

可以看到，上面的第三行直接被覆盖了，这肯定就有问题了，所以使用这种方法的话，前提是你要能确定这个list到底有多少行，然后，在下面去添加其他的数据，如我知道这个list就到10行，那么我将数据写到第11行的位置：

这时候我再遍历就没问题了

但是这种办法显然没啥用，因为在遍历时，很难在模板中去确定list有多少行数据 ,所以能解决的朋友，分享下解决方法咯

5.代码

@Test
    public void a () throws  Exception{
        Map<String, Object> map = new HashMap<>();
        map.put("a","我是");
        map.put("b", "谁是");
        map.put("c","疯了");

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

        List<Map<String, Object>> inList = new ArrayList<>();
        Map<String, Object> map5 = new HashMap<>();
        map5.put("in1","我是4");
        map5.put("in2", "谁是5");
        map5.put("in3","疯了6");
        Map<String, Object> map6 = new HashMap<>();
        map6.put("in1","我是4");
        map6.put("in2", "谁是5");
        map6.put("in3","疯了6");
        Map<String, Object> map7 = new HashMap<>();
        map7.put("in1","我是4");
        map7.put("in2", "谁是5");
        map7.put("in3","疯了6");
        inList.add(map5);
        inList.add(map6);
        inList.add(map7);

        Map<String, Object> map1 = new HashMap<>();
        map1.put("e","我是1");
        map1.put("f", "谁是2");
        map1.put("g","疯了3");
        map1.put("h",inList);

        Map<String, Object> map2 = new HashMap<>();
        map2.put("e","我是4");
        map2.put("f", "谁是5");
        map2.put("g","疯了6");
        map2.put("h",inList);
        Map<String, Object> map4 = new HashMap<>();
        map4.put("e","我是4");
        map4.put("f", "谁是5");
        map4.put("g","疯了6");
        map4.put("h",inList);

        list.add(map1);
        list.add(map2);
        list.add(map4);
        map.put("d",list);
        File file = ResourceUtils.getFile(ResourceUtils.CLASSPATH_URL_PREFIX + "test.xls");
        TemplateExportParams params = new TemplateExportParams(
                file.getPath());
        Workbook workbook = ExcelExportUtil.exportExcel(params, map);
        // 这里写合并单元格的代码，我的测试中没有去写这个
        // PoiMergeCellUtil.mergeCells(workbook.getSheetAt(0), 1, 0);

        File savefile = new File("D:/excel/");
        if (!savefile.exists()) {
            savefile.mkdirs();
        }
        FileOutputStream fos = new FileOutputStream("D:/excel/test_map.xls");
        workbook.write(fos);
        fos.close();
    }