Java 导出「设备点检记录填报表」Excel 报表（数据校验）

数据校验场景 0054

逐台设备登记点检人与运行参数，末尾一行汇总总运行时长；导入侧对填报内容做规则校验（编号 / 名称长度、运行时长整数与取值范围、温度上限、结论字典）。纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「设备点检记录填报表」工作簿：1 个数据 sheet；以设备编号、设备名称、点检人、运行时长、温度、点检结论、备注共 7 列字段建立 MAPPING 映射、2 条公式、1 处样式规则。Java 侧只构造 7 行数据并调用一次 exportEquipmentInspectionRecord()，其余全部由配置驱动。

这个示例属于「数据校验」分组：演示 VALIDATION 填报表校验：导出填报模板，导入时逐项校验内容是否合规。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 校验、Excel 导入数据校验 Java、Java Excel 填报模板校验规则、Java 导出设备点检记录填报表 Excel

输出规格

场景编号: 0054
技术分组: 数据校验
配置行数: 39
源码行数: 65

Java 源码 · Validation0054EquipmentInspectionRecordDemo.java

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

package com.github.paohaijiao.biz.validation;

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

    private static final String XML = "jquick/biz/validation/0054_validation_equipment-inspection-record.xml";

    /** 导出：纯 XML 完成运行时长合计。 */
    @Test
    public void exportEquipmentInspectionRecord() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(equipment("EQ001", "注塑机", "张伟", 8, 62.5, "正常", ""));
        rows.add(equipment("EQ002", "空压机", "李娜", 12, 78.0, "正常", ""));
        rows.add(equipment("EQ003", "数控车床", "王强", 20, 55.5, "正常", ""));
        rows.add(equipment("EQ004", "磨床", "赵敏", 6, 48.0, "正常", ""));
        rows.add(equipment("EQ005", "铣床", "陈晨", 10, 52.0, "正常", ""));
        rows.add(equipment("EQ006", "钻床", "周涛", 4, 45.5, "正常", ""));
        // 合计占位行：运行时长合计留给 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);
        rows.add(total);

        File out = new File("D:/test/excel/biz/validation/0054_validation_equipment-inspection-record.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("crimsonRed", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Validation0054EquipmentInspectionRecordService service = factory.createApi(Validation0054EquipmentInspectionRecordService.class);
            service.exportEquipmentInspectionRecord("field", "value");
        }

    }

    /** 构造一条点检记录（a=编号，b=名称，c=点检人，d=运行时长，e=温度，f=结论，g=备注）。 */
    private static JQuickRow equipment(String code, String name, String inspector, double runningHours,
                                       double temperature, String inspectionResult, String remark) {
        JQuickRow row = new JQuickRow();
        row.put("a", code);
        row.put("b", name);
        row.put("c", inspector);
        row.put("d", runningHours);
        row.put("e", temperature);
        row.put("f", inspectionResult);
        row.put("g", remark);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0054_validation_equipment-inspection-record.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.validation.Validation0054EquipmentInspectionRecordService">

    <!-- 导出：设备点检记录填报表 -->
    <excel name="exportEquipmentInspectionRecord" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="设备点检记录填报表", HEADER=true,
                MAPPING={"a":"设备编号","b":"设备名称","c":"点检人","d":"运行时长","e":"温度","f":"点检结论","g":"备注"},
                FORMAT={"d":"0","e":"0.0"},
                FORMULAS={
                    D8:'SUM(D2:D7)'
                },
                STYLE={
                    ROW 8:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}
                }
        ]]>
    </excel>

    <!-- 导入解析：读取并校验设备点检记录填报表 -->
    <excel name="importEquipmentInspectionRecord" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="设备点检记录填报表", HEADER=true,
                MAPPING={"设备编号":"equipmentCode","设备名称":"equipmentName","点检人":"inspector","运行时长":"runningHours","温度":"temperature","点检结论":"inspectionResult","备注":"remark"},
                VALIDATION={
                    A2:A7:{min_length{required:true,msg:'设备编号至少3位',map:{minLength:3}}},
                    B2:B7:{min_length{required:true,msg:'设备名称至少2个字',map:{minLength:2}}},
                    D2:D7:{integer{required:true,msg:'运行时长必须是整数'}},
                    D2:D7:{min_value{required:true,msg:'运行时长不能小于1',map:{minValue:1}}},
                    D2:D7:{max_value{required:true,msg:'运行时长不能超过24',map:{maxValue:24}}},
                    E2:E7:{max_value{required:true,msg:'温度不能超过85',map:{maxValue:85}}},
                    F2:F7:{dict{required:true,msg:'点检结论必须在字典内',map:{'正常':'正常','异常':'异常'}}}
                }
        ]]>
    </excel>

</excels>

同分组示例

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