jOOQ多表查询同名字段时如何自动生成带表前缀的列别名

问题背景 #

使用jOOQ生成SQL、交由Vert.x SqlClient执行时，多表关联场景下同名字段不会自动加别名，结果集中重名字段会被覆盖，无法完成映射。
原有查询代码：

val userTable = USER_ACCOUNT.`as`("u")
val productTable = PRODUCT.`as`("p") 

create().select().from(userTable).join(productTable).on(userTable.ID.eq(productTable.AUTHOR_ID))

默认生成SQL存在重名问题：

SELECT "u"."id", "u"."name", ..., "p"."id", "p"."name", ... FROM ...

期望自动生成如下带别名的SQL，无需手动遍历字段映射：

SELECT "u"."id" AS "u.id", "u"."name" AS "u.name", ..., "p"."id" AS "p.id", "p"."name" AS "p.name" ...

原生配置方案 #

jOOQ 3.17+ 版本内置了对应配置，适配PostgreSQL方言，不需要任何hack写法：

• 初始化jOOQ DSLContext时，在Settings中开启隐式列别名规则：

import org.jooq.SQLDialect
import org.jooq.conf.ImplicitColumnAliasType
import org.jooq.conf.RenderNameCase
import org.jooq.conf.Settings
import org.jooq.impl.DSL

val settings = Settings()
    // 核心配置：多表查询时自动生成「表别名.列名」格式的列别名
    .withRenderImplicitColumnAliasType(ImplicitColumnAliasType.TABLE_ALIAS)
    // 可选：适配PostgreSQL默认小写标识符习惯
    .withRenderNameCase(RenderNameCase.LOWER)
val create = DSL.using(SQLDialect.POSTGRES, settings)

配置生效后，原有查询代码不需要做任何修改，调用query.getSQL(ParamType.NAMED)就会直接输出符合预期的带别名SQL，自动处理任意数量关联表、派生表、子查询的同名字段冲突。

• 如果不需要全局开启该规则，可针对单个查询临时覆盖配置：

val query = create()
    .select()
    .from(userTable)
    .join(productTable).on(userTable.ID.eq(productTable.AUTHOR_ID))
    // 仅当前查询生效
    .set(Settings().withRenderImplicitColumnAliasType(ImplicitColumnAliasType.TABLE_ALIAS))

注意事项 #

当前使用的临时遍历字段加别名的方案存在笔误：user表字段别名错误使用了p.前缀，会导致两表字段别名再次冲突，且手动映射字段的方式在表结构变更、关联表数量增加时需要同步修改代码，维护成本高，直接替换为原生配置即可。

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