当前位置： 首页 > news >正文

sql2java-excel(二):基于apache poi实现数据库表的导出的spring web支持

news 来源：原创 2024/5/5 20:01:48

sql2java是我几年年开始写的一个sql2java是一个轻量级数据库(SQL)访问代码(java)生成器。这几年一直在根据工作需要维护升级，最近的项目中需要对数据库的记录提供导出excel的功能。
就开始学习apache的POI，参照网上的示例实现了单张表的导出。并进一步将它封装成一个通用库成为sql2java下的子项目sql2java-excel.以方便在其他项目中技术复用。
本文开始介绍sql2java-excel的使用spring 支持的部分

Spring Web导出

快速入门

以下是基于Spring Web的数据库导出最简示例：

import static gu.sql2java.Managers.instanceOf;

@RestController
@Api(value="ExcelController",tags={"Excel Export Controller"})
public class ExcelController {
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
    @ApiOperation(value = "导出设备列表", notes = "",httpMethod="GET",produces=MediaType.APPLICATION_OCTET_STREAM_VALUE)
    @RequestMapping(method=RequestMethod.GET, value="/ExcelController/exportDevices")
	public void exportDevices(HttpServletResponse response) throws IOException {
		response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
		SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyy-MM-dd_HHmmss");
		String currentDateTime = dateFormatter.format(new Date());
		/** 设置下载文件文件名 */
		String headerKey = "Content-Disposition";
		String headerValue = "attachment; filename=device_" + currentDateTime + ".xlsx";
		response.setHeader(headerKey, headerValue);
		/** 从数据库中获取记录 **/
		List<DeviceBean> beans = instanceOf(IDeviceManager.class).loadAllAsList();
		ExcelGenerator<DeviceBean> generator = new ExcelGenerator<DeviceBean>(beans){};
        /** 输出到 http response */ 
		generator.generate(response);
	}

}

自定义导出配置

以下是基于Spring Web的数据库导出示例，与前一个示例不同的就是增加了通过SheetConfig对象设置excel 导出配置参数：

import static gu.sql2java.Managers.instanceOf;

@RestController
@Api(value="ExcelController",tags={"Excel Export Controller"})
public class ExcelController {
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
    @ApiOperation(value = "导出设备列表", notes = "",httpMethod="GET",produces=MediaType.APPLICATION_OCTET_STREAM_VALUE)
    @RequestMapping(method=RequestMethod.GET, value="/ExcelController/exportDevices")
	public void exportDevices(HttpServletResponse response) throws IOException {
		response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
		SimpleDateFormat dateFormatter = new SimpleDateFormat("yyyy-MM-dd_HHmmss");
		String currentDateTime = dateFormatter.format(new Date());
		/** 设置下载文件文件名 */
		String headerKey = "Content-Disposition";
		String headerValue = "attachment; filename=device_" + currentDateTime + ".xlsx";
		response.setHeader(headerKey, headerValue);
		/** 从数据库中获取记录 **/
		List<DeviceBean> beans = instanceOf(IDeviceManager.class).loadAllAsList();
		ExcelGenerator<DeviceBean> generator = new ExcelGenerator<DeviceBean>(beans){};
        /** excel 导出配置对象 */
        SheetConfig sheetConfig = generator.getSheetConfig();
        /** 设置exce表的标题 */
    	sheetConfig.setTitle("设备表记录");
        /** 设置输出字段列名,如果不指定则输出原始的英文字段名 */
        sheetConfig.configOf("physicalAddress").getColumnConfig().setName("物理地址");
    	sheetConfig.configOf("addressType").getColumnConfig().setName("地址类型");
    	sheetConfig.configOf("iotCard").getColumnConfig().setName("物联网卡编号");
    	sheetConfig.configOf("status").getColumnConfig().setName("设备状态").setReadConverterExp("ENABLE=正常,DISABLE=禁用,MAINTAIN=维护,PENDING=挂起(待审核)");
    	sheetConfig.configOf("fixedMode").getColumnConfig().setName("安装方式").setReadConverterExp("HANG=悬挂,FLOOR=落地");
    	sheetConfig.configOf("name").getColumnConfig().setName("设备名称");
    	sheetConfig.configOf("groupId").getColumnConfig().setName("设备组ID");
    	sheetConfig.configOf("model").getColumnConfig().setName("设备型号");
    	sheetConfig.configOf("vendor").getColumnConfig().setName("设备供应商");
    	sheetConfig.configOf("osArch").getColumnConfig().setName("操作系统平台");
    	sheetConfig.configOf("versionInfo").getColumnConfig().setName("版本");
    	sheetConfig.configOf("planId").getColumnConfig().setName("当前节目ID");
    	sheetConfig.configOf("targetId").getColumnConfig().setName("目标节目ID");
    	sheetConfig.configOf("screenInfo").getColumnConfig().setName("屏幕信息").setHandler(ScreenInfoFormatter.class);
    	sheetConfig.configOf("createTime").getColumnConfig().setName("记录创建时间");
    	sheetConfig.configOf("updateTime").getColumnConfig().setName("记录更新时间");
    	sheetConfig.configOf("remark").getColumnConfig().setName("备注");
        /** 设置子成员输出字段名 */
    	sheetConfig.addNestedColumn("props.last_active_time","上次在线时间");
    	sheetConfig.addNestedColumn("props.disk_capacity","磁盘容量");
    	sheetConfig.addNestedColumn("props.network","网络连接类型");
    	sheetConfig.addNestedColumn("props.status_comment","状态变更说明");
    	sheetConfig.addNestedColumn("device_detail.device_name","产品名称");
    	sheetConfig.addNestedColumn("device_detail.manufacturer","制造商");
    	sheetConfig.addNestedColumn("device_detail.made_date","生产日期");
        /** 设置不需要导出的隐藏字段 */
    	sheetConfig.setHideColumns("props","token_time","device_detail");
        /** 输出到 http response */ 
		generator.generate(response);
	}
}

