如何精确地将数据库结果映射为展现完整层级关系的 Employee 集合结构？

本文共计1106个文字，预计阅读时间需要5分钟。

原文解释如何通过`setmapper`将`JDBC`结果集转换为``，并确保每个`employee`的`manager`字段正确引用同一集合内的其他`employee`实例，最后解决因结果集排序导致`manager`为`null`的问题。

修改后内容：

在使用 JDBC 处理具有自关联关系（如员工-经理）的扁平化结果集时，一个常见误区是在单次遍历中直接构建带 manager 引用的对象。原始实现依赖数据库返回记录的特定顺序（即经理记录必须先于其下属出现），这在实际生产环境中极不可靠——SQL 查询不保证行序（除非显式 ORDER BY），且不同数据库或执行计划可能导致顺序变化，从而引发 manager == null 的静默错误。

✅ 正确方案：两阶段映射法

核心思想是解耦“对象创建”与“关系绑定”，分两步完成：

1. 第一阶段（遍历 + 构建）：逐行读取 ResultSet，仅创建 Employee 实例（manager 初始化为 null），同时将所有员工按 ID 缓存到 Map<BigInteger, Employee> 中，并用另一张映射表 Map<BigInteger, BigInteger> 记录“谁的经理是谁”（即 employeeId → managerId）；
2. 第二阶段（关系注入）：遍历关系映射表，从缓存中查出当前员工和其经理，再通过 setter 或构造器完成引用注入。

✅ 场景一：Employee 类支持 setter（推荐用于简单场景）

public SetMapper<Set<Employee>> employeesSetMapper() { return resultSet -> { Set<Employee> employees = new HashSet<>(); Map<BigInteger, Employee> employeeMap = new HashMap<>(); Map<BigInteger, BigInteger> employeeToManagerMap = new HashMap<>(); while (resultSet.next()) { BigInteger id = BigInteger.valueOf(resultSet.getInt(1)); FullName fullName = new FullName( resultSet.getString("firstName"), resultSet.getString("lastName"), resultSet.getString("middleName") ); Position position = Position.valueOf(resultSet.getString("position")); LocalDate hired = resultSet.getDate(7).toLocalDate(); BigDecimal salary = resultSet.getBigDecimal("salary"); BigInteger managerId = BigInteger.valueOf(resultSet.getInt(6)); // 跳过无效 managerId（如 0、NULL） if (managerId != null && !managerId.equals(BigInteger.ZERO)) { employeeToManagerMap.put(id, managerId); } Employee employee = new Employee(id, fullName, position, hired, salary, null); employees.add(employee); employeeMap.put(id, employee); } // 第二阶段：批量注入 manager 引用 employeeToManagerMap.forEach((employeeId, managerId) -> { Employee employee = employeeMap.get(employeeId); Employee manager = employeeMap.get(managerId); // 安全：managerId 已校验存在 if (employee != null && manager != null) { employee.setManager(manager); } }); return employees; }; }

✅ 场景二：Employee 类不可变（无 setter，仅构造器）

若 Employee 是不可变对象（如 record 或 final 字段类），则需采用递归重建策略，确保 manager 引用链完整（包括嵌套层级）：

public SetMapper<Set<Employee>> employeesSetMapper() { return resultSet -> { Map<BigInteger, Employee> employeeMap = new HashMap<>(); Map<BigInteger, BigInteger> employeeToManagerMap = new HashMap<>(); // 阶段一：仅构建基础 Employee（manager = null） while (resultSet.next()) { BigInteger id = BigInteger.valueOf(resultSet.getInt(1)); FullName fullName = new FullName( resultSet.getString("firstName"), resultSet.getString("lastName"), resultSet.getString("middleName") ); Position position = Position.valueOf(resultSet.getString("position")); LocalDate hired = resultSet.getDate(7).toLocalDate(); BigDecimal salary = resultSet.getBigDecimal("salary"); BigInteger managerId = BigInteger.valueOf(resultSet.getInt(6)); if (managerId != null && !managerId.equals(BigInteger.ZERO)) { employeeToManagerMap.put(id, managerId); } Employee employee = new Employee(id, fullName, position, hired, salary, null); employeeMap.put(id, employee); } // 阶段二：递归构建含完整 manager 链的 Employee Map<BigInteger, Employee> enrichedMap = new HashMap<>(); for (BigInteger id : employeeMap.keySet()) { enrichedMap.put(id, getEmployeeWithManager(id, employeeMap, employeeToManagerMap)); } return new HashSet<>(enrichedMap.values()); }; } private static Employee getEmployeeWithManager( BigInteger employeeId, Map<BigInteger, Employee> employeeMap, Map<BigInteger, BigInteger> employeeToManagerMap ) { Employee base = employeeMap.get(employeeId); BigInteger managerId = employeeToManagerMap.get(employeeId); if (managerId == null || !employeeMap.containsKey(managerId)) { return base; // 无经理或经理不存在 } Employee manager = getEmployeeWithManager(managerId, employeeMap, employeeToManagerMap); return new Employee( base.getId(), base.getFullName(), base.getPosition(), base.getHireDate(), base.getSalary(), manager ); }

✅ 总结

方案	适用条件	是否依赖顺序	可扩展性
单次遍历（原始）	经理记录严格前置	✅ 强依赖	❌ 易崩坏
两阶段 + setter	Employee 可变	❌ 无关	✅ 简洁高效
递归重建	Employee 不可变	❌ 无关	✅ 支持深层嵌套

无论采用哪种方式，务必移除对结果集顺序的隐式假设。真实世界的数据访问应具备健壮性与确定性——这才是高质量数据映射的核心准则。