跳转到内容
JQuickJQuick

Java 导出「销售出库单套打」Excel 报表（合并与分组报表）

JQuick-Excel合并与分组报表

合并与分组报表场景 0011

一张出库单下列多行商品明细，「数量 × 单价 = 金额」，末尾一行合计。 纯 XML 声明式实现，无需编写 Java 业务代码。

下载 Excel 文件查看 XML 配置原始文件返回全部示例

销售出库单套打 — 合并与分组报表
导出产物完整截图

关于这个示例

本示例导出「销售出库单套打」工作簿：1 个数据 sheet；以 出库单号、商品、数量、单价、金额 共 5 列字段建立 MAPPING 映射、6 条公式、2 处样式规则。Java 侧只构造 4 行数据并调用一次 exportSalesOutbound()，其余全部由配置驱动。

这个示例属于「合并与分组报表」分组：演示 MERGE 分组区块与 SUBTOTAL / TOTAL 小计合计行：同一分组列纵向合并成一个区块，每个分组后跟一行小计，末尾给出合计。

可以直接抄走的内容

  • 完整 Java 测试类（61 行，可直接运行）
  • 完整 XML 配置（27 行，映射、公式、样式、图表等全部规则）
  • 导出产物 xlsx（真实运行结果，可与上方预览图对照）

相关搜索：Java 导出 Excel 合并单元格、Java Excel 分组小计与合计行、POI 合并单元格 导出示例、Java 导出分组报表、Java 导出 销售出库单套打 Excel

输出规格

场景编号
0011
技术分组
合并与分组报表
配置行数
27
源码行数
61

Java 源码 · Merge0011SalesOutboundDemo.java

以下代码即生成上方 Excel 的完整测试类，可直接复制运行；Java 只负责构造数据，统计与样式逻辑全部在 XML 配置里。

package com.github.paohaijiao.biz.merge;

import com.github.paohaijiao.statement.JQuickRow;
import com.github.paohaijiao.xml.ex.JQuickExcelExportXmlParseFactory;
import com.github.paohaijiao.xml.factory.JQuickFactory;
import com.github.paohaijiao.xml.factory.JQuickXmlFactory;
import com.github.paohaijiao.xml.handler.JQuickParseHandler;
import org.junit.Test;

import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;

public class Merge0011SalesOutboundDemo {

    private static final String XML = "jquick/biz/merge/0011_merge_sales-outbound.xml";

    /** 导出：3 条出库明细 + 1 行合计，回读校验公式、合计行样式与横向合并。 */
    @Test
    public void exportSalesOutbound() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(detail("SO20260901001", "无线鼠标", 100, 25.50));
        rows.add(detail("SO20260901002", "机械键盘", 80, 30.00));
        rows.add(detail("SO20260901003", "显示器", 50, 12.50));
        rows.add(totalRow());

        File out = new File("D:/test/excel/biz/merge/0011_merge_sales-outbound.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("jade", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Merge0011SalesOutboundService service = factory.createApi(Merge0011SalesOutboundService.class);
            service.exportSalesOutbound("field", "value");
        }

    }

    /** 构造一条出库明细（e=金额由 FORMULAS 计算，占位保列）。 */
    private static JQuickRow detail(String orderNo, String goods, int qty, double price) {
        JQuickRow row = new JQuickRow();
        row.put("a", orderNo);
        row.put("b", goods);
        row.put("c", qty);
        row.put("d", price);
        row.put("e", null);
        return row;
    }

    /** 合计行：只写「合计」文字，其余列以空值占位（必须补齐全部映射列）。 */
    private static JQuickRow totalRow() {
        JQuickRow row = new JQuickRow();
        row.put("a", "合计");
        row.put("b", null);
        row.put("c", null);
        row.put("d", null);
        row.put("e", null);
        return row;
    }
}

最小调用（4 行）

核心就这四行：数据行交给解析器，解析器交给工厂，工厂生成 Service 接口，调用即产出 Excel。可直接复制到你的项目里。

// rows 由业务代码构造（List<JQuickRow>），os 为输出流，见下方完整源码
JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("jade", rows, os);
JQuickFactory factory = new JQuickXmlFactory(parser, XML);
Merge0011SalesOutboundService service = factory.createApi(Merge0011SalesOutboundService.class);

XML 配置 · 0011_merge_sales-outbound.xml

格式（FORMAT）、公式（FORMULAS）、样式（STYLE）等统计逻辑全部声明在这份 XML 里，与 Java 代码解耦。下方为完整配置，可直接复制。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE excels PUBLIC "-//PAOHAIJIAO//DTD API EXCEL 1.0//EN"
        "classpath:paohaijiao/dtd/Jquick-excel.dtd">
<excels namespace="com.github.paohaijiao.biz.merge.Merge0011SalesOutboundService">

    <!-- 导出：销售出库单套打 -->
    <excel name="exportSalesOutbound" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="销售出库单", HEADER=true,
                MAPPING={"a":"出库单号","b":"商品","c":"数量","d":"单价","e":"金额"},
                FORMAT={"c":"0","d":"#,##0.00","e":"#,##0.00"},
                FORMULAS={E2:'C2*D2',E3:'C3*D3',E4:'C4*D4',C5:'SUM(C2:C4)',E5:'SUM(E2:E4)'},
                STYLE={ROW 5:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}},
                MERGE:{RANGE A5:B5 WITH MERGE_WITH_FIRST}
        ]]>
    </excel>

    <!-- 导入解析：读取导出的销售出库单 -->
    <excel name="importSalesOutbound" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="销售出库单", HEADER=true,
                MAPPING={"出库单号":"orderNo","商品":"goods","数量":"qty","单价":"price","金额":"amount"}
        ]]>
    </excel>

</excels>

同分组示例

本页 Excel 产物、预览图、XML 配置与源码均由 JQuick-Excel 真实运行产出，可自由复制到你的项目中使用。