Spring AOP导出

启用aspect

excelGenerator支持Spring AOP(切面),需要如下在@ComponentScan注解中增加包名gu.sql2java.excel.aspect,才能让spring扫描到excelGenerator的切面导出实现类

@SpringBootApplication
@ComponentScan({"net.facelib.eam.devicecenter","net.facelib.eam.web.handler","gu.sql2java.excel.aspect"})
public class RestfulService {
	//
}

快速入门

通过对服务方法增加@ExcelSheet注解,就可以实现数据库记录的Excel导出.

  • 要求服务方法的返回类型为Collection,Set,List以及任何实现了java.lang.Iterable接口的可迭代容器
  • 要求容器元素类型为Map或Java Bean(fastjson的JSONObject也属于Map)
  • 不限制HTTP method的类型，可以是POST，也可以是GET

以下是基于Spring AOP的数据库导出最简示例：

.	/** 
	 * 设备表导出EXCEL<br>
	 */
	@ExcelSheet()
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
	@ApiOperation(value = "设备表导出EXCEL", notes = "设备表导出EXCEL",httpMethod="GET",produces="application/octet-stream")
    @RequestMapping(method=RequestMethod.GET,produces={"application/octet-stream")
	public List<JSONObject> exportDevices() {
		return instanceOf(IDeviceManager.class).loadAllAsList();

	}

Excel输出配置

如果需要对导出的EXCEL进行配置(标题,列名,字体等等),可以通过在服务方法中增加注解来实现,基于上面的示例在exportDevices方法中增加@ExcelSheet注解对Excel 输出的全局参数进行配置，增加 @ExcelColumn注解对各个输出字段进行配置

	/** 
	 * 设备表导出EXCEL<br>
	 */
	@ExcelSheet(title="设备表记录",
			fileNamePrefix = "device_",
			hideColumns={"props","token_time","device_detail"},
			defaultIncludeColumns={"id","provinces","city","top_group_name","name",
					"physicalAddress","addressType","iotCard","network","screenInfo","fixedMode","model","osArch","versionInfo",
					"status","props.disk_capacity","props.last_active_time","createTime","remark"})
	@ExcelColumn(columnName="physicalAddress",name="物理地址")
	@ExcelColumn(columnName="addressType",name="地址类型")
	@ExcelColumn(columnName="iotCard",name="物联网卡编号")
	@ExcelColumn(columnName="status",name="设备状态",readConverterExp="ENABLE=正常,DISABLE=禁用,MAINTAIN=维护,PENDING=挂起(待审核)")
	@ExcelColumn(columnName="fixedMode",name="安装方式",readConverterExp="HANG=悬挂,FLOOR=落地")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="groupId",name="设备组ID")
	@ExcelColumn(columnName="provinces",name="省/自治区/直辖市")
	@ExcelColumn(columnName="city",name="市")
	@ExcelColumn(columnName="top_group_name",name="设备组名称")
	@ExcelColumn(columnName="screenInfo",name="屏幕信息")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="model",name="设备型号")
	@ExcelColumn(columnName="vendor",name="设备供应商")
	@ExcelColumn(columnName="osArch",name="操作系统平台")
	@ExcelColumn(columnName="network",name="网络连接类型")
	@ExcelColumn(columnName="versionInfo",name="版本")
	@ExcelColumn(columnName="planId",name="当前节目ID")
	@ExcelColumn(columnName="targetId",name="目标节目ID")
	@ExcelColumn(columnName="createTime",name="记录创建时间")
	@ExcelColumn(columnName="updateTime",name="记录修改时间")
	@ExcelColumn(columnName="remark",name="备注")
	@ExcelColumn(columnName="props.last_active_time",name="上次在线时间")
	@ExcelColumn(columnName="props.disk_capacity",name="磁盘容量")
	@ExcelColumn(columnName="props.status_comment",name="状态变更说明")
	@ExcelColumn(columnName="device_detail.device_name",name="产品名称")
	@ExcelColumn(columnName="device_detail.manufacturer",name="制造商")
	@ExcelColumn(columnName="device_detail.made_date",name="生产日期")
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
	@ApiOperation(value = "设备表导出EXCEL", notes = "设备表导出EXCEL",httpMethod="GET",produces="application/octet-stream")
    @RequestMapping(method=RequestMethod.GET,produces="application/octet-stream")
	public List<DeviceBean> exportDevices() {
		return instanceOf(IDeviceManager.class).loadAllAsList();
	}

