如何在jOOQ中实现列的仅插入（不可变）特性？

核心实现思路 #

jOOQ没有直接提供「仅插入列」的官方配置项，但可以通过代码生成器自定义配置+扩展逻辑，实现和JPA @Column(updatable=false) 完全一致的效果，且无需依赖JPA：

• 步骤1：通过代码生成器标记目标列
  在jOOQ代码生成的XML配置中，使用<forcedType>给需要仅插入的列添加自定义属性标记，示例如下：

  <forcedType>
    <userType>java.lang.Long</userType> <!-- 替换为列的实际数据类型 -->
    <expression>YOUR_SCHEMA.YOUR_TABLE.TARGET_COLUMN</expression> <!-- 匹配目标列 -->
    <properties>
      <property key="insertOnly" value="true"/>
    </properties>
  </forcedType>
  

  生成代码后，目标列会携带这个自定义属性，方便后续逻辑识别。

• 步骤2：通过RecordListener拦截更新操作
  编写自定义RecordListener，在更新事件触发前，自动移除仅插入列的修改标记，让jOOQ在生成UPDATE语句时忽略这些列：

  public class InsertOnlyColumnHandler extends DefaultRecordListener {
    @Override
    public void updateStart(RecordContext ctx) {
      Record record = ctx.record();
      for (Field<?> field : record.fields()) {
        // 读取之前配置的insertOnly属性，判断是否为仅插入列
        if ("true".equals(field.getProperties().get("insertOnly"))) {
          record.changed(field, false);
        }
      }
    }
  }
  

  最后将这个监听器注册到jOOQ的全局配置中：

  Configuration jooqConfig = new DefaultConfiguration()
    .set(SQLDialect.POSTGRES) // 替换为你的数据库方言
    .set(new DefaultConnectionProvider(dataSource.getConnection()))
    .set(new InsertOnlyColumnHandler());
  

• 步骤3：DAO层的补充控制（可选）
  如果你使用jOOQ生成的DAO类，可以继承生成的DAO，重写update()方法，手动排除仅插入列，进一步确保更新逻辑的安全性：

  public class CustomYourTableDAO extends YourTableDAO {
    public CustomYourTableDAO(Configuration configuration) {
      super(configuration);
    }
  
    @Override
    public int update(YourTableRecord record) {
      // 移除仅插入列的修改状态
      record.changed(YourTable.TARGET_COLUMN, false);
      return super.update(record);
    }
  }
  

关于只读列功能的补充说明 #

你提到的jOOQ只读列功能默认会禁止插入和更新，并不适用于仅插入的场景，所以不建议基于该功能改造，还是上面的自定义方案更贴合需求。

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