Java 导出「供应商档案名册」Excel 报表（公式与计算报表）

公式与计算报表场景 0071

登记合格供应商档案（编码 / 名称 / 类别 / 合作年限 / 联系人 / 电话 / 年供货额 / 评级），末尾一行汇总年供货额。纯 XML 声明式实现，无需编写 Java 业务代码。

导出产物完整截图

关于这个示例

本示例导出「供应商档案名册」工作簿：1 个数据 sheet；以供应商编码、供应商名称、供应类别、合作年限、联系人、联系电话、年供货额、评级共 8 列字段建立 MAPPING 映射、2 条公式、1 处样式规则。Java 侧只构造 7 行数据并调用一次 exportSupplierProfileRoster()，其余全部由配置驱动。

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

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 公式、Java Excel SUM 公式导出、POI 写入公式示例、Java 导出计算列、Java 导出供应商档案名册 Excel

输出规格

场景编号: 0071
技术分组: 公式与计算报表
配置行数: 28
源码行数: 67

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

    private static final String XML = "jquick/biz/formulas/0071_formulas_supplier-profile-roster.xml";

    /** 导出：纯 XML 完成年供货额汇总与合计行高亮。 */
    @Test
    public void exportSupplierProfileRoster() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(supplier("S2601", "华新电子有限公司", "电子元件", 8, "张明", "13800138001", 2400000.00, "战略供应商"));
        rows.add(supplier("S2602", "恒通材料有限公司", "金属材料", 5, "李强", "13900139002", 1800000.00, "核心供应商"));
        rows.add(supplier("S2603", "佳美包装有限公司", "包装耗材", 3, "王芳", "13700137003", 760000.00, "一般供应商"));
        rows.add(supplier("S2604", "中兴物流有限公司", "物流服务", 6, "赵敏", "13600136004", 540000.00, "核心供应商"));
        rows.add(supplier("S2605", "新元五金有限公司", "五金配件", 2, "陈杰", "13500135005", 320000.00, "一般供应商"));
        rows.add(supplier("S2606", "天海电子有限公司", "电子元件", 4, "周涛", "13400134006", 460000.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);
        total.put("f", null);
        total.put("g", null);
        total.put("h", null);
        rows.add(total);

        File out = new File("D:/test/excel/biz/formulas/0071_formulas_supplier-profile-roster.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("azure", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Formulas0071SupplierProfileRosterService service = factory.createApi(Formulas0071SupplierProfileRosterService.class);
            service.exportSupplierProfileRoster("field", "value");
        }

    }

    /** 构造一家供应商档案（a=编码，b=名称，c=类别，d=合作年限，e=联系人，f=电话，g=年供货额，h=评级）。 */
    private static JQuickRow supplier(String supplierNo, String supplierName, String category, int cooperationYears,
                                      String contact, String phone, double annualAmount, String rating) {
        JQuickRow row = new JQuickRow();
        row.put("a", supplierNo);
        row.put("b", supplierName);
        row.put("c", category);
        row.put("d", cooperationYears);
        row.put("e", contact);
        row.put("f", phone);
        row.put("g", annualAmount);
        row.put("h", rating);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0071_formulas_supplier-profile-roster.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.Formulas0071SupplierProfileRosterService">

    <!-- 导出：供应商档案名册 -->
    <excel name="exportSupplierProfileRoster" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="供应商档案名册", HEADER=true,
                MAPPING={"a":"供应商编码","b":"供应商名称","c":"供应类别","d":"合作年限","e":"联系人","f":"联系电话","g":"年供货额","h":"评级"},
                FORMAT={"d":"0","g":"#,##0.00"},
                FORMULAS={G8:'SUM(G2:G7)'},
                STYLE={
                    ROW 8:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}
                }
        ]]>
    </excel>

    <!-- 导入解析：读取导出的供应商档案名册 -->
    <excel name="importSupplierProfileRoster" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="供应商档案名册", HEADER=true,
                MAPPING={"供应商编码":"supplierNo","供应商名称":"supplierName","供应类别":"category","合作年限":"cooperationYears","联系人":"contact","联系电话":"phone","年供货额":"annualAmount","评级":"rating"}
        ]]>
    </excel>

</excels>

同分组示例

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