Java 导出「月度销量矩阵」Excel 报表（图表与可视化报表）

图表与可视化报表场景 0110

三个产品一至三月的销量矩阵，末行按月份汇总；附曲面图展示二维（产品 × 月份）分布。导出为多 sheet 工作簿（月度销量矩阵 / 月度销量曲面图）。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「月度销量矩阵」工作簿：1 个数据 sheet；以产品、1月、2月、3月共 4 列字段建立 MAPPING 映射、6 条公式、1 处样式规则、SURFACE 图表（独立 sheet）。Java 侧只构造 4 行数据并调用一次 exportMonthlyProductMatrix()，其余全部由配置驱动。

这个示例属于「图表与可视化报表」分组：演示 GRAPH 图表：柱形、折线、散点、雷达等图表写入独立 sheet，与数据表共同构成多 sheet 工作簿。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 图表、Java 生成 Excel 折线图、POI 图表导出示例、Java 多 sheet 报表导出、Java 导出月度销量矩阵 Excel

输出规格

场景编号: 0110
技术分组: 图表与可视化报表
配置行数: 35
源码行数: 59

Java 源码 · Graph0110MonthlyProductMatrixDemo.java

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

package com.github.paohaijiao.biz.graph;

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 Graph0110MonthlyProductMatrixDemo {

    private static final String XML = "jquick/biz/graph/0110_graph_monthly-product-matrix.xml";

    /** 导出：3 个产品 + 1 行合计 + 曲面图，回读校验末行汇总与图表 sheet。 */
    @Test
    public void exportMonthlyProductMatrix() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(detail("产品A", 120, 140, 160));
        rows.add(detail("产品B", 150, 160, 180));
        rows.add(detail("产品C", 180, 200, 220));
        rows.add(totalRow());

        File out = new File("D:/test/excel/biz/graph/0110_graph_monthly-product-matrix.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("turquoise", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Graph0110MonthlyProductMatrixService service = factory.createApi(Graph0110MonthlyProductMatrixService.class);
            service.exportMonthlyProductMatrix("field", "value");
        }

    }

    /** 构造一条产品明细（三列为直接值，末行汇总由 FORMULAS 计算）。 */
    private static JQuickRow detail(String product, double jan, double feb, double mar) {
        JQuickRow row = new JQuickRow();
        row.put("a", product);
        row.put("b", jan);
        row.put("c", feb);
        row.put("d", mar);
        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);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0110_graph_monthly-product-matrix.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.graph.Graph0110MonthlyProductMatrixService">

    <!-- 导出：月度销量矩阵 -->
    <excel name="exportMonthlyProductMatrix" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="月度销量矩阵", HEADER=true,
                MAPPING={"a":"产品","b":"1月","c":"2月","d":"3月"},
                FORMAT={"b":"#,##0","c":"#,##0","d":"#,##0"},
                FORMULAS={
                    B5:'SUM(B2:B4)',C5:'SUM(C2:C4)',D5:'SUM(D2:D4)'
                },
                STYLE={ROW 5:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}},
                GRAPH={TYPE=SURFACE, TITLE="月度销量曲面图", CATEGORY_AXIS=产品, VALUE_AXIS=销量,
                       CATEGORIES=["产品A","产品B","产品C"],
                       SERIES=[
                           {NAME=一月, DATA=[120,150,180]},
                           {NAME=二月, DATA=[140,160,200]},
                           {NAME=三月, DATA=[160,180,220]}
                       ]}
        ]]>
    </excel>

    <!-- 导入解析：读取导出的月度销量矩阵 -->
    <excel name="importMonthlyProductMatrix" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="月度销量矩阵", HEADER=true,
                MAPPING={"产品":"product","1月":"jan","2月":"feb","3月":"mar"}
        ]]>
    </excel>

</excels>

同分组示例

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