Java 导出「分组销售聚合」Excel 报表（合并与分组报表）

合并与分组报表场景 0104

按大区切片列出各门店一至四季度销售额，大区名称列纵向合并成一个区块，视觉上把同区门店归为一个分组。 Java 侧仅做分组与预处理，统计与版式全部由 XML 声明。

关于这个示例

本示例导出「分组销售聚合」工作簿：1 个数据 sheet；以大区、门店、一季度、二季度、三季度、四季度共 6 列字段建立 MAPPING 映射、4 处样式规则。Java 侧只构造 6 行数据并调用一次 exportGroupSalesAggregate()，其余全部由配置驱动。

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

可以直接抄走的内容

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

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

输出规格

场景编号: 0104
技术分组: 合并与分组报表
配置行数: 32
源码行数: 53

Java 源码 · Merge0104GroupSalesAggregateDemo.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 Merge0104GroupSalesAggregateDemo {

    private static final String XML = "jquick/biz/merge/0104_merge_group-sales-aggregate.xml";

    /** 导出：按大区分组建表，大区列纵向合并，回读校验合并区块与表头样式。 */
    @Test
    public void exportGroupSalesAggregate() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(line("华东", "上海店", 400, 205, 210, 190));
        rows.add(line("华东", "杭州店", 250, 230, 200, 260));
        rows.add(line("华南", "广州店", 300, 260, 290, 320));
        rows.add(line("华南", "深圳店", 280, 260, 270, 250));
        rows.add(line("华北", "北京店", 400, 360, 380, 410));
        rows.add(line("华北", "天津店", 360, 340, 350, 370));

        File out = new File("D:/test/excel/biz/merge/0104_merge_group-sales-aggregate.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("terracotta", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Merge0104GroupSalesAggregateService service = factory.createApi(Merge0104GroupSalesAggregateService.class);
            service.exportGroupSalesAggregate("field", "value");
        }

    }

    /** 构造一条门店季度明细（a=大区，b=门店，c..f=一至四季度）。 */
    private static JQuickRow line(String region, String store, int q1, int q2, int q3, int q4) {
        JQuickRow row = new JQuickRow();
        row.put("a", region);
        row.put("b", store);
        row.put("c", q1);
        row.put("d", q2);
        row.put("e", q3);
        row.put("f", q4);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0104_merge_group-sales-aggregate.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.Merge0104GroupSalesAggregateService">

    <!-- 导出：分组销售聚合（大区 / 门店 / 四个季度） -->
    <excel name="exportGroupSalesAggregate" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="分组销售聚合", HEADER=true,
                MAPPING={"a":"大区","b":"门店","c":"一季度","d":"二季度","e":"三季度","f":"四季度"},
                FORMAT={"c":"#,##0","d":"#,##0","e":"#,##0","f":"#,##0"},
                STYLE={
                    ROW 1:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:center,verticalAlignment:center}
                },
                MERGE:{
                    RANGE A2:A3 WITH MERGE_WITH_FIRST,
                    RANGE A4:A5 WITH MERGE_WITH_FIRST,
                    RANGE A6:A7 WITH MERGE_WITH_FIRST
                }
        ]]>
    </excel>

    <!-- 导入解析：读取导出的分组销售聚合 -->
    <excel name="importGroupSalesAggregate" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="分组销售聚合", HEADER=true,
                MAPPING={"大区":"region","门店":"store","一季度":"q1","二季度":"q2","三季度":"q3","四季度":"q4"}
        ]]>
    </excel>

</excels>

同分组示例

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