如何指定OpenAPI生成Java代码时的字段大小写规则？

要让OpenAPI Gradle生成器直接使用你在YAML中定义的原始字段名（如AIOBCategory），而不是自动转换为驼峰格式并添加@JsonProperty注解，可以通过以下方式配置：

核心配置参数 #

使用Java生成器的useOriginalFieldNames配置项，将其设为true即可强制保留字段的原始大小写。

Gradle任务配置示例 #

在你的GenerateTask配置中添加该参数，有两种方式可选：

方式1：通过configOptions设置 #

tasks.withType(org.openapitools.generator.gradle.plugin.tasks.GenerateTask) {
    generatorName = "java"
    inputSpec = file("src/main/resources/openapi.yaml").path
    outputDir = file("$buildDir/generated/openapi").path
    
    configOptions = [
        useOriginalFieldNames: "true",
        // 可添加其他生成器配置项，如library: "jersey2"等
    ]
}

方式2：通过generatorArgs添加命令行参数 #

tasks.withType(org.openapitools.generator.gradle.plugin.tasks.GenerateTask) {
    generatorName = "java"
    inputSpec = file("src/main/resources/openapi.yaml").path
    outputDir = file("$buildDir/generated/openapi").path
    
    generatorArgs += "--use-original-field-names"
}

效果说明 #

配置生效后，生成的Java类字段会直接匹配你在OpenAPI YAML中定义的名称，例如：

private java.lang.String AIOBCategory;

同时因为字段名与JSON键名一致，生成器不会额外添加@JsonProperty注解。

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