jOOQ中高效映射一对一关系：利用标量关联子查询嵌入关联记录

record User(
    UUID id,
    String username,
    String ipAddress,
    long lastJoinAt,
    long createdAt,
    long updatedAt,
    GuildMembersRecord guildMember // 嵌套的 GuildMembersRecord
) {}

record GuildMembersRecord(
    UUID id,
    UUID guildId,
    UUID userId,
    String role,
    OffsetDateTime updatedAt,
    OffsetDateTime createdAt
) {}

UUID key = UUID.randomUUID(); // 假设这是要查询的用户ID
// 错误的查询示例
this.context.select(
    USERS.ID,
    USERS.USERNAME,
    USERS.IP_ADDRESS,
    USERS.LAST_JOIN_AT,
    USERS.CREATED_AT,
    USERS.UPDATED_AT,
    // 尝试使用 row(Select) 嵌入 GuildMembersRecord
    row(
        DSL.select(GUILD_MEMBERS)
        .from(GUILD_MEMBERS)
        .where(GUILD_MEMBERS.USER_ID.eq(key)) // 这里应与外部查询的 USERS.ID 关联
    ).convertFrom(r -> r.into(GUILD_MEMBERS).into(GuildMembersRecord.class))
)
.from(USERS)
.where(USERS.ID.eq(key))
.fetchOne(Records.mapping(User::new));

UUID userIdToFetch = UUID.randomUUID(); // 假设这是我们要查询的特定用户ID

User userWithGuildMember = this.context.select(
    USERS.ID,
    USERS.USERNAME,
    USERS.IP_ADDRESS,
    USERS.LAST_JOIN_AT,
    USERS.CREATED_AT,
    USERS.UPDATED_AT,
    // 使用 DSL.field(Select) 构建标量关联子查询
    DSL.field(
        DSL.select(GUILD_MEMBERS) // 选择整个 GUILD_MEMBERS 表
        .from(GUILD_MEMBERS)
        // 关键：将子查询与外部查询关联。
        // 对于查询单个用户，直接使用外部传入的 userIdToFetch。
        // 如果是查询多个用户，这里应是 GUILD_MEMBERS.USER_ID.eq(USERS.ID)。
        .where(GUILD_MEMBERS.USER_ID.eq(userIdToFetch))
    ).as("guildMember") // 为子查询结果指定别名，与 User record 的字段名匹配
)
.from(USERS)
.where(USERS.ID.eq(userIdToFetch)) // 查询特定的用户
.fetchOne(Records.mapping(User::new)); // 使用 Records.mapping 映射到 User 记录

// 验证结果
if (userWithGuildMember != null) {
    System.out.println("User ID: " + userWithGuildMember.id());
    System.out.println("Username: " + userWithGuildMember.username());
    if (userWithGuildMember.guildMember() != null) {
        System.out.println("Guild Member ID: " + userWithGuildMember.guildMember().id());
        System.out.println("Guild Member Role: " + userWithGuildMember.guildMember().role());
    } else {
        System.out.println("No Guild Member found for this user.");
    }
} else {
    System.out.println("User not found.");
}