Java 导出「月度成本费用台账」Excel 报表（合并与分组报表）
合并与分组报表场景 0077
按「费用大类 → 费用明细」两级归集预算与实际，逐行算「差异 = 实际 - 预算」「执行率 = 实际 / 预算」；每个费用大类后跟一行小计，末尾一行给出全部门类合计；费用大类列纵向合并成一个区块。 Java 侧仅做分组与预处理，统计与版式全部由 XML 声明。
关于这个示例
本示例导出「月度成本费用台账」工作簿：1 个数据 sheet；以 费用大类、费用明细、预算金额、实际金额、差异、执行率 共 6 列字段建立 MAPPING 映射、26 条公式、5 处样式规则。Java 侧只负责构造数据并调用一次 exportMonthlyCostLedger()，其余全部由配置驱动。
这个示例属于「合并与分组报表」分组：演示 MERGE 分组区块与 SUBTOTAL / TOTAL 小计合计行：同一分组列纵向合并成一个区块，每个分组后跟一行小计，末尾给出合计。
可以直接抄走的内容
- 完整 Java 测试类（94 行，可直接运行）
- 完整 XML 配置（40 行，映射、公式、样式、图表等全部规则）
- 导出产物 xlsx（真实运行结果，可与上方预览图对照）
相关搜索：Java 导出 Excel 合并单元格、Java Excel 分组小计与合计行、POI 合并单元格 导出示例、Java 导出分组报表、Java 导出 月度成本费用台账 Excel
输出规格
- 场景编号
- 0077
- 技术分组
- 合并与分组报表
- 配置行数
- 40
- 源码行数
- 94
Java 源码 · Merge0077MonthlyCostLedgerDemo.java
以下代码即生成上方 Excel 的完整测试类，可直接复制运行；Java 只负责构造数据，统计与样式逻辑全部在 XML 配置里。
package com.github.paohaijiao.biz.merge;
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 Merge0077MonthlyCostLedgerDemo {
private static final String XML = "jquick/biz/merge/0077_merge_monthly-cost-ledger.xml";
/** 导出：Java 分组 + 插小计行，费用大类列纵向合并，差异与执行率由 XML FORMULAS 完成。 */
@Test
public void exportMonthlyCostLedger() throws Exception {
// 1. 构造扁平费用明细（Java 不做任何差异计算）
List<JQuickRow> flat = new ArrayList<>();
flat.add(line("人力成本", "工资", 500000.00, 520000.00));
flat.add(line("人力成本", "社保", 120000.00, 125000.00));
flat.add(line("人力成本", "奖金", 80000.00, 70000.00));
flat.add(line("运营成本", "租金", 200000.00, 200000.00));
flat.add(line("运营成本", "水电", 50000.00, 58000.00));
// 2. Java 分组并插入小计 / 合计占位行（差异留给 FORMULAS）
List<JQuickRow> rows = groupWithSubtotal(flat);
File out = new File("D:/test/excel/biz/merge/0077_merge_monthly-cost-ledger.xlsx");
try (OutputStream os = new FileOutputStream(out)) {
JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("vintageSepia", rows, os);
JQuickFactory factory = new JQuickXmlFactory(parser, XML);
Merge0077MonthlyCostLedgerService service = factory.createApi(Merge0077MonthlyCostLedgerService.class);
service.exportMonthlyCostLedger("field", "value");
}
}
/** 按费用大类分组，大类切换处插入小计行，末尾追加合计行（不做差异计算）。 */
private static List<JQuickRow> groupWithSubtotal(List<JQuickRow> flat) {
List<JQuickRow> out = new ArrayList<>();
String current = null;
for (JQuickRow r : flat) {
String category = String.valueOf(r.get("a"));
if (current != null && !current.equals(category)) {
out.add(subtotalRow(current));
}
out.add(r);
current = category;
}
if (current != null) {
out.add(subtotalRow(current));
}
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);
out.add(total);
return out;
}
/** 小计占位行：只写费用大类与小计文字，差异留空由 FORMULAS 计算。 */
private static JQuickRow subtotalRow(String category) {
JQuickRow row = new JQuickRow();
row.put("a", category);
row.put("b", "小计");
row.put("c", null);
row.put("d", null);
row.put("e", null);
row.put("f", null);
return row;
}
/** 构造一条费用明细（a=费用大类，b=费用明细，c=预算，d=实际，e/f 留空由 FORMULAS 计算）。 */
private static JQuickRow line(String category, String item, double budgetAmount, double actualAmount) {
JQuickRow row = new JQuickRow();
row.put("a", category);
row.put("b", item);
row.put("c", budgetAmount);
row.put("d", actualAmount);
row.put("e", null);
row.put("f", null);
return row;
}
}最小调用（4 行）
核心就这四行：数据行交给解析器，解析器交给工厂，工厂生成 Service 接口，调用即产出 Excel。可直接复制到你的项目里。
// rows 由业务代码构造（List<JQuickRow>），os 为输出流，见下方完整源码
JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("vintageSepia", rows, os);
JQuickFactory factory = new JQuickXmlFactory(parser, XML);
Merge0077MonthlyCostLedgerService service = factory.createApi(Merge0077MonthlyCostLedgerService.class);XML 配置 · 0077_merge_monthly-cost-ledger.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.merge.Merge0077MonthlyCostLedgerService">
<!-- 导出：月度成本费用台账 -->
<excel name="exportMonthlyCostLedger" returnClass="void">
<![CDATA[
EXPORT WITH SHEET="月度成本费用台账", HEADER=true,
MAPPING={"a":"费用大类","b":"费用明细","c":"预算金额","d":"实际金额","e":"差异","f":"执行率"},
FORMAT={"c":"#,##0.00","d":"#,##0.00","e":"#,##0.00","f":"0.00%"},
FORMULAS={
E2:'D2-C2',F2:'D2/C2',E3:'D3-C3',F3:'D3/C3',E4:'D4-C4',F4:'D4/C4',
C5:'SUM(C2:C4)',D5:'SUM(D2:D4)',E5:'D5-C5',F5:'D5/C5',
E6:'D6-C6',F6:'D6/C6',E7:'D7-C7',F7:'D7/C7',
C8:'SUM(C6:C7)',D8:'SUM(D6:D7)',E8:'D8-C8',F8:'D8/C8',
C9:'C5+C8',D9:'D5+D8',E9:'D9-C9',F9:'D9/C9'
},
STYLE={
ROW 5:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
ROW 8:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
ROW 9:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}
},
MERGE:{
RANGE A2:A4 WITH MERGE_WITH_FIRST,
RANGE A6:A7 WITH MERGE_WITH_FIRST
}
]]>
</excel>
<!-- 导入解析：读取导出的月度成本费用台账 -->
<excel name="importMonthlyCostLedger" returnClass="java.util.List">
<![CDATA[
IMPORT WITH SHEET="月度成本费用台账", HEADER=true,
MAPPING={"费用大类":"costCategory","费用明细":"costItem","预算金额":"budgetAmount","实际金额":"actualAmount","差异":"difference","执行率":"executionRate"}
]]>
</excel>
</excels>同分组示例
本页 Excel 产物、预览图、XML 配置与源码均由 JQuick-Excel 真实运行产出，可自由复制到你的项目中使用。