springboot自定义表格(动态合并单元格)
一、需求展示（一个订单多个商品，商品数量不限订单行合并）
二、技术选型（jxls自定义模板）
org.jxls
jxls
2.13.0
org.jxls
jxls-poi
2.13.0
hu.blackbelt.bundles.jxls
org.jxls
2.10.0_1
三、导出订单的数据结构展示
[{
"orderName": "订单1",
"no": "13465464464121",
"terminalValue": "微信 小程序",
"userInfo": "微信 小程序",
"items": [{
"spuName": "ipnoe 6s",
"properties": "非卖品，勿拍！！！！",
"count": "10",
"originalUnitPrice": "10"
}]
}]四、对应模板展示
1、局部效果展示（一定要使用xlsx格式作为模板文档，xls有点问题）
2、jx:area(lastCell = "P2")参数解释：整个表的作用域是到P列第2行，作用与必须要并且必须放在表格的的首行首列
3、jx:each(items="tpList"var="tradeOrderPageItemRespVO" lastCell="P2")参数解析：tpList是最外层的order集合，tradeOrderPageItemRespVO是tpList循环时item的别称，P2是tpList循环作用表的生效范围。
4、jx:mergeCells(rows="tradeOrderPageItemRespVO.items.size()" lastCell="A2")参数解析：rows要合并行的行数，lastcall是定位那A列第2行要进行单元行合并，有多少列要合并就拷贝多少次并将lastcall定位到相关列进行修改。尝试设置为C2没有从A2的位置自动每列合并到C2不知道为啥，就一列一列的设置的。
5、jx:each(items="tradeOrderPageItemRespVO.items" var="tradeOrderItemBaseVO" lastCell="H2")参数解析：tradeOrderPageItemRespVO.items就是订单里边商品做循环，别名叫tradeOrderItemBaseVO，tradeOrderPageItemRespVO.items的作用范围就是批注D2到H2的位置可以使用用${}去到里边的变量。
6、其他表达式使用请参考官网JXLS - (sourceforge.net)或文末备注
五、代码参考
1、引入依赖
org.jxls
jxls
2.13.0
org.jxls
jxls-poi
2.13.0
hu.blackbelt.bundles.jxls
org.jxls
2.10.0_1
2、工具构建
package cn.iocoder.yudao.module.trade.utils;
import org.apache.commons.jexl3.JexlBuilder;
import org.jxls.common.Context;
import org.jxls.expression.JexlExpressionEvaluator;
import org.jxls.transform.Transformer;
import org.jxls.util.JxlsHelper;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.HashMap;
import java.util.Map;
public class JxlsUtils {
public static void exportExcel(InputStream is, OutputStream os, Map model) throws IOException {
Context context = new Context();
if (model != null) {
for (String key : model.keySet()) {
context.putVar(key, model.get(key));
}
}
JxlsHelper jxlsHelper = JxlsHelper.getInstance();
Transformer transformer = jxlsHelper.createTransformer(is, os);
JexlExpressionEvaluator evaluator = (JexlExpressionEvaluator) transformer.getTransformationConfig()
.getExpressionEvaluator();
Map funcs = new HashMap<>();
funcs.put("utils", new JxlsUtils()); // 添加自定义功能
evaluator.setJexlEngine(new JexlBuilder().namespaces(funcs).create());
jxlsHelper.processTemplate(context, transformer);
}
}
3、Controller导出
@GetMapping("/export-excel")
@Operation(summary = "导出订单表格 Excel")
@PreAuthorize("@ss.hasPermission('trade:order:export')")
@OperateLog(type = EXPORT)
public void exportActivityExcel(TradeOrderPageReqVO reqVO,
HttpServletResponse response) throws IOException {
CommonResult> orderPage = getOrderPage(reqVO);
List list = orderPage.getData().getList();
List result = new ArrayList<>();
for (TradeOrderPageItemRespVO tradeOrderPageItemRespVO : list) {
TradeOrderExcelVO convert = TradeOrderConvert.INSTANCE.convert(tradeOrderPageItemRespVO, 1);
result.add(convert);
}
// 设置响应头
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment; filename=output.xlsx");
// 使用 jXLS 进行模板变量替换并导出 Excel
try (InputStream inputStream = getClass().getResourceAsStream("/tem/tem.xlsx");
OutputStream outputStream = response.getOutputStream()) {
//excel模板内，数据组装
Map map = new HashMap<>();
map.put("tpList", result);
JxlsUtils.exportExcel(inputStream, outputStream, map);
}
} 六、备注
jx:mergeCells(lastCell="合并单元格范围"
[, cols="合并的列数"]
[, rows="合并的行数"]
[, minCols="要合并的最小列数"]
[, minRows="要合并的最小行数"]
)
lastCell：合并单元格范围；
cols：合并的列数；
rows：合并的行数；
minCols：要合并的最小列数；
minRows：要合并的最小行数；
jx:each(items="countMonths" var="month" lastCell="C3" direction="RIGHT")
这里还是通过jx:each来使用，不同的是direction 属性的值为：RIGHT（向右），默认为：DOWN（向下）
countMonths：动态列集合，month为集合循环的实体，取值为：${month}
contracts：行数据集合，contract、colData 都是集合循环的实体，取值为：${contract.custName}等
colData.monthData.get(month)：动态列的数据，根据列名去匹配实体字段
${empty()}：判断集合对应动态列数据 是否为空，做好判断，写入数据
动态列数据行的数据获取：${empty(colData.monthData.get(month) ) ? 0 : colData.monthData.get(month)}