Web端控制输出格式

Spring AOP方式导出Excel也支持Web端通过请求参数控制Excel的输出格式，这种方式要求服务方法定义与@ExcelSheet注解中对应的方法名同名的参数，切面执行时会自动将这些参数注入到@ExcelSheet注解中。

基于上面的exportDevices服务方法改造示例如下：

	/** 
	 * 设备表导出EXCEL<br>
	 */
	@ExcelSheet(title="设备表记录",
			fileNamePrefix = "device_",
			hideColumns={"props","token_time","device_detail"},
			defaultIncludeColumns={"id","provinces","city","top_group_name","name",
					"physicalAddress","addressType","iotCard","network","screenInfo","fixedMode","model","osArch","versionInfo",
					"status","props.disk_capacity","props.last_active_time","createTime","remark"})
	@ExcelColumn(columnName="physicalAddress",name="物理地址")
	@ExcelColumn(columnName="addressType",name="地址类型")
	@ExcelColumn(columnName="iotCard",name="物联网卡编号")
	@ExcelColumn(columnName="status",name="设备状态",readConverterExp="ENABLE=正常,DISABLE=禁用,MAINTAIN=维护,PENDING=挂起(待审核)")
	@ExcelColumn(columnName="fixedMode",name="安装方式",readConverterExp="HANG=悬挂,FLOOR=落地")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="groupId",name="设备组ID")
	@ExcelColumn(columnName="provinces",name="省/自治区/直辖市")
	@ExcelColumn(columnName="city",name="市")
	@ExcelColumn(columnName="top_group_name",name="设备组名称")
	@ExcelColumn(columnName="screenInfo",name="屏幕信息")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="model",name="设备型号")
	@ExcelColumn(columnName="vendor",name="设备供应商")
	@ExcelColumn(columnName="osArch",name="操作系统平台")
	@ExcelColumn(columnName="network",name="网络连接类型")
	@ExcelColumn(columnName="versionInfo",name="版本")
	@ExcelColumn(columnName="planId",name="当前节目ID")
	@ExcelColumn(columnName="targetId",name="目标节目ID")
	@ExcelColumn(columnName="createTime",name="记录创建时间")
	@ExcelColumn(columnName="updateTime",name="记录修改时间")
	@ExcelColumn(columnName="remark",name="备注")
	@ExcelColumn(columnName="props.last_active_time",name="上次在线时间")
	@ExcelColumn(columnName="props.disk_capacity",name="磁盘容量")
	@ExcelColumn(columnName="props.status_comment",name="状态变更说明")
	@ExcelColumn(columnName="device_detail.device_name",name="产品名称")
	@ExcelColumn(columnName="device_detail.manufacturer",name="制造商")
	@ExcelColumn(columnName="device_detail.made_date",name="生产日期")
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
	@ApiOperation(value = "设备表导出EXCEL", notes = "设备表导出EXCEL",httpMethod="GET",produces="application/octet-stream,application/json")
    @RequestMapping(method=RequestMethod.GET,produces={"application/octet-stream","application/json"})
	public List<DeviceBean> exportDevices(Integer getParameter, String exportFileName, 
			String sheetName, 
			String title, String titleFontName, Integer titleFontHeight, IndexedColors titleFontColor, IndexedColors titleFillColor, HorizontalAlignment titleHorizontalAlign, 
			String headerFontName, Integer headerFontHeight, IndexedColors headerFontColor, IndexedColors headerFillColor, HorizontalAlignment headerHorizontalAlign, Boolean firstBold, 
			Integer fontHeight, String fontName, IndexedColors fontColor, IndexedColors fillColor, HorizontalAlignment horizontalAlign, 
			String integralFormat, String dateTimeFormat, String dateFormat, String timeFormat, String timestampFormat, 
			List<String> includeColumns, List<String> excludeColumns) {
		return instanceOf(IDeviceManager.class).loadAllAsList();
	}

完整示例代码参见：
https://gitee.com/l0km/sql2java/blob/master/sql2java-excel/src/test/java/gu/sql2java/excel/ExcelExportTest.java

请求参数说明

所有的请求参数都不是必须定义的，应用层根据需要决定允许哪些参数被Web端控制就定义对应的参数。

请求参数定义的顺序也没有要求，但参数名必须与@ExcelSheet中对应的方法名一致才有效，类型也必须一致，对于枚举类型的参数，类型为String,切面执行时会自动将枚举变量名字符串转为枚举类型变量。

