本文介绍如何在 jooq 中通过 row().mapping() 直接将关联表（如父表）的若干字段映射为 java record 或 dto，避免手动拼装或多次查询，实现简洁、类型安全的一次性嵌套结果转换。
在使用 JOOQ 进行多表关联查询时，常需将主表（如 child）与关联表（如 parent）的部分字段一并查出，并分别映射为不同层级的 Java 对象（例如 ChildDTO 包含一个 ParentDTO 字段）。关键在于：JOOQ 并不支持对任意子查询字段直接调用 .convert(...) 来构造嵌套对象，但提供了更优雅的替代方案——基于 RowN.mapping() 的行级函数式映射。
正确做法是利用 JOOQ 的 row(...).mapping(...) 静态构造器（如 row(T1, T2).mapping((id, name) -> new ParentDTO(id, name))），它会将指定字段组合成一个类型化的 Row2
以下是一个完整、可运行的示例：
// 假设已生成 jOOQ 表对象：CHILD, PARENT
record ChildDTO(Long id, String name, ParentDTO parent) {}
record ParentDTO(Long id, String name) {}
List result = dslContext
.select(
CHILD.ID,
CHILD.NAME,
row(CHILD.parent().ID, CHILD.parent().NAME)
.mapping(ParentDTO::new) // ✅ 类型安全、零反射的构造映射
)
.from(CHILD)
.fetch(Records.mapping(ChildDTO::new)); // 主记录映射，自动解包嵌套 Row ⚠️ 注意事项：
- row(...).mapping(...) 必须与字段数量严格匹配（如 row(a, b) → Row2 → mapping(BiFunction)），JOOQ 为 Row2 到 Row8 提供了专用的 mapping() 方法；
- 确保关联路径正确：此处是 CHILD.parent().ID（从 child 查 parent），而非 PARENT.child().ID（反向关系在当前查询上下文中无意义）；
- Records.mapping(...) 会自动识别 SelectField 中的 RowN 类型字段，并将其解包为对应参数传入构造函数，因此 ChildDTO 构造器签名必须与 select() 中字段顺序完全一致（id, name, ParentDTO）；
- 若需更复杂逻辑（如空值处理、条件映射），可替换为 Lambda：.mapping((pid, pname) -> pname != null ? new ParentDTO(pid, pname) : null)。
总结：与其尝试在字段层面“转换子实体”，不如将关联字段显式组织为 RowN，再用函数式映射一次性构建嵌套对象。这种方式兼具类型安全、性能高效与代码可读性，是 JOOQ 处理轻量级嵌套 DTO 的推荐实践。
