如何在jOOQ中更地道地使用PostgreSQL的row_to_json()函数

你手写原生SQL的写法可以正常运行，但jOOQ提供了类型安全的调用方式，完全不需要拼接纯SQL字符串，以下是两种符合框架范式的实现：

1. 通用function()调用的正确写法 #

你之前尝试function()调用失败，核心是没有正确指定返回值类型、传入行参数，补全后的代码如下：

import org.jooq.JSON;
import static org.jooq.impl.DSL.function;
// 替换为你项目中jOOQ代码生成器产出的Tables类路径
import static com.yourproject.jooq.generated.Tables.PERSONS;

List<JSON> jsons = context
        .select(function("row_to_json", JSON.class, PERSONS.as("p")).as("j"))
        .from(PERSONS.as("p"))
        .stream()
        .map(r -> r.get("j", JSON.class))
        .toList();

参数说明：

• 第二个参数固定传入JSON.class，明确告诉jOOQ该函数的返回值类型，才能完成自动类型映射
• 第三个参数直接传入表引用（支持带别名的表实例），jOOQ会自动将其渲染为合法的行表达式，不需要额外做包装

2. 更简洁的内置方言函数写法 #

jOOQ 3.14及以上版本已经对PostgreSQL专属的row_to_json做了内置封装，不需要手动声明函数名，直接调用PostgresDSL下的原生方法即可，类型安全性更高：

import org.jooq.JSON;
import static org.jooq.PostgresDSL.rowToJson;
import static com.yourproject.jooq.generated.Tables.PERSONS;

List<JSON> jsons = context
        .select(rowToJson(PERSONS).as("j"))
        .from(PERSONS)
        .fetch(r -> r.get("j", JSON.class));

如果不需要自定义字段别名，还可以用fetchValues进一步简化结果提取逻辑：

List<JSON> jsons = context
        .select(rowToJson(PERSONS))
        .from(PERSONS)
        .fetchValues(0, JSON.class);

以上写法最终生成的SQL和你手写的原生SQL完全一致，同时能享受jOOQ的类型校验、语法自动适配能力，避免硬编码SQL字符串带来的拼写错误。

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