参数名类型默认值说明
getParameterInteger为null时,输出Excel数据, 前端的Response Content Type需要设置为application/octet-stream,不为null时,根据getParameter的值返回JSON格式的结果,Response Content Type需要设置为application/json，参见后面的getParameter 参数值说明。
exportFileNameString指定导出的excel文件名,不指定则自动以日期命名
sheetNameStringexportedExcelexcel Sheet名字
titleString标题,为null或空不输出标题
titleFontNameStringCalibri标题字体名
titleFontHeightInteger32标题字体高度
titleFontColorIndexedColorsBLACK标题字体颜色
titleFillColorIndexedColorsWHITE标题单元背景填充颜色
titleHorizontalAlignHorizontalAlignmentCENTER标题对齐方式
headerFontNameStringCalibri首行(字段名)字体名
headerFontHeightInteger16首行(字段名)字体高度
headerFontColorIndexedColorsBLACK首行(字段名)字体颜色
headerFillColorIndexedColorsWHITE单元背景填充颜色
headerHorizontalAlignHorizontalAlignmentCENTER首行对齐方式
firstBoldBooleantrue字体设置:true首行(字段名)字体加粗
fontHeightInteger16默认单元格字体高度
fontNameStringCalibri默认单元格字体名
fontColorIndexedColorsBLACK默认单元格字体颜色
fillColorIndexedColorsWHITE默认单元格背景填充颜色
horizontalAlignHorizontalAlignmentCENTER默认单元格水平对齐方式
integralFormatString0默认整数(Integer,Long,Short)格式
dateTimeFormatStringyyyy-MM-dd HH:mm:ss(java.util.Date)日期时间格式
dateFormatStringyyyy-MM-dd(java.sql.Date)日期格式
timeFormatStringHH:mm:ss(java.sql.Time)时间格式
timestampFormatStringyyyy-MM-dd’T’HH:mm:ss.SSSZ(java.sql.Timestamp)时间戳格式
includeColumnsList<String>{}字段输出白名单,在此名单中的字段会被输出,同时指定白名单和黑名单时以白名单为准,此名单为null则使用默认输出字段列表
excludeColumnsList<String>{}字段输出黑名单,在此名单中的字段不会被输出,同时指定白名单和黑名单时以白名单为准

getParameter 参数值说明

参数值说明
1返回所有可选的字段列表,参见SheetConfig#getAvailableColumns()
2返回默认输出的字段名及字段显示名称,参见SheetConfig#getDefaultExportColumns()
3返回默认输出的字段名,参见SheetConfig#getDefaultExportColumnNames()
其他抛出异常

produces设置

如果定义了getParameter参数,getParameter参数不为null时服务方法会返回JSON格式的数据，所以在@ApiOperation和@RequestMapping注解的produces字段需要增加内容类型application/json

与WhereHelper配合

SpringAOP导出支持@ExcelSheet与@EnableWhereHelper注解同时使用自动生成SELECT WHERE条件查询语句导出数据

