夜雨聆风学习资料网

ARTICLE · 1366785

Java 导出 Excel 别再手搓了,JXLS 确实省事!

Java 导出 Excel 别再手搓了,JXLS 确实省事!

Java 项目里,导出 Excel 这件事看起来不复杂,真正做过几个业务就知道,麻烦的从来不是把数据写进单元格,而是模板。

比如一张订单报表,表头要合并,金额要设置格式,明细要循环填充,最后还要按部门分组统计。用 Apache POI 当然能做,但代码写着写着就容易变成这样:创建单元格、设置样式、合并区域、计算行号、复制格式……

需求再改两次,导出代码就很难看了。

这种场景,我更愿意用 JXLS。让 Excel 模板负责排版,让 Java 负责准备数据,别把两件事搅在一起。

一、JXLS 到底好用在哪?

JXLS 是一个基于 Excel 模板生成 Excel 文件的 Java 工具。

它底层依赖 Apache POI 处理 Excel 文件,但它的思路不一样:我们先在 Excel 里把报表样式设计好,再通过特殊标记告诉 JXLS 哪些地方需要循环、哪些地方需要填充数据。

假设现在要导出一份订单明细,包含订单编号、客户名称、商品数量和订单金额。

如果用 POI 从零创建,表头、列宽、字体、边框、金额格式都得用代码设置。JXLS 则可以直接使用现成的 Excel 模板,后续产品经理说表头要加个 logo,或者金额列要改成两位小数,通常直接改模板就够了。

这才是它真正省事的地方。

二、先准备一个 Excel 模板

先在项目的 src/main/resources/templates 目录下创建 order-report.xlsx。

模板第一行可以写报表标题,第二行写表头,第三行开始放明细。

在明细区域中,使用 JXLS 的表达式填充数据,并用 jx:each 标记告诉它需要循环哪些行。

例如,在明细行中设置以下内容:

订单编号:${item.orderNo}
客户名称:${item.customerName}
商品数量:${item.quantity}
订单金额:${item.amount}

然后给明细所在的行添加批注,配置循环指令:

jx:each(items="orders" var="item"
 lastCell="D3")

这里的 orders 对应 Java 传入的数据集合,item 是每次循环使用的变量,lastCell 指定循环区域的右下角单元格。

注意,jx:each 是写在 Excel 模板批注中的指令,不是直接写到单元格里当普通文本使用。具体模板语法要和所使用的 JXLS 版本对应。

模板准备好后,后面就不用再手动计算每条订单应该落在哪一行了。

三、Java 代码怎么写?

先引入 JXLS 依赖。下面以 Maven 项目为例,版本号建议结合项目的 JDK 版本和依赖管理统一确定。

<dependency>
    <groupId>org.jxls</groupId>
    <artifactId>jxls</artifactId>
    <version>${jxls.version}</version>
</dependency>

<dependency>
    <groupId>org.jxls</groupId>
    <artifactId>jxls-poi</artifactId>
    <version>${jxls.version}</version>
</dependency>

业务代码负责查询订单、组装数据,然后把数据交给模板引擎。

下面这段代码按常见的 JXLS 模板处理方式编写,重点是把数据准备和 Excel 渲染分开:

import org.jxls.common.Context;
import org.jxls.util.JxlsHelper;

import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;

public class OrderExcelExporter {

    public void export(List<OrderRow> orders, Path target)
            throws Exception {

if (orders == null || orders.isEmpty()) {
            throw new IllegalArgumentException("没有可导出的订单数据");
        }

        Path parent = target.getParent();
if (parent != null) {
            Files.createDirectories(parent);
        }

        try (InputStream template = getClass()
                    .getResourceAsStream(
"/templates/order-report.xlsx");
             OutputStream output = Files.newOutputStream(target)) {

if (template == null) {
                throw new IllegalStateException("Excel模板不存在");
            }

            Context context = new Context();
            context.putVar("orders", orders);

            JxlsHelper.getInstance()
                    .processTemplate(template, output, context);
        }
    }
}

这里有几个细节值得注意。

第一,context.putVar("orders", orders) 中的变量名必须和模板循环指令里的 items="orders" 一致。名字对不上,模板自然拿不到数据。

第二,OrderRow 应该是业务专用的导出对象,里面放 orderNo、customerName、quantity、amount 等字段。不要为了导出直接把数据库实体扔进模板,实体字段一多,模板也容易跟着业务表结构一起变化。

第三,文件流用完及时关闭。模板路径不存在、目标目录没有创建、数据为空,这些情况最好在导出入口就处理好,别等到线上下载接口才发现问题。

四、真正容易踩坑的是这几个地方

JXLS 不是把 POI 的问题全部消灭了,它只是把很多 Excel 排版工作从 Java 代码里挪到了模板中。

模板表达式写错,数据就出不来。 比如 Java 对象字段叫 customerName,模板却写成 ${item.customer},这类问题要优先检查变量名和对象属性。

金额格式不要只在 Java 中处理。 金额建议使用 BigDecimal,Excel 单元格格式则在模板中设置为金额格式。不要为了显示两位小数,就把金额提前转成字符串,否则后续求和、排序时可能出现麻烦。

模板复杂时,先拿少量数据验证。 合并单元格、动态行、公式、图片和复杂样式都可能影响最终效果。特别是模板中有公式时,要确认导出后公式是否正确,以及打开文件的客户端是否会重新计算。

还有一个问题:大批量导出。

如果一次导出几十万条数据,不要只盯着模板处理速度。数据库查询一次性加载全部记录、Java 堆内存占用、最终文件大小,都可能成为瓶颈。可以先分页查询,控制数据量;数据规模特别大时,再评估流式生成或拆分多个工作表。具体方案要看所用 JXLS 版本及其底层 POI 处理方式,别默认换个工具就能解决内存问题。

五、什么时候值得用 JXLS?

如果只是导出几列简单数据,POI 直接写入也没什么问题,没必要为了用工具而用工具。

但如果项目里有大量固定格式的业务报表,比如订单清单、财务报表、库存统计、生产记录,尤其是业务人员经常要求调整 Excel 样式,那么 JXLS 的价值就比较明显了。

模板交给熟悉 Excel 的人维护,Java 代码只负责查询和组装数据。报表样式变了,不一定需要重新发版;业务字段变了,也不必把所有单元格操作代码翻出来逐行修改。

我选导出工具时,比较在意的不是第一次写起来有多快,而是半年以后需求变了,这段代码还好不好维护。

Excel 模板能解决的问题,就别全塞进 Java 代码里。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料