JOOQ多表关联查询含同名字段时如何返回自定义Table及Record

问题本质 #

你直接调用asTable()返回的是jOOQ内置的通用TableImpl实例，和你自定义的MyCustomTable是没有继承关联的独立类，因此直接强转必然抛出ClassCastException。以下是3种可行的实现方案：

方案1：使用jOOQ原生别名映射（推荐，适配jOOQ 3.10+版本） #

jOOQ提供了Select.as(Table<R>)的重载方法，支持直接将查询结果映射为你指定的自定义表类型，只需要保证查询输出的字段名称、顺序、类型和自定义表的字段完全匹配即可。
修改后的代码示例：

public MyCustomTable getTableReusable(final DSLContext ctx,
    final Profile profile, final LocalDate date) {
    final Table<Table1Record> tab1 = Table1.TABLE1.as("a");
    final Table<Table2Record> tab2 = Table2.TABLE2.as("b");
    
    return (MyCustomTable) ctx.select(
            tab1.ID.as(MyCustomTable.TAB1_ID), 
            tab1.A_FIELD.as(MyCustomTable.TAB1_A_FIELD), 
            tab2.ID.as(MyCustomTable.TAB2_ID), 
            tab2.B_FIELD.as(MyCustomTable.TAB2_B_FIELD)
        )
        .from(tab1)
        .leftJoin(tab2)
        .on(tab1.ID.eq(tab2.TAB1_FK))
        .as(MyCustomTable.MY_CUSTOM_TABLE); // 用自定义表的单例实例作为别名目标
}

注：这里的MyCustomTable.MY_CUSTOM_TABLE是你自定义表类中定义的单例对象，和jOOQ代码生成器生成的表类的单例定义一致。

方案2：直接映射为自定义记录类型（更符合常规使用场景） #

如果你封装方法的核心诉求是让调用方可以便捷访问记录字段，不需要返回表对象，那可以直接将查询结果强制映射为你的CustomRecord类型，调用方直接fetch就能拿到强类型的记录集合：

public ResultQuery<MyCustomRecord> queryTableReusable(final DSLContext ctx,
    final Profile profile, final LocalDate date) {
    final Table<Table1Record> tab1 = Table1.TABLE1.as("a");
    final Table<Table2Record> tab2 = Table2.TABLE2.as("b");
    
    return ctx.select(
            tab1.ID.as(MyCustomTable.TAB1_ID), 
            tab1.A_FIELD.as(MyCustomTable.TAB1_A_FIELD), 
            tab2.ID.as(MyCustomTable.TAB2_ID), 
            tab2.B_FIELD.as(MyCustomTable.TAB2_B_FIELD)
        )
        .from(tab1)
        .leftJoin(tab2)
        .on(tab1.ID.eq(tab2.TAB1_FK))
        .coerce(MyCustomRecord.class); // 直接映射到自定义记录类型
}

调用示例：

Result<MyCustomRecord> result = queryTableReusable(ctx, profile, date).fetch();
// 直接访问强类型字段
Long tab1Id = result.get(0).getTab1Id();

方案3：自定义表类扩展构造方法适配子查询 #

如果你确实需要返回MyCustomTable实例，且jOOQ版本不支持方案1的语法，可以给自定义表类新增适配子查询的构造方法：

public class MyCustomTable extends TableImpl<MyCustomRecord> {
    // 原有字段、单例定义、默认构造方法省略
    // 新增子查询适配构造方法
    public MyCustomTable(String alias, Table<MyCustomRecord> underlyingTable) {
        super(alias, underlyingTable.getSchema(), underlyingTable);
    }

    @Override
    public MyCustomTable as(String alias) {
        return new MyCustomTable(alias, this);
    }
}

原方法修改为：

public MyCustomTable getTableReusable(final DSLContext ctx,
    final Profile profile, final LocalDate date) {
    final Table<Table1Record> tab1 = Table1.TABLE1.as("a");
    final Table<Table2Record> tab2 = Table2.TABLE2.as("b");
    
    Table<Record> commonTable = ctx.select(
            tab1.ID.as(MyCustomTable.TAB1_ID), 
            tab1.A_FIELD.as(MyCustomTable.TAB1_A_FIELD), 
            tab2.ID.as(MyCustomTable.TAB2_ID), 
            tab2.B_FIELD.as(MyCustomTable.TAB2_B_FIELD)
        )
        .from(tab1)
        .leftJoin(tab2)
        .on(tab1.ID.eq(tab2.TAB1_FK))
        .asTable();
    return new MyCustomTable("custom_tab", (Table<MyCustomRecord>) commonTable);
}

注意事项 #

所有方案都需要保证查询输出的字段和自定义表/自定义记录的字段名称、顺序、数据类型完全匹配，否则会出现字段值为空、类型转换异常等问题。

内容的提问来源于stack exchange，提问作者Ghost