Java 导出 Excel 利器：JXLS
**目录** - 简介 - 引入 maven 依赖 - 后台代码 - 创建模板 - XLS 表达式 - jx:area - jx:each 最常用的 xls 表达式 - jx:mergeCells 合并单元格 - 动态列-综合使用 - 总结 --- ## **简介** 相信大家能经常性的遇到项目上各类 excel 的导出，简单的 excel 格式，用简单的 poi，easyExcel 等工具都能导出。但是针对复杂的 excel，有固定的样式、合并单元格、动态列等各类要求，导致 excel 导出需要花很大一部分精力去写代码。jxls 在很大程度上解决了以上问题。 这里简单介绍下 jxls，JXLS 是国外一个简单的、轻量级的 excel 导出库，链接：JXLS 官网，这里有详细的文档说明教程（英文版），为了方便大家使用，我举例几个常见的 excel 模板配置，方便大家使用。 > **“**https://jxls.sourceforge.net/ ## **引入 maven 依赖** ``` org.jxls jxls 2.11.0 org.jxls jxls-poi 2.11.0 org.jxls jxls-jexcel ${jxlsJexcelVersion} ``` ## **后台代码** 工具类：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); } ``` 导出 controller ``` //导出示例Controller @PostMapping("/export/exportTradeCreditData") @ResponseBody public void exportTradeCreditData(HttpServletRequest request, HttpServletResponse response, Date countDate) { String templatePath = "template/excel/trade_credit_data.xlsx"; //查找模板文件路径，这里PathTools类为系统内部封装类，大家注意copy URL templateResource = PathTools.findResource(templatePath); try (OutputStream out = response.getOutputStream(); InputStream templateStream = templateResource.openStream();) { //业务数据查询 List list = countingReportService.queryTradeCreditData(countDate); //excel模板内，数据组装 Map map = new HashMap(); map.put("year", getYear(countDate)); map.put("contracts", list); JxlsUtils.exportExcel(templateStream, out, map); out.close(); } catch (Exception e) { e.printStackTrace(); log.error("导出excel异常, {}", JxlsUtils.executeException(e)); } } ``` ## **创建模板** > **“**注意事项：excel 模板工作表要使用 xlsx 格式，不要使用 xls 格式，防止导出时数据转换出错 - 新建 excel 模板，xlsx 格式 - 工作表中按照的导出要求，设置表格样式 - 仅限于简单的表头与行、列的宽度、高度 - 编写写表达式，在工作表中右键插入批注，office 中添加批注快捷键（Shit + F2） - 设置区域、数据行、合并单元格、动态列等 ## **XLS 表达式** 简单列举常用的几个表达式 ### **jx:area** ``` jx:area(lastCell = "H3") ``` XLS Area 是 JxlsPlus 中的一个重要概念，它表明 excel 模板中须要被解析的矩形区域，由 A1 到最后一个单元格表示，有利于加快解析速度。它须要被定义在 excel 模板的第一个单元格（A1）。 示例图：  jx:area 示例图 ### **jx:each 最常用的 xls 表达式** ``` jx:each(items="contracts" var="contract" lastCell="H3") ``` - items：上下文中集合的变量名； - var：在遍历集合的时候每一条记录的变量名； - area：该 XLS Command 的解析区域； - direction：数据在 excel 中填充的方向，默认（DOWN）向下； - select：其值为一个表达式，用来过滤数据 > **“**注：如果涉及到动态列，横向遍历，需注意其用法，特别需注意动态列的数据显示问题，下面会讲到 ``` jx:each(items="countMonths" var="month" lastCell="C3" direction="RIGHT") ``` 简单的示例图：  jx:each 简单示例图 复杂的示例图：  jx:each 复杂示例图 ### **jx:mergeCells 合并单元格** ``` jx:mergeCells(lastCell="合并单元格范围" [, cols="合并的列数"] [, rows="合并的行数"] [, minCols="要合并的最小列数"] [, minRows="要合并的最小行数"] ) ``` - lastCell：合并单元格范围； - cols：合并的列数； - rows：合并的行数； - minCols：要合并的最小列数； - minRows：要合并的最小行数； > **“**注意：此命令只能用于还没有合并的单元格。 示例图：  jx:mergeCells 示例图 ### **动态列-综合使用** ``` 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)} ``` ## **总结** 以上为我使用过程中，几个较常用的操作。
