Java 导出「采购订单套打」Excel 报表（页眉页脚与套打）

页眉页脚与套打场景 0010

采购订单逐行「数量 × 单价 = 金额」，再按税率算「含税金额」，末尾一行合计，单据底部由 FOOTER 生成一行制单 / 审核签字说明。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「采购订单套打」工作簿：1 个数据 sheet；以物料编码、物料名称、数量、单价、金额、税率、含税金额共 7 列字段建立 MAPPING 映射、10 条公式、1 处样式规则。Java 侧只构造 5 行数据并调用一次 exportPurchaseOrder()，其余全部由配置驱动。

这个示例属于「页眉页脚与套打」分组：演示 FOOTER 页脚套打：在单据底部生成制单 / 审核等固定说明行。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 页脚、Excel 套打页脚 Java、POI 页眉页脚导出示例、Java 导出采购订单套打 Excel

输出规格

场景编号: 0010
技术分组: 页眉页脚与套打
配置行数: 32
源码行数: 79

Java 源码 · Footer0010PurchaseOrderDemo.java

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

package com.github.paohaijiao.biz.footer;

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

    private static final String XML = "jquick/biz/footer/0010_footer_purchase-order.xml";

    /** 导出：3 条采购明细 + 合计 + 尾部占位行，回读校验公式、样式与页脚。 */
    @Test
    public void exportPurchaseOrder() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(detail("M001", "无线鼠标", 100, 25.50, 0.13));
        rows.add(detail("M002", "机械键盘", 80, 30.00, 0.13));
        rows.add(detail("M003", "显示器", 50, 12.50, 0.09));
        rows.add(totalRow());
        rows.add(footerPlaceholder());

        File out = new File("D:/test/excel/biz/footer/0010_footer_purchase-order.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("sage", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Footer0010PurchaseOrderService service = factory.createApi(Footer0010PurchaseOrderService.class);
            service.exportPurchaseOrder("field", "value");
        }

    }

    /** 构造一条采购明细（e=金额、g=含税金额由 FORMULAS 计算，占位保列）。 */
    private static JQuickRow detail(String code, String name, int qty, double price, double taxRate) {
        JQuickRow row = new JQuickRow();
        row.put("a", code);
        row.put("b", name);
        row.put("c", qty);
        row.put("d", price);
        row.put("e", null);
        row.put("f", taxRate);
        row.put("g", null);
        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);
        row.put("e", null);
        row.put("f", null);
        row.put("g", null);
        return row;
    }

    /** 尾部占位行：承接 FOOTER 页脚，避免页脚覆盖合计行。 */
    private static JQuickRow footerPlaceholder() {
        JQuickRow row = new JQuickRow();
        row.put("a", null);
        row.put("b", null);
        row.put("c", null);
        row.put("d", null);
        row.put("e", null);
        row.put("f", null);
        row.put("g", null);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0010_footer_purchase-order.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.footer.Footer0010PurchaseOrderService">

    <!-- 导出：采购订单套打 -->
    <excel name="exportPurchaseOrder" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="采购订单", HEADER=true,
                MAPPING={"a":"物料编码","b":"物料名称","c":"数量","d":"单价","e":"金额","f":"税率","g":"含税金额"},
                FORMAT={"c":"0","d":"#,##0.00","e":"#,##0.00","f":"0.00%","g":"#,##0.00"},
                FORMULAS={
                    E2:'C2*D2',G2:'E2*(1+F2)',
                    E3:'C3*D3',G3:'E3*(1+F3)',
                    E4:'C4*D4',G4:'E4*(1+F4)',
                    C5:'SUM(C2:C4)',E5:'SUM(E2:E4)',G5:'SUM(G2:G4)'
                },
                STYLE={ROW 5:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}},
                FOOTER="制单人：__________    审核人：__________    日期：__________"
        ]]>
    </excel>

    <!-- 导入解析：读取导出的采购订单（最后一行是 FOOTER 签字说明） -->
    <excel name="importPurchaseOrder" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="采购订单", HEADER=true,
                MAPPING={"物料编码":"code","物料名称":"name","数量":"qty","单价":"price","金额":"amount","税率":"taxRate","含税金额":"amountWithTax"}
        ]]>
    </excel>

</excels>

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