基于上面的exportDevices服务方法改造示例如下：

	/** 
	 * 设备表导出EXCEL<br>
	 *  查询参数说明:
	 * <ul>
	 * <li>orderBy 排序字段名,格式:${字段1}[DESC|ASC]...,${字段N}[DESC|ASC]), 默认排序字段:id</li>
	 * <li>provinces        ----不为null时过滤设备所属顶级设备组的省份名称</li>
	 * <li>city        ----不为null时过滤设备所属顶级设备组的城市名称</li>
	 * <li>group_id 不为null时过滤grup_id(所属设备组id)字段</li>
	 * <li>status 不为null时过滤status(设备状态)字段,可用值:ENABLE:正常,DISABLE:禁用,MAINTAIN:维护,PENDING:挂起(待审核)</li>
	 * <li>address_type 不为null时过滤address_type(设备物理地址类型)字段(),可用值:MAC(网卡MAC地址),IMEI(国际移动设备识别码)</li>
	 * <li>physical_address 不为null时过滤physical_address(设备物理地址)字段,模糊匹配所有physical_address字段包含${physical_address}的记录</li>
	 * <li>iot_card 不为null时过滤iot_card(设备物联网卡编号)字段,模糊匹配所有iot_card字段包含${iot_card}的记录</li>
	 * <li>screen_info 不为null时过滤screen_info(设备屏幕信息)字段,模糊匹配所有screen_info字段包含${screen_info}的记录,格式示例:15H1080x960--15(英)寸横屏分辨率1080x960</li>
	 * <li>os_arch 不为null时过滤os_arch(操作系统名称及版本及硬件架构名称)字段,模糊匹配所有os_arch字段包含${os_arch}的记录,例如:Windows-x86_64,Linux-x86_64,Android-arm</li>
	 * <li>network   ----不为null时过滤network(设备网络连接类型)字段,目前支持类型:4G,WIFI,ETHERNET</li>
	 * <li>version_info 不为null时过滤version_info(设备端应用程序的版本号)字段,模糊匹配所有version_info字段包含${version_info}的记录</li>
	 * <li>model 不为null时过滤model(设备产品型号)字段,模糊匹配所有model字段包含${model}的记录</li>
	 * <li>vendor 不为null时过滤vendor(设备供应商)字段,模糊匹配所有vendor字段包含${vendor}的记录</li>
	 * <li>name 不为null时过滤设备名称字段,模糊匹配所有name字段包含${name}的记录</li>
	 * <li>create_time_max 不为null时过滤create_time(设备记录创建时间字段),查询所有create_time早于create_time_max的记录</li>
	 * <li>create_time_min 不为null时过滤create_time字段(设备记录创建时间),查询所有create_time晚于create_time_max的记录</li>
	 * <li>update_time_max 不为null时过滤update_time(设备记录更新时间字段),查询所有update_time早于update_time_max的记录</li>
	 * <li>update_time_min 不为null时过滤update_time(设备记录更新时间字段),查询所有update_time晚于update_time_max的记录</li>
	 * </ul>
	 */
	@ExcelSheet(title="设备表记录",
			fileNamePrefix = "device_",
			hideColumns={"props","token_time","device_detail"},
			defaultIncludeColumns={"id","provinces","city","top_group_name","name",
					"physicalAddress","addressType","iotCard","network","screenInfo","fixedMode","model","osArch","versionInfo",
					"status","props.disk_capacity","props.last_active_time","createTime","remark"})
	@ExcelColumn(columnName="physicalAddress",name="物理地址")
	@ExcelColumn(columnName="addressType",name="地址类型")
	@ExcelColumn(columnName="iotCard",name="物联网卡编号")
	@ExcelColumn(columnName="status",name="设备状态",readConverterExp="ENABLE=正常,DISABLE=禁用,MAINTAIN=维护,PENDING=挂起(待审核)")
	@ExcelColumn(columnName="fixedMode",name="安装方式",readConverterExp="HANG=悬挂,FLOOR=落地")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="groupId",name="设备组ID")
	@ExcelColumn(columnName="provinces",name="省/自治区/直辖市")
	@ExcelColumn(columnName="city",name="市")
	@ExcelColumn(columnName="top_group_name",name="设备组名称")
	@ExcelColumn(columnName="screenInfo",name="屏幕信息")
	@ExcelColumn(columnName="name",name="设备名称")
	@ExcelColumn(columnName="model",name="设备型号")
	@ExcelColumn(columnName="vendor",name="设备供应商")
	@ExcelColumn(columnName="osArch",name="操作系统平台")
	@ExcelColumn(columnName="network",name="网络连接类型")
	@ExcelColumn(columnName="versionInfo",name="版本")
	@ExcelColumn(columnName="planId",name="当前节目ID")
	@ExcelColumn(columnName="targetId",name="目标节目ID")
	@ExcelColumn(columnName="createTime",name="记录创建时间")
	@ExcelColumn(columnName="updateTime",name="记录修改时间")
	@ExcelColumn(columnName="remark",name="备注")
	@ExcelColumn(columnName="props.last_active_time",name="上次在线时间")
	@ExcelColumn(columnName="props.disk_capacity",name="磁盘容量")
	@ExcelColumn(columnName="props.status_comment",name="状态变更说明")
	@ExcelColumn(columnName="device_detail.device_name",name="产品名称")
	@ExcelColumn(columnName="device_detail.manufacturer",name="制造商")
	@ExcelColumn(columnName="device_detail.made_date",name="生产日期")
	/** 启用WhereHelper动态生成SQL语句 */
	@EnableWhereHelper(/* 设置调试输出 */debuglog=false)
	/** 定义WhereHelper生成SQL语句的表达式 */
	@OrderBy("id")
	@Equal("group_id")
	@Equal("status")
	@Equal("address_type")
	@Equal("network")
	@IfElse(test="!isEmpty(${provinces})",doStatement=" dgrp.provinces = '${provinces}'")
	@IfElse(test="!isEmpty(${city})",doStatement=" dgrp.city = '${city}'")
	@IfElse(test="!isEmpty(${name})",doStatement=" dc_device.name like '%${name}%'")
	@IfElse(test="!isEmpty(${physical_address})",doStatement=" physical_address like '%${physical_address}%'")
	@IfElse(test="!isEmpty(${iot_card})",doStatement=" iot_card like '%${iot_card}%'")
	@IfElse(test="!isEmpty(${screen_info})",doStatement=" screen_info like '%${screen_info}%'")
	@IfElse(test="!isEmpty(${os_arch})",doStatement=" os_arch like '%${os_arch}%'")
	@IfElse(test="!isEmpty(${version_info})",doStatement=" version_info like '%${version_info}%'")
	@IfElse(test="!isEmpty(${model})",doStatement=" model like '%${model}%'")
	@IfElse(test="!isEmpty(${vendor})",doStatement=" model like '%${vendor}%'")
	@IfElse(test="!isEmpty(${create_time_max})",doStatement=" dc_device.create_time <= '${create_time_max}'")
	@IfElse(test="!isEmpty(${create_time_min})",doStatement=" dc_device.create_time >= '${create_time_min}'")
	@IfElse(test="!isEmpty(${update_time_max})",doStatement=" dc_device.update_time <= '${update_time_max}'")
	@IfElse(test="!isEmpty(${update_time_min})",doStatement=" dc_device.update_time >= '${update_time_min}'")
	@Expression("dc_device.name !='$DUMMY_DEVICE_DONOT_DELETE$'")
	/** 
	 * 这里必须指定produces,否则swagger下载的excel文件不正确,
	 * 参见 <a href="https://blog.csdn.net/iuie_sl/article/details/114904170 ">《使用swagger api 下载excel，excel打不开》</a>
	 */
	@ApiOperation(value = "设备表导出EXCEL", notes = "设备表导出EXCEL",httpMethod="GET",produces="application/octet-stream,application/json")
    @RequestMapping(method=RequestMethod.GET,produces={"application/octet-stream","application/json"})
	public List<DeviceBean> exportDevices(Integer getParameter, String exportFileName, 
			String sheetName, 
			String title, String titleFontName, Integer titleFontHeight, IndexedColors titleFontColor, IndexedColors titleFillColor, HorizontalAlignment titleHorizontalAlign, 
			String headerFontName, Integer headerFontHeight, IndexedColors headerFontColor, IndexedColors headerFillColor, HorizontalAlignment headerHorizontalAlign, Boolean firstBold, 
			Integer fontHeight, String fontName, IndexedColors fontColor, IndexedColors fillColor, HorizontalAlignment horizontalAlign, 
			String integralFormat, String dateTimeFormat, String dateFormat, String timeFormat, String timestampFormat, 
			List<String> includeColumns, List<String> excludeColumns) {
		return instanceOf(IDeviceManager.class).loadByWhereAsList(PageHelper.getWhere());
	}

