优雅的实现EasyPoi动态导出列的两种方式

---

前言

嗨，大家好，我是希留。

项目里使用的是EasyPoi来处理导入导出功能的。近日因业务需求调整，一些导出功能的导出列需要根据不同的条件动态导出。一开始为了图方便，使用的是土方法，即创建多个不同的实体类，每个实体类对应不同的列。这样虽说能实现，但实在不想多复制实体类，把代码堆的和shi山一样。于是查看官方文档，里面确实提供了更加优雅的实现方式。废话不多说，开整。

---

一、基于@Excel的 isColumnHidden 属性

我们项目使用的是注解方式导出，只需要在属性上增加@Excel注解，就可以导出该属性列。默认大家都会使用了，不会使用的出门右转去官网教程看看demo。

要动态导出列，我们需要用到 isColumnHidden 这个属性。

可以看到，isColumnHidden中提供的默认值是false，也就是默认全部导出，不隐藏。把值设为true，导出就没有该列了。所以这个问题就变成，导出要想动态显示哪些列，只需要动态设置 isColumnHidden 的值 就可以实现。

1.1 实现原理

JAVA反射机制是在运行状态中，对于任意一个实体类，都能够知道这个类的所有属性和方法；对于任意一个对象，都能够调用它的任意方法和属性；这种动态获取信息以及动态调用对象方法的功能称为java语言的反射机制。

利用 JAVA反射机制。根据反射机制，我们可以拿到一个类的所有属性和方法，同理，注解也是一个类，也是可以拿到它的属性和方法，拿到之后就好办了，直接修改它的默认值，然后根据不同的条件调整，就可以达到一个类实现动态导出的目的。

1.2 实现步骤

先创建一个工具类，传入对象，获取注解值，并修改。

代码如下（示例）：

/**
 * @description  动态显示Excel导出列
 * @date 2022/8/31
 */
public class EasyPoiUtil<T> {

    /**
     * 需要被反射的对象，使用泛型规范传入对象
     */
    public T t;

    public void hiddColumn(String columnName, Boolean target) throws Exception {
        if (t == null) {
            throw new ClassNotFoundException("TARGET OBJECT NOT FOUNT");
        }
        if (StringUtils.isEmpty(columnName)) {
            throw new NullPointerException("COLUMN NAME NOT NULL");
        }
        if (target == null) {
            target = true;
        }
        // 获取目标对象的属性值
        Field field = t.getClass().getDeclaredField(columnName);
        // 获取注解反射对象
        Excel excelAnnon = field.getAnnotation(Excel.class);
        // 获取代理
        InvocationHandler invocationHandler = Proxy.getInvocationHandler(excelAnnon);
        Field excelField = invocationHandler.getClass().getDeclaredField("memberValues");
        // 因为这个字段是 private final 修饰，所以要打开权限
        excelField.setAccessible(true);
        Map memberValues = (Map) excelField.get(invocationHandler);
        memberValues.put("isColumnHidden", target);
    }
}

然后在需要导出的数据中更改对应条件能看到的列，这里以实际项目里的代码为例

public List<ExportVo> batchLiveUserExport(LiveUser liveUser) {
        List<ExportVo> voList = baseMapper.batchLiveUserExport(liveUser);
        LiveInfo liveInfo = liveInfoService.getById(liveUser.getLiveId());
        if (liveInfo != null) {
            LiveSpecial liveSpecial = liveSpecialService.getById(liveInfo.getSpecialId());
            if ("2".equals(liveSpecial.getLivePlatform())) {
                setHiddColumn(voList,true);
            } else {
                setHiddColumn(voList,false);
            }
        }
        return voList;
    }

    private void setHiddColumn(List<ExportVo> list, Boolean value) {
        if (CollectionUtil.isNotEmpty(list)) {
            for (ExportVo vo : list) {
                EasyPoiUtil<ExportVo> easyPoiUtil = new EasyPoiUtil<>();
                easyPoiUtil.t = vo;
                // 是否导出 参与状态 一列  true 导出   false 不导出
                try {
                    easyPoiUtil.hiddColumn("isJoin", value);
                } catch (Exception e) {
                    e.printStackTrace();
                }
            }
        }
    }

1.3 实现效果

可以看到导出的表格，“参与状态”一列，是根据条件动态显示了。（其实也全部导出了，只是隐藏了列，通过Execl里的设置还是可以显示隐藏列的，对这点有要求的此方式或者不适用）

二. 基于List< ExcelExportEntity > 的导出

上面说到，利用@Execl的 isColumnHidden 属性动态设置值，只是在导出时隐藏了该列而已，实际上也还是全部导出了。

要彻底的不导出，官方也给出了解决方案：基于List< ExcelExportEntity> 的导出

ExcelExportEntity是注解经过处理翻译成的实体类，两者几乎是一对的，所以如果我们要动态自定义导出列，只要动态拼装ExcelExportEntity就可以了

例如上面的栗子，我们只导出 “姓名”，“学号”，“手机号”，"通知状态"四列， 代码如下（示例）：

   /**
     * 根据条件动态生成列信息
     **/
    private List<ExcelExportEntity> dynaCol(String type) {
        List<ExcelExportEntity> colList = new ArrayList<ExcelExportEntity>();
        colList.add(new ExcelExportEntity("姓名", "realName"));
        colList.add(new ExcelExportEntity("学号", "studNo"));
        if ("2".equals(type)) {
            colList.add(new ExcelExportEntity("手机号", "phoneNumber"));
            ExcelExportEntity excelentity = new ExcelExportEntity("通知状态", "isSms");
            // 值替换
            String[] isSmsReplace = {"未发送_N", "已发送_Y","_null"};
            excelentity.setReplace(isSmsReplace);
            colList.add(excelentity);
        }
        return colList;
    }
    /**
     * 导出 伪代码
     **/
    @GetMapping(value = "batchExport")
    public void batchExport(LiveUser liveUser, HttpServletResponse response){
        // 查询出导出的结果集
        List<LiveUserExportVo> liveUsers = liveUserService.batchLiveUserExport(liveUser);
        // 根据条件动态生成列信息
        List<ExcelExportEntity> beanList = dynaCol("2");
        // 导出
        ExcelUtil.exportExcelX(liveUsers, beanList,"名单.xls",  response,new ExportParams("名单", "名单"));
    }

2.1 实现效果

满足了只导出四列的要求。

---

总结

好了，以上就是本文的全部内容了。全文介绍了两种方式实现EasyPoi动态导出列，可以根据项目的实际情况看看能否用的上。

感谢您的阅读，若觉得本文对您有帮助的话，还不忘帮忙点赞、评论支持下下哟~