JOOQ对接SQL Server 2019结合Prepared Statements使用问题咨询

1. 使用PreparedStatement不会违背jOOQ的设计初衷 #

jOOQ默认执行查询时内部就依赖JDBC的PreparedStatement实现，不存在额外增加处理层的问题。你手动创建PreparedStatement的操作，本质是把jOOQ原本内部做的SQL渲染、语句创建步骤提前做了缓存，只要SQL语句、参数绑定逻辑完全由jOOQ生成，不自行拼接SQL字符串，类型安全、防SQL注入的特性就会完全保留，不会破坏原有设计。

2. 结合逻辑 #

核心思路是把jOOQ作为SQL生成、参数管理、结果映射的工具，只把语句创建、参数绑定、执行的环节交给原生JDBC，完全规避手动写SQL的风险，同时享受缓存SQL带来的性能收益。
结合时只需要遵循两个原则：

• 所有SQL语句都通过jOOQ的DSL API生成，不手动修改生成的SQL字符串
• 参数绑定直接使用jOOQ返回的绑定值列表，不手动数占位符位置

3. 示例代码 #

注：示例中的PEOPLE、PeopleRecord均为jOOQ代码生成器根据数据库表自动生成的类，全程不需要手动编写SQL字符串

首先初始化jOOQ上下文：

// 初始化jOOQ的DSLContext，指定SQL Server 2019方言
DSLContext dsl = DSL.using(SQLDialect.SQLSERVER2019);

常规用法 #

// 1. 生成查询模板
ResultQuery<?> queryTemplate = dsl.selectFrom(PEOPLE)
  .where(PEOPLE.ID.eq((Long) null));
// 2. 提取SQL模板（可全局缓存）
String sql = queryTemplate.getSQL();

try (
  // 3. 创建PreparedStatement
  PreparedStatement ps = connection.prepareStatement(sql);
) {
  // 4. 生成绑定参数，自动匹配类型和位置
  Query bindedQuery = dsl.selectFrom(PEOPLE).where(PEOPLE.ID.eq(123L));
  List<Object> bindValues = bindedQuery.getBindValues();
  for (int i = 0; i < bindValues.size(); i++) {
    ps.setObject(i + 1, bindValues.get(i));
  }

  // 5. 执行查询
  try (ResultSet rs = ps.executeQuery()) {
    // 6. 用jOOQ映射结果集，无需手动解析
    List<PeopleRecord> records = dsl.fetch(rs).into(PeopleRecord.class);
    // 处理业务逻辑
  }
} catch (SQLException e) {
  // 异常处理逻辑
}

高频查询优化写法 #

如果是执行频率很高的查询，可以把SQL模板全局缓存，应用启动时生成一次即可，省去每次渲染SQL的开销：

// 全局缓存SQL模板
private static final String SELECT_PEOPLE_BY_ID = 
  DSL.using(SQLDialect.SQLSERVER2019)
    .selectFrom(PEOPLE)
    .where(PEOPLE.ID.eq((Long) null))
    .getSQL();

后续调用直接使用缓存的SELECT_PEOPLE_BY_ID创建PreparedStatement即可。

补充说明 #

如果没有特别精细化的缓存控制需求，直接开启jOOQ自带的语句缓存配置即可，不需要手动编写PreparedStatement相关逻辑，jOOQ内部会自动处理SQL渲染、参数绑定、语句复用的全部流程。

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