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

news/2024/5/19 9:07:31/文章来源:https://blog.csdn.net/qq_30859353/article/details/126625957

文章目录

前言
一、基于@Excel的 isColumnHidden 属性
- 1.1 实现原理
- 1.2 实现步骤
- 1.3 实现效果
二. 基于List< ExcelExportEntity > 的导出
- 2.1 实现效果
总结

前言

嗨，大家好，我是希留。

项目里使用的是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("名单", "名单"));}