Java 导出「员工信息填报表」Excel 报表（数据校验）

数据校验场景 0012

员工填报信息（工号 / 姓名 / 部门 / 年龄 / 入职日期 / 月薪 / 邮箱 / 手机号），末行给出平均年龄与月薪合计；导入时逐项校验填报内容是否合规。 Java 侧仅做分组与预处理，统计与版式全部由 XML 声明。

关于这个示例

本示例导出「员工信息填报表」工作簿：1 个数据 sheet；以工号、姓名、部门、年龄、入职日期、月薪、邮箱、手机号共 8 列字段建立 MAPPING 映射、4 条公式、2 处样式规则。Java 侧只构造 4 行数据并调用一次 exportEmployeeInfo()，其余全部由配置驱动。

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

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 校验、Excel 导入数据校验 Java、Java Excel 填报模板校验规则、Java 导出员工信息填报表 Excel

输出规格

场景编号: 0012
技术分组: 数据校验
配置行数: 38
源码行数: 69

Java 源码 · Validation0012EmployeeInfoReportDemo.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.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.List;

public class Validation0012EmployeeInfoReportDemo {

    private static final String XML = "jquick/biz/validation/0012_validation_employee-info-report.xml";

    /** 导出：3 名员工 + 1 行统计，回读校验统计公式与统计行样式。 */
    @Test
    public void exportEmployeeInfo() throws Exception {
        List<JQuickRow> rows = new ArrayList<>();
        rows.add(employee("EMP001", "张三", "研发部", 26, "2023-03-15", 12000.00, "[email protected]", "13800000001"));
        rows.add(employee("EMP002", "李四", "市场部", 31, "2021-07-01", 15000.00, "[email protected]", "13900000002"));
        rows.add(employee("EMP003", "王五", "财务部", 29, "2022-11-20", 13000.00, "[email protected]", "13700000003"));
        rows.add(statRow());

        File out = new File("D:/test/excel/biz/validation/0012_validation_employee-info-report.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("bronze", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Validation0012EmployeeInfoReportService service = factory.createApi(Validation0012EmployeeInfoReportService.class);
            service.exportEmployeeInfo("field", "value");
        }

    }

    /** 构造一名员工填报行（含全部映射列）。 */
    private static JQuickRow employee(String code, String name, String dept, int age,
                                      String hireDate, double salary, String email, String phone) throws Exception {
        JQuickRow row = new JQuickRow();
        row.put("a", code);
        row.put("b", name);
        row.put("c", dept);
        row.put("d", age);
        row.put("e", new SimpleDateFormat("yyyy-MM-dd").parse(hireDate));
        row.put("f", salary);
        row.put("g", email);
        row.put("h", phone);
        return row;
    }

    /** 统计占位行：只写「统计」文字，人数 / 平均年龄 / 薪资合计三列留给 FORMULAS。 */
    private static JQuickRow statRow() {
        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);
        row.put("h", null);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0012_validation_employee-info-report.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.Validation0012EmployeeInfoReportService">

    <!-- 导出：员工信息填报表 -->
    <excel name="exportEmployeeInfo" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="员工信息填报表", HEADER=true,
                MAPPING={"a":"工号","b":"姓名","c":"部门","d":"年龄","e":"入职日期","f":"月薪","g":"邮箱","h":"手机号"},
                FORMAT={"d":"0","e":"yyyy-MM-dd","f":"#,##0.00"},
                FORMULAS={D5:'AVERAGE(D2:D4)',F5:'SUM(F2:F4)'},
                STYLE={ROW 5:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}}
        ]]>
    </excel>

    <!-- 导入解析：读取填报结果并逐项校验（校验不通过时抛出异常，异常信息即规则 msg） -->
    <excel name="importEmployeeInfo" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="员工信息填报表", HEADER=true,
                MAPPING={"工号":"code","姓名":"name","部门":"dept","年龄":"age","入职日期":"hireDate","月薪":"salary","邮箱":"email","手机号":"phone"},
                VALIDATION={
                    COL A:{max_length{required:true,msg:'工号最长10位',map:{maxLength:10}}},
                    A2:A4:{min_length{required:true,msg:'工号至少4位',map:{minLength:4}}},
                    B2:B4:{min_length{required:true,msg:'姓名至少2个字',map:{minLength:2}}},
                    C2:C4:{dict{required:true,msg:'部门必须在字典内（研发部/市场部/财务部）',map:{'研发部':'研发部','市场部':'市场部','财务部':'财务部'}}},
                    D2:D4:{integer{required:true,msg:'年龄必须是整数'}},
                    D2:D4:{min_value{required:true,msg:'年龄不能小于18',map:{minValue:18}}},
                    D2:D4:{max_value{required:true,msg:'年龄不能超过60',map:{maxValue:60}}},
                    G2:G4:{email{required:true,msg:'邮箱格式无效'}},
                    H2:H4:{mobile{required:true,msg:'手机号格式无效'}},
                    H2:H4:{regex{required:true,msg:'手机号必须是11位且以1[3-9]开头',map:{pattern:'^1[3-9][0-9]{9}$'}}}
                }
        ]]>
    </excel>

</excels>

同分组示例

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