Java 导出「产品销量 Top N 排行」Excel 报表（公式与计算报表）

公式与计算报表场景 0008

销量前 N 名的产品排行，逐行给出销售占比，末尾一行合计。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「产品销量 Top N 排行」工作簿：1 个数据 sheet；以排名、产品名称、销量(件)、销售额(元)、销售占比共 5 列字段建立 MAPPING 映射、10 条公式、1 处样式规则。Java 侧只构造 6 行数据并调用一次 exportProductSalesTopN()，其余全部由配置驱动。

这个示例属于「公式与计算报表」分组：演示 FORMULAS 的行内表达式与聚合函数：逐行算「数量 × 单价」「余额 = 应收 − 已收」等，末行用 SUM 汇总。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 公式、Java Excel SUM 公式导出、POI 写入公式示例、Java 导出计算列、Java 导出产品销量 Top N 排行 Excel

输出规格

场景编号: 0008
技术分组: 公式与计算报表
配置行数: 30
源码行数: 58

Java 源码 · Formulas0008ProductSalesTopNDemo.java

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

package com.github.paohaijiao.biz.formulas;

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

    private static final String XML = "jquick/biz/formulas/0008_formulas_product-sales-topn.xml";

    /** 导出：Top 5 产品 + 1 行合计，回读校验占比公式与合计行样式。 */
    @Test
    public void exportProductSalesTopN() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(detail(1, "智能手表", 1200, 360000));
        rows.add(detail(2, "无线耳机", 980, 294000));
        rows.add(detail(3, "蓝牙音箱", 760, 228000));
        rows.add(detail(4, "平板电脑", 520, 208000));
        rows.add(detail(5, "智能手环", 410, 123000));
        JQuickRow total = new JQuickRow();
        total.put("a", "合计");
        total.put("b", null);
        total.put("c", null);
        total.put("d", null);
        total.put("e", null);
        rows.add(total);

        File out = new File("D:/test/excel/biz/formulas/0008_formulas_product-sales-topn.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("charcoal", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Formulas0008ProductSalesTopNService service = factory.createApi(Formulas0008ProductSalesTopNService.class);
            service.exportProductSalesTopN("field", "value");
        }

    }

    /** 构造一条产品销量明细（a=排名，b=产品名称，c=销量，d=销售额；e=销售占比由 FORMULAS 计算，占位保列）。 */
    private static JQuickRow detail(int rank, String name, int qty, double amount) {
        JQuickRow row = new JQuickRow();
        row.put("a", rank);
        row.put("b", name);
        row.put("c", qty);
        row.put("d", amount);
        row.put("e", null);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0008_formulas_product-sales-topn.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.formulas.Formulas0008ProductSalesTopNService">

    <!-- 导出：产品销量 Top N 排行 -->
    <excel name="exportProductSalesTopN" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="产品销量TopN", HEADER=true,
                MAPPING={"a":"排名","b":"产品名称","c":"销量(件)","d":"销售额(元)","e":"销售占比"},
                FORMAT={"c":"#,##0","d":"#,##0.00","e":"0.00%"},
                FORMULAS={
                    E2:'D2/SUM(D2:D6)',E3:'D3/SUM(D2:D6)',E4:'D4/SUM(D2:D6)',
                    E5:'D5/SUM(D2:D6)',E6:'D6/SUM(D2:D6)',
                    C7:'SUM(C2:C6)',D7:'SUM(D2:D6)',E7:'SUM(E2:E6)'
                },
                STYLE={ROW 7:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}}
        ]]>
    </excel>

    <!-- 导入解析：读取导出的产品销量排行 -->
    <excel name="importProductSalesTopN" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="产品销量TopN", HEADER=true,
                MAPPING={"排名":"rank","产品名称":"name","销量(件)":"qty","销售额(元)":"amount","销售占比":"ratio"}
        ]]>
    </excel>

</excels>

同分组示例

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