Java 导出「物业水电费收缴台账」Excel 报表（样式与格式化报表）

样式与格式化报表场景 0063

按房号登记物业费 / 水费 / 电费应收与已收金额，逐行算「欠缴金额 = 应收 - 已收」，末尾一行汇总应收、已收与欠缴；欠缴户的欠缴金额标红。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「物业水电费收缴台账」工作簿：1 个数据 sheet；以房号、户主、费用类型、应收金额、已收金额、欠缴金额、缴费状态、缴费日期共 8 列字段建立 MAPPING 映射、10 条公式、1 处样式规则。Java 侧只构造 6 行数据并调用一次 exportUtilityFeeLedger()，其余全部由配置驱动。

这个示例属于「样式与格式化报表」分组：演示 STYLE 与条件格式：表头主题配色、斑马纹、合计行高亮，以及按阈值给异常单元格标色。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 样式、Java Excel 表头样式与斑马纹、POI CellStyle 导出示例、Java Excel 条件格式、Java 导出物业水电费收缴台账 Excel

输出规格

场景编号: 0063
技术分组: 样式与格式化报表
配置行数: 32
源码行数: 77

Java 源码 · Style0063UtilityFeeLedgerDemo.java

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

package com.github.paohaijiao.biz.style;

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.Calendar;
import java.util.Date;
import java.util.List;

public class Style0063UtilityFeeLedgerDemo {

    private static final String XML = "jquick/biz/style/0063_style_utility-fee-ledger.xml";

    /** 导出：纯 XML 完成欠缴金额计算、合计与欠缴户标红。 */
    @Test
    public void exportUtilityFeeLedger() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        // f=欠缴金额 留空，由 FORMULAS 计算
        rows.add(line("A-1801", "张伟", "物业费", 2400.00, 2400.00, "已缴清", date(2026, 3, 5)));
        rows.add(line("A-1802", "李娜", "物业费", 2400.00, 1200.00, "部分缴纳", date(2026, 3, 8)));
        rows.add(line("B-0903", "王强", "水费", 680.00, 680.00, "已缴清", date(2026, 3, 10)));
        rows.add(line("B-0904", "赵敏", "电费", 1560.00, 0.00, "欠缴", null));
        rows.add(line("C-0605", "陈杰", "物业费", 3200.00, 3200.00, "已缴清", date(2026, 3, 15)));
        // 合计占位行：应收 / 已收 / 欠缴 合计留给 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/style/0063_style_utility-fee-ledger.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("emerald", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Style0063UtilityFeeLedgerService service = factory.createApi(Style0063UtilityFeeLedgerService.class);
            service.exportUtilityFeeLedger("field", "value");
        }

    }

    /** 构造一条收缴明细（a=房号，b=户主，c=费用类型，d=应收，e=已收，f=欠缴，g=状态，h=缴费日期）。 */
    private static JQuickRow line(String roomNo, String owner, String feeType,
                                  double receivable, double received, String payStatus, Date payDate) {
        JQuickRow row = new JQuickRow();
        row.put("a", roomNo);
        row.put("b", owner);
        row.put("c", feeType);
        row.put("d", receivable);
        row.put("e", received);
        row.put("f", null);
        row.put("g", payStatus);
        row.put("h", payDate);
        return row;
    }

    /** 构造日期（月份按自然月 1-12 传入）。 */
    private static Date date(int year, int month, int day) {
        Calendar c = Calendar.getInstance();
        c.clear();
        c.set(year, month - 1, day);
        return c.getTime();
    }
}

最小调用（4 行）

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

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

XML 配置 · 0063_style_utility-fee-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.style.Style0063UtilityFeeLedgerService">

    <!-- 导出：物业水电费收缴台账 -->
    <excel name="exportUtilityFeeLedger" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="物业水电费收缴台账", HEADER=true,
                MAPPING={"a":"房号","b":"户主","c":"费用类型","d":"应收金额","e":"已收金额","f":"欠缴金额","g":"缴费状态","h":"缴费日期"},
                FORMAT={"d":"#,##0.00","e":"#,##0.00","f":"#,##0.00","h":"yyyy-MM-dd"},
                FORMULAS={
                    F2:'D2-E2',F3:'D3-E3',F4:'D4-E4',F5:'D5-E5',F6:'D6-E6',
                    D7:'SUM(D2:D6)',E7:'SUM(E2:E6)',F7:'SUM(F2:F6)'
                },
                STYLE={
                    ROW 7:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    F5:{color:red,bold:true}
                }
        ]]>
    </excel>

    <!-- 导入解析：读取导出的收缴台账 -->
    <excel name="importUtilityFeeLedger" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="物业水电费收缴台账", HEADER=true,
                MAPPING={"房号":"roomNo","户主":"owner","费用类型":"feeType","应收金额":"receivable","已收金额":"received","欠缴金额":"unpaid","缴费状态":"payStatus","缴费日期":"payDate"}
        ]]>
    </excel>

</excels>

同分组示例

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