如何在无数据库连接时通过JOOQ编译期生成Record？

以下是几种完全不依赖数据库连接的编译期Record生成方案，适配Java生态下的构建流程：

1. 基于本地元数据文件生成 #

将表结构定义在JSON/YAML/XML等本地文件中，通过自定义构建插件或模板引擎在编译期解析文件生成Record。

示例步骤： #

• 编写元数据文件（如table-defs.json）：

[
  {
    "tableName": "user",
    "recordName": "UserRecord",
    "package": "com.example.model",
    "fields": [
      {"name": "id", "type": "Long"},
      {"name": "username", "type": "String"},
      {"name": "email", "type": "String"}
    ]
  }
]

• 用Freemarker/Velocity编写Record模板（如record-template.ftl）：

package ${package};

public record ${recordName}(
<#list fields as field>
    ${field.type} ${field.name}<#if field_has_next>,</#if>
</#list>
) {}

• 在Maven/Gradle中配置构建步骤：通过exec-maven-plugin执行自定义Java类，读取元数据文件+模板，生成Record代码到target/generated-sources/java目录（该目录会被编译器自动识别编译）。

2. 基于自定义注解+注解处理器 #

通过自定义注解在代码中声明表结构，编写注解处理器在编译期扫描注解并生成Record。

示例步骤： #

• 自定义元数据注解：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.SOURCE)
public @interface TableDef {
    String tableName();
    FieldDef[] fields();
}

@Target(ElementType.ANNOTATION_TYPE)
public @interface FieldDef {
    String name();
    Class<?> type();
}

• 在代码中标记元数据：

@TableDef(
    tableName = "user",
    fields = {
        @FieldDef(name = "id", type = Long.class),
        @FieldDef(name = "username", type = String.class)
    }
)
public class UserTableMarker {}

• 编写注解处理器：继承AbstractProcessor，在process()方法中解析@TableDef注解，用JavaPoet或字符串拼接生成Record代码，输出到生成源目录。

3. 静态代码生成工具（独立执行） #

用JavaPoet、CodeModel等代码生成库编写独立生成器，手动或通过构建脚本触发生成，将代码直接写入项目源码目录。

示例代码（JavaPoet）： #

public class RecordGenerator {
    public static void main(String[] args) throws IOException {
        TypeSpec userRecord = TypeSpec.recordBuilder("UserRecord")
            .addModifiers(Modifier.PUBLIC)
            .addField(Long.class, "id", Modifier.PRIVATE, Modifier.FINAL)
            .addField(String.class, "username", Modifier.PRIVATE, Modifier.FINAL)
            .build();

        JavaFile javaFile = JavaFile.builder("com.example.model", userRecord)
            .build();

        javaFile.writeTo(new File("src/main/java"));
    }
}

• 将该生成器的执行步骤加入构建流程（如Maven的pre-compile阶段），实现编译前自动生成Record。

这些方案的核心是将表结构元数据从数据库转移到本地文件、注解或代码中，完全脱离数据库连接依赖，实现编译期的Record生成。

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