Java 导出 Excel 利器：JXLS

👉 这是一个或许对你有用 的社群

🐱 一对一交流/面试小册/简历优化/求职解惑，欢迎加入 「 芋道快速开发平台 」 知识星球。 下面是星球提供的部分资料：

• 《项目实战（视频）》 ：从书中学，往事中 “练 ”
• 《互联网高频面试题》 ：面朝简历学习，春暖花开
• 《架构 x 系统设计》 ：摧枯拉朽，掌控面试高频场景题
• 《精进 Java 学习指南》 ：系统学习，互联网主流技术栈
• 《必读 Java 源码专栏》 ：知其然，知其所以然

• 简介
• 引入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/

❞

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/ruoyi-vue-pro
• 视频教程：https://doc.iocoder.cn/video/

引入maven依赖

<dependency>
    <groupId>org.jxlsgroupId>
    <artifactId>jxlsartifactId>
    <version>2.11.0version>
dependency>
<dependency>
    <groupId>org.jxlsgroupId>
    <artifactId>jxls-poiartifactId>
    <version>2.11.0version>
dependency>
 

<dependency>
    <groupId>org.jxlsgroupId>
    <artifactId>jxls-jexcelartifactId>
    <version>${jxlsJexcelVersion}version>
dependency>

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能

• 项目地址：https://github.com/YunaiV/yudao-cloud
• 视频教程：https://doc.iocoder.cn/video/

后台代码

工具类：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: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:mergeCells 合并单元格

jx:mergeCells(lastCell="合并单元格范围"
[, cols="合并的列数"]
[, rows="合并的行数"]
[, minCols="要合并的最小列数"]
[, minRows="要合并的最小行数"]
)

• lastCell：合并单元格范围；
• cols：合并的列数；