Java 导出「客户退货原因分析表」Excel 报表（公式与计算报表）

公式与计算报表场景 0097

逐退货原因登记退货数量与金额，算「数量占比 = 该项退货数量 / 退货数量合计」，末尾一行汇总退货数量、金额与占比；占比最高的原因标红。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「客户退货原因分析表」工作簿：1 个数据 sheet；以退货原因、退货数量、退货金额、数量占比、责任部门共 5 列字段建立 MAPPING 映射、10 条公式、1 处样式规则。Java 侧只构造 6 行数据并调用一次 exportReturnReasonAnalysis()，其余全部由配置驱动。

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

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 公式、Java Excel SUM 公式导出、POI 写入公式示例、Java 导出计算列、Java 导出客户退货原因分析表 Excel

输出规格

场景编号: 0097
技术分组: 公式与计算报表
配置行数: 32
源码行数: 61

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

    private static final String XML = "jquick/biz/formulas/0097_formulas_return-reason-analysis.xml";

    /** 导出：纯 XML 完成逐行数量占比、各列汇总与占比最高原因标红。 */
    @Test
    public void exportReturnReasonAnalysis() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        // d 留空，由 FORMULAS 计算
        rows.add(reason("质量问题", 80, 24000.00, "生产部"));
        rows.add(reason("包装破损", 45, 6750.00, "物流部"));
        rows.add(reason("尺寸不符", 120, 36000.00, "研发部"));
        rows.add(reason("交期延误", 30, 4500.00, "计划部"));
        rows.add(reason("客户误购", 25, 2500.00, "销售部"));
        // 合计占位行：数量 / 金额 / 占比汇总留给 FORMULAS
        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/0097_formulas_return-reason-analysis.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("emerald", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Formulas0097ReturnReasonAnalysisService service = factory.createApi(Formulas0097ReturnReasonAnalysisService.class);
            service.exportReturnReasonAnalysis("field", "value");
        }

    }

    /** 构造一类退货原因（a=原因，b=数量，c=金额，d 留空，e=责任部门）。 */
    private static JQuickRow reason(String returnReason, double returnQuantity, double returnAmount,
                                    String responsibleDepartment) {
        JQuickRow row = new JQuickRow();
        row.put("a", returnReason);
        row.put("b", returnQuantity);
        row.put("c", returnAmount);
        row.put("d", null);
        row.put("e", responsibleDepartment);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0097_formulas_return-reason-analysis.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.Formulas0097ReturnReasonAnalysisService">

    <!-- 导出：客户退货原因分析表 -->
    <excel name="exportReturnReasonAnalysis" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="客户退货原因分析表", HEADER=true,
                MAPPING={"a":"退货原因","b":"退货数量","c":"退货金额","d":"数量占比","e":"责任部门"},
                FORMAT={"b":"#,##0","c":"#,##0.00","d":"0.00%"},
                FORMULAS={
                    D2:'B2/B7',D3:'B3/B7',D4:'B4/B7',D5:'B5/B7',D6:'B6/B7',
                    B7:'SUM(B2:B6)',C7:'SUM(C2:C6)',D7:'SUM(D2:D6)'
                },
                STYLE={
                    ROW 7:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    D4:{color:red,bold:true}
                }
        ]]>
    </excel>

    <!-- 导入解析：读取导出的客户退货原因分析表 -->
    <excel name="importReturnReasonAnalysis" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="客户退货原因分析表", HEADER=true,
                MAPPING={"退货原因":"returnReason","退货数量":"returnQuantity","退货金额":"returnAmount","数量占比":"quantityRatio","责任部门":"responsibleDepartment"}
        ]]>
    </excel>

</excels>

同分组示例

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