Java 导出「员工主数据码值转换表」Excel 报表（数据转换）

数据转换场景 0101

员工主数据里性别 / 部门 / 状态以内部码值存储，导出时按字典转成中文；纯 XML 声明式实现，无需编写 Java 业务代码。

关于这个示例

本示例导出「员工主数据码值转换表」工作簿：1 个数据 sheet；以工号、姓名、性别、部门、入职日期、状态、年假共 7 列字段建立 MAPPING 映射。Java 侧只构造 6 行数据并调用一次 exportEmployeeMasterData()，其余全部由配置驱动。

这个示例属于「数据转换」分组：演示 TRANSFORM 字段转换：码值映射、日期格式化、脱敏等导出期转换规则。

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 数据转换、Excel 码值映射 Java、Java Excel 日期格式化导出、Java 导出员工主数据码值转换表 Excel

输出规格

场景编号: 0101
技术分组: 数据转换
配置行数: 26
源码行数: 73

Java 源码 · Transform0101EmployeeMasterDataDemo.java

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

package com.github.paohaijiao.biz.transform;

import com.github.paohaijiao.param.JContext;
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.HashMap;
import java.util.List;
import java.util.Map;

public class Transform0101EmployeeMasterDataDemo {

    private static final String XML = "jquick/biz/transform/0101_transform_employee-master-data.xml";

    /** 导出：内部码值经 TRANSFORM 字典转为中文，回读校验性别 / 部门 / 状态三列。 */
    @Test
    public void exportEmployeeMasterData() throws Exception {
        JContext ctx = new JContext();
        Map<String, Object> dict = new HashMap<>();
        // 性别码值
        dict.put("1", "男");
        dict.put("2", "女");
        // 部门码值
        dict.put("RD", "研发部");
        dict.put("MK", "市场部");
        dict.put("FN", "财务部");
        // 状态码值
        dict.put("A", "在职");
        dict.put("B", "离职");
        ctx.put("dict", dict);

        List<JQuickRow> rows = new ArrayList<>();
        rows.add(employee("E2601", "张伟", "1", "RD", "2019-03-01", "A", 6));
        rows.add(employee("E2602", "李娜", "2", "MK", "2020-06-15", "A", 8));
        rows.add(employee("E2603", "王强", "1", "FN", "2018-09-20", "B", 0));
        rows.add(employee("E2604", "刘洋", "2", "RD", "2021-01-10", "A", 5));
        rows.add(employee("E2605", "陈静", "1", "MK", "2017-11-05", "A", 12));
        rows.add(employee("E2606", "赵磊", "2", "FN", "2022-03-18", "A", 3));

        File out = new File("D:/test/excel/biz/transform/0101_transform_employee-master-data.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("navyBlue", ctx, rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Transform0101EmployeeMasterDataService service = factory.createApi(Transform0101EmployeeMasterDataService.class);
            service.exportEmployeeMasterData("field", "value");
        }

    }

    /** 构造一条员工主数据（c/d/f 为内部码值，导出时经字典转中文；e 为日期对象走 FORMAT）。 */
    private static JQuickRow employee(String no, String name, String sex, String dept,
                                      String hireDate, String status, int leaveDays) throws Exception {
        JQuickRow row = new JQuickRow();
        row.put("a", no);
        row.put("b", name);
        row.put("c", sex);
        row.put("d", dept);
        row.put("e", new SimpleDateFormat("yyyy-MM-dd").parse(hireDate));
        row.put("f", status);
        row.put("g", leaveDays);
        return row;
    }
}

最小调用（4 行）

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

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

XML 配置 · 0101_transform_employee-master-data.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.transform.Transform0101EmployeeMasterDataService">

    <!-- 导出：内部码值 -> 中文 -->
    <excel name="exportEmployeeMasterData" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="员工主数据", HEADER=true,
                MAPPING={"a":"工号","b":"姓名","c":"性别","d":"部门","e":"入职日期","f":"状态","g":"年假"},
                FORMAT={"e":"yyyy-MM-dd","g":"0"},
                TRANSFORM={"c":trans(${dict},${c}),"d":trans(${dict},${d}),"f":trans(${dict},${f})}
        ]]>
    </excel>

    <!-- 导入解析：日期归一，其余字段按表头映射 -->
    <excel name="importEmployeeMasterData" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="员工主数据", HEADER=true,
                MAPPING={"工号":"employeeNo","姓名":"name","性别":"sex","部门":"dept","入职日期":"hireDate","状态":"status","年假":"leaveDays"},
                TRANSFORM={"hireDate":dateFormat(${hireDate},'yyyy-MM-dd')}
        ]]>
    </excel>

</excels>

同分组示例

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