Map(JSON)类型记录指定导出配置

如下服务方法，从数据库读取的记录类型为sql2java生成的 DeviceBean,包含了@ExcelColumn,@ExcelSheet注解,但因为还需要为每条记录增加额外的数据字段，所以将DeviceBean对象转换成了JSONObject，服务方法服务方法返回的类型为JSONObject.

那么虽然原始的DeviceBean记录中是有@ExcelColumn,@ExcelSheet注解提供Excel导出配置的，但Excel 导出切面在执行过程中收到的数据记录类型为Map(JSONObject也是Map).所以这些@ExcelColumn,@ExcelSheet注解提供的Excel导出配置数据在数据类型转过程实际是被丢失了。

    @RequestMapping(method=RequestMethod.GET,produces={MediaType.APPLICATION_OCTET_STREAM_VALUE,MediaType.APPLICATION_JSON_VALUE})
	public List<JSONObject> exportDevices() {
        /** 从数据库读取的记录类型为sql2java生成的 DeviceBean,包含了@ExcelColumn,@ExcelSheet注解 */
		List<DeviceBean> beans = dm.daoLoadDeviceByJoinWhere("JOIN dc_device_group AS dgrp ON group_id = dgrp.id",PageHelper.getWhere());
        /** 将DeviceBean对象转换成了JSONObject,并根据需要添加了一些新的字段,服务方法返回的类型为JSONObject*/
		List<JSONObject> maps = Lists.transform(beans,l->dm.formatAsJson(l, dm.deviceFormater, false));
		return maps;

	}

为了解决数据类型转换而导致的原数据类型中@ExcelColumn,@ExcelSheet提供的Excel导出配置参数的丢失,excelGenerator的Spring AOP(切面)实现提供了在服务方法指定原始数据类型的机制，以允许服务方法通知切面执行时原始的数据类型是什么，这样切面执行时就可以从原始的数据类型中获取原数据类型中@ExcelColumn,@ExcelSheet提供的Excel导出配置参数。

修改上面的exportDevices方法，增加调用 ExcelHelperAround.setBeanClass方法指定原始数据类型

    @RequestMapping(method=RequestMethod.GET,produces={MediaType.APPLICATION_OCTET_STREAM_VALUE,MediaType.APPLICATION_JSON_VALUE})
	public List<JSONObject> exportDevices() {
		List<DeviceBean> beans = dm.daoLoadDeviceByJoinWhere("JOIN dc_device_group AS dgrp ON group_id = dgrp.id",PageHelper.getWhere());
		List<JSONObject> maps = Lists.transform(beans,l->dm.formatAsJson(l, dm.deviceFormater, false));
		/** 
		 * 服务方法的返回类型为JSONObject,无法将 DeviceBean 中@ExcelSheet,@ExcelColumn注解传递ExcelHelperAround,
		 * 所以这里通过调用 ExcelHelperAround#setBeanClass 方法告诉 ExcelHelperAround对象数据记录的原始的数据类型,
		 * 这样ExcelHelperAround就可以通过该类型获取 JSON 字段的Excel配置参数
		 */
		ExcelHelperAround.setBeanClass(DeviceBean.class);
		return maps;
	}

服务方法中不仅可以通过setBeanClass方法指定数据记录的原始类型,

ExcelHelperAround还提供了静态方法setSheetConfig(SheetConfig)定义全部的Excel导出配置参数,参见ExcelHelperAround#setSheetConfig(SheetConfig)的说明.

@ExcelColumn注解

gu.sql2java.excel.ExcelColumn 用于定义导出Excel数据列的配置注解。此注解可以定义在类,(服务)方法及类成员字段上。

定义在类上，代表定义类中成员的导出配置,可以定义多个。

定义在类成员(Field)上代表定义当前成员的导出配置,只能定义一个成员字段配置注解，可以定义多个子成员字段配置注解.

子成员命名要以.分割的各子成员字段名组成,比如成员字段名为props,那么其子成员字段last_active_time的名字定义为props.last_active_time。

定义在类和服务方法上的@ExcelColumn注解必须指定columnName字段

定义在(服务)方法上的用法一般用于切面(aspect)执行方式。

注解类字段说明如下:

字段名默认值说明
sortInteger.MAX_VALUE导出时该字段在excel中的排序
columnName对象(Java Bean/Map/JSON)中的字段名,当在Field上使用此注解时自动为Field name不需要填此字段
name导出到Excel中的名字.为空则与{@link #columnName}相等
integralFormat默认整数(Integer,Long,Short)格式
dateFormat日期格式, 如: yyyy-MM-dd
readConverterExp读取内容转表达式 (如: 0=男,1=女,2=未知,=错误值), ''为匹配其他未定义值的表达式
separator.分隔符，读取字符串组内容
scaleBigDecimal 精度 默认:-1(默认不开启BigDecimal格式化)【暂未支持】
roundingModeBigDecimal 舍入规则 默认:BigDecimal.ROUND_HALF_EVEN【暂未支持】
height导出时在excel中每个列的高度 单位为字符
width导出时在excel中每个列的宽 单位为字符
suffix文字后缀,如% 90 变成90%【暂未支持】
defaultValue当值为空时,字段的默认值【暂未支持】
prompt提示信息【暂未支持】
combo设置只能选择不能输入的列内容【暂未支持】
isExport是否导出数据,应对需求:有时我们需要导出一份模板,这是标题需要但内容需要用户手工填写【暂未支持】
targetAttr另一个类中的属性名称,支持多级获取,以小数点隔开【暂未支持】
isStatistics是否自动统计数据,在最后追加一行统计数据总和【暂未支持】
cellTypeColumnType.STRING导出类型（0数字 1字符串）【暂未支持】
color导出字体颜色,参见{@link org.apache.poi.ss.usermodel.IndexedColors}
fillColor单元格填充颜色,参见{@link org.apache.poi.ss.usermodel.IndexedColors}
horizontalAlign导出字段水平对齐方式,参见{@link org.apache.poi.ss.usermodel.HorizontalAlignment}
handlerExcelHandlerAdapter.class自定义数据处理器
args{}自定义数据处理器参数
readMethod指定字段读取方法名
writeMethod指定字段写入方法名

@ExcelSheet注解

字段方法名默认值说明
sheetNameexportedExcelexcel Sheet名字
fileNamePrefix导出的文件名前缀
titleexcel Sheet 标题
titleFontNameCalibri标题字体名
titleFontHeight16标题字体高度
titleFontColorBLACK标题字体颜色,参见 org.apache.poi.ss.usermodel.IndexedColors
titleFillColorWHITE标题单元背景填充颜色,参见 org.apache.poi.ss.usermodel.IndexedColors
titleHorizontalAlignCENTER标题对齐水平方式
titleHorizontalAlignCENTER标题对齐水平方式
headerFontNameCalibri首行(字段名)字体名
headerFontHeight16首行(字段名)字体高度
headerFontColorBLACK首行(字段名)字体颜色,参见 org.apache.poi.ss.usermodel.IndexedColors
headerFillColorGREY_25_PERCENT首行(字段名)单元背景填充颜色,参见 org.apache.poi.ss.usermodel.IndexedColors
headerHorizontalAlignCENTER首行(字段名)水平对齐方式
firstBoldtrue字体设置:标题行字体加粗
fontHeight16默认字体高度
fontNameCalibri默认字体名
fontColorBLACK默认字体颜色,参见org.apache.poi.ss.usermodel.IndexedColors
fillColorWHITE默认单元背景填充颜色,参见org.apache.poi.ss.usermodel.IndexedColors
horizontalAlignCENTER默认导出字段水平对齐方式
integralFormat0默认整数(Integer,Long,Short)格式
dateTimeFormatyyyy-MM-dd HH:mm:ss(java.util.Date)日期时间格式
dateFormatyyyy-MM-dd(java.sql.Date)日期格式
timeFormatHH:mm:ss(java.sql.Time)时间格式
timestampFormatyyyy-MM-dd’T’HH:mm:ss.SSSZ(java.sql.Timestamp)时间戳格式
scale-1BigDecimal 精度【暂未支持】
roundingMode6BigDecimal 舍入规则【暂未支持】
maxHeight0导出时在excel中每个列的最大高度, 单位为字符
maxWidth32导出时在excel中每个列的最大宽度, 单位为字符
defaultValue当值为空时,字段的默认值
includeColumns{}字段输出白名单,在此名单中的字段会被输出,同时指定白名单和黑名单时以白名单为准
excludeColumns{}字段输出黑名单,在此名单中的字段不会被输出,同时指定白名单和黑名单时以白名单为准
hideColumns{}隐藏字段名单,指定任何情况下都不输出的字段列表,在此名单中的字段,不论includeColumns(),excludeColumns()如何设置都不会被输出
defaultIncludeColumns{}默认的字段输出白名单,此字段用于给前端提供默认的输出字段及顺序
getParameterArgNamegetParameterSpring Controller 服务方法中获取excel导出参数的开关参数名
exportFileNameArgNameexportFileNameSpring Controller 服务方法中定义导出文件名的参数名

注解位置优先级及配置合并

服务方法(Method)>类(Class)>类成员(Field)，这是当在不同位置定义了个多个同名注解时,同名参数优先使用的顺序。

对于不同名的参数则遵循合并。

如一个car字段在类成员(Field)上定义了@ExcelColumn(name="汽车")注解,在该成员所在的类上也定义了注解@ExcelColumn(columnName="car",name="车型",color="RED")注解,在服务方法同样定义了@ExcelColumn(columnName="car",name="车型及车牌",fillColor="BLUE")注解。

那么最终该字段的定义为:

name=“车型及车牌”,color=“RED”,fillColor=“BLUE”。

三个位置都定义的name字段,遵循服务方法(Method)>类(Class)>字段(Field)优先顺序覆盖低优先级的值。

而color,filleColor字段在三个位置定义的注解中并不冲突，所以遵循合并原则

关于sql2java-excel的入门使用说明参见上一篇博客：
《sql2java-excel(一):基于apache poi实现数据库表的导出及支持spring web》

相关文章：

  • 神经网络方法研究及应用,神经网络研究主要内容
  • 基于NXP iMX8测试Secure Boot功能部署
  • Matlab | TCP通信
  • ps2021神经滤镜不能下载,ps2021没法用神经元滤镜
  • [车联网安全自学篇] Android安全之APK内存敏感信息泄露挖掘【动态分析】
  • aardio - 高级选项卡tabs禁止某一项
  • 深度神经网络的应用
  • 质量参差不齐，NFT交易版税该不该收？
  • 学生护眼灯国A与AA哪个牌子好？推荐国AA级的学生护眼台灯
  • 什么是mybatis，其实很简单
  • ViT: Vision transformer的cls token作用？
  • sql2java-excel(一):基于apache poi实现数据库表的导出及支持spring web
  • SSM保险办理系统毕业设计源码012232
  • 先睹为快_Mandelbrot集
  • centos 7 安装mysql 8.0.30
  • codis proxy处理流程
  • cookie和session
  • emacs初体验
  • Object.assign方法不能实现深复制
  • PHP 使用 Swoole - TaskWorker 实现异步操作 Mysql
  • Spring技术内幕笔记（2）：Spring MVC 与 Web
  • vue2.0一起在懵逼的海洋里越陷越深（四）
  • 初识MongoDB分片
  • 翻译 | 老司机带你秒懂内存管理 - 第一部（共三部）
  • 猫头鹰的深夜翻译：JDK9 NotNullOrElse方法
  • 你真的知道 == 和 equals 的区别吗？
  • 前嗅ForeSpider中数据浏览界面介绍
  • 深度学习入门：10门免费线上课程推荐
  • 因为阿里，他们成了“杭漂”
  • 3月7日云栖精选夜读 | RSA 2019安全大会：企业资产管理成行业新风向标，云上安全占绝对优势 ...
  • mysql 慢查询分析工具：pt-query-digest 在mac 上的安装使用 ...
  • shell使用lftp连接ftp和sftp,并可以指定私钥
  • #【QT 5 调试软件后，发布相关：软件生成exe文件 + 文件打包】
  • #NOIP 2014#Day.2 T3 解方程
  • #我与Java虚拟机的故事#连载19：等我技术变强了，我会去看你的 ​
  • （Redis使用系列） SpirngBoot中关于Redis的值的各种方式的存储与取出 三
  • （定时器/计数器）中断系统（详解与使用）
  • (十六)一篇文章学会Java的常用API
  • （一）ClickHouse 中的 `MaterializedMySQL` 数据库引擎的使用方法、设置、特性和限制。
  • （终章）[图像识别]13.OpenCV案例 自定义训练集分类器物体检测
  • .[hudsonL@cock.li].mkp勒索加密数据库完美恢复---惜分飞
  • .NET Framework杂记
  • .Net 代码性能 - (1)
  • .net 设置默认首页
  • .net 无限分类
  • .NET/C# 反射的的性能数据，以及高性能开发建议（反射获取 Attribute 和反射调用方法）
  • .net企业级架构实战之7——Spring.net整合Asp.net mvc
  • .NET企业级应用架构设计系列之结尾篇
  • .Net语言中的StringBuilder：入门到精通
  • /etc/apt/sources.list 和 /etc/apt/sources.list.d
  • @TableId注解详细介绍 mybaits 实体类主键注解
  • @Validated和@Valid校验参数区别
  • [ C++ ] STL priority_queue(优先级队列)使用及其底层模拟实现，容器适配器，deque(双端队列)原理了解
  • [ IOS ] iOS-控制器View的创建和生命周期
  • [ 云计算 | AWS 实践 ] 基于 Amazon S3 协议搭建个人云存储服务