如何结合Query#getSQL()与Query#getBindValues()实现无jOOQ依赖的查询？

我希望用jOOQ生成SQL查询后，彻底摆脱对jOOQ的依赖来执行后续操作。参考jOOQ作为SQL构建器的用法，复用示例代码如下：

// 从jOOQ Query中提取SQL字符串，方便用其他工具手动执行
// 为简化示例，这里用API构造大小写不敏感的对象引用
Query query = create.select(field("BOOK.TITLE"), field("AUTHOR.FIRST_NAME"), field("AUTHOR.LAST_NAME"))
                    .from(table("BOOK"))
                    .join(table("AUTHOR"))
                    .on(field("BOOK.AUTHOR_ID").eq(field("AUTHOR.ID")))
                    .where(field("BOOK.PUBLISHED_IN").eq(1948));
String sql = query.getSQL();
List<Object> bindValues = query.getBindValues();

用生成的sql和bindValues可以创建PreparedStatement，但要查询其他年份时，现有两种方案都有明显缺陷：

• 方案1：再次将目标年份传入jOOQ查询构建器——但我不想在生成查询后还依赖jOOQ
• 方案2：手动确认参数在SQL中的位置（比如示例中年份对应参数?1）——脱离jOOQ后，得手动检查SQL调整参数顺序，既麻烦又容易出错

我试过Query#getParams()，但它返回的是无序的Map，还包含被DSL.inline渲染到SQL里的Param对象，完全不是我需要的内容。

我需要的是：无需依赖jOOQ，就能准确知晓绑定参数的顺序。比如给参数设置别名（比如year），让jOOQ告诉我这个参数在SQL中的位置（示例中是1），如果同一命名参数多次出现，要返回所有对应的位置。

1. 构造查询时显式使用命名参数 #

首先在构建jOOQ查询时，不要直接传字面量，而是创建带名称的参数：

// 创建命名参数，指定参数名"year"和初始值1948
Param<Integer> yearParam = param("year", 1948);
Query query = create.select(field("BOOK.TITLE"), field("AUTHOR.FIRST_NAME"), field("AUTHOR.LAST_NAME"))
                    .from(table("BOOK"))
                    .join(table("AUTHOR"))
                    .on(field("BOOK.AUTHOR_ID").eq(field("AUTHOR.ID")))
                    .where(field("BOOK.PUBLISHED_IN").eq(yearParam));

2. 生成SQL并构建参数位置映射 #

生成SQL时，先获取带命名占位符的版本，再通过jOOQ的API构建参数名到位置索引的映射（位置从1开始，对应PreparedStatement的参数索引）：

// 获取带命名占位符的SQL，格式类似 ... WHERE BOOK.PUBLISHED_IN = :year
String namedSql = query.getSQL(ParamType.NAMED);

// 初始化参数位置映射：key是参数名，value是该参数对应的所有位置索引
Map<String, List<Integer>> paramPositionMap = new HashMap<>();
int currentPosition = 1;

// 遍历绑定值，关联对应的命名参数
for (Object value : query.getBindValues()) {
    // 过滤出非inline的参数（即需要绑定的参数）
    for (Map.Entry<String, Param<?>> entry : query.getParams().entrySet()) {
        Param<?> param = entry.getValue();
        if (!param.isInline() && param.getValue().equals(value)) {
            // 给参数名对应的位置列表添加当前索引
            paramPositionMap.computeIfAbsent(entry.getKey(), k -> new ArrayList<>()).add(currentPosition);
            break;
        }
    }
    currentPosition++;
}

3. 脱离jOOQ后的使用方式 #

拿到namedSql和paramPositionMap后，就可以完全脱离jOOQ：

• 如果你的JDBC驱动支持命名参数，可以直接用namedSql创建PreparedStatement，按参数名设置值
• 如果驱动不支持命名参数，自己写个简单的替换逻辑，把所有:year这类占位符替换成?，后续换参数值时，直接通过paramPositionMap找到对应的索引设置即可

备选方案：预生成参数元数据 #

如果不想处理命名参数，也可以在生成查询阶段，用jOOQ的RenderContext收集参数的元数据（名称、位置、类型），把这些元数据和SQL一起序列化保存下来，后续脱离jOOQ时直接使用这些元数据来设置参数。

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