本文详细介绍了如何通过配置`org.openapitools.generator.gradle.plugin.tasks.generatetask`来控制openapi generator生成java代码时字段的命名约定，特别是解决字段大小写自动转换的问题。通过设置`identifiernamingconvention`为`original`，开发者可以确保生成的java字段与openapi定义中的名称保持一致，从而避免不必要的命名风格冲突。
在使用OpenAPI Generator从YAML或JSON定义生成Java代码时，开发者可能会遇到一个常见问题：生成的Java类中的字段命名与OpenAPI规范中定义的名称不完全一致，特别是大小写转换。例如，一个在OpenAPI定义中为AIOBCategory的字段，在生成Java代码后可能被自动转换为aiOBCategory。这种自动转换在某些情况下可能与项目既定的编码规范不符，导致代码风格不一致或额外的重构工作。
问题根源分析
OpenAPI Generator在代码生成过程中，会应用一套默认的命名约定（Naming Convention）来确保生成的代码符合常见的编程语言规范。对于Java等语言，通常会遵循驼峰命名法（camelCase）作为字段的默认命名风格。当OpenAPI定义中的字段名不符合这种约定（例如，使用PascalCase或包含下划线等），生成器会尝试将其转换为默认的风格。这就是导致AIOBCategory变为aiOBCategory的原因。
解决方案：配置identifierNamingConvention
立即学习“Java免费学习笔记（深入）”；
为了解决这一问题，OpenAPI Generator提供了丰富的配置选项，允许开发者精细控制代码生成过程。针对字段命名约定，关键的配置项是identifierNamingConvention。通过调整此选项，我们可以指示生成器保留原始的字段名称，而不是进行自动转换。
Gradle 插件配置示例
当使用org.openapitools.generator.gradle.plugin插件时，可以在build.gradle文件中通过openApiGenerate任务的configOptions块来设置identifierNamingConvention。
以下是一个配置示例，展示了如何将identifierNamingConvention设置为original以保留字段的原始大小写：
openApiGenerate {
// 指定生成器名称，例如 "java"
generatorName = "java"
// 指定OpenAPI规范文件的路径
inputSpec = "$rootDir/spec.yaml".toString()
// 指定生成代码的输出目录
outputDir = "$buildDir/generated-src/openapi".toString()
// 配置生成选项
configOptions = [
// 设置标识符命名约定为 "original"，以保留原始字段名称
identifierNamingConvention: "original",
// 其他可能的配置选项，例如包名、模型名称等
// apiPackage: "com.example.api",
// modelPackage: "com.example.model",
// library: "jersey2" // 根据需要选择不同的库
]
}identifierNamingConvention: "original" 的作用
将identifierNamingConvention设置为"original"，会指示OpenAPI Generator在生成Java字段时，直接使用OpenAPI定义中指定的名称，而不会进行任何大小写转换或风格调整。这意味着如果您的OpenAPI定义中有一个名为AIOBCategory的属性，生成的Java字段也将是AIOBCategory，而不是aiOBCategory。
例如，对于以下OpenAPI定义片段：
AIOBCategory: type: string maxLength: 100 example: ASD1234
通过上述配置，生成的Java代码将是：
// ...
@com.fasterxml.jackson.annotation.JsonProperty("AIOBCategory")
private java.lang.String AIOBCategory;
// ...这与默认生成的private java.lang.String aiOBCategory;形成了对比，确保了字段名称与OpenAPI定义中的名称完全一致。
注意事项
- 适用性： identifierNamingConvention配置项适用于多种生成器，但其具体行为和支持的值可能因生成器而异。在应用此配置前，建议查阅您所使用的特定生成器的官方文档。
- 其他命名约定： 除了"original"，identifierNamingConvention还支持其他值，例如"snake_case"、"camelCase"、"PascalCase"等，这些选项允许开发者将字段名转换为特定的命名风格，以适应不同的编码规范。
- 官方文档： 更多关于OpenAPI Generator配置选项的详细信息，请参考OpenAPI Generator的官方配置文档：https://www.php.cn/link/8d31e1ca580336797fc5c552cc86b96b。了解这些选项将帮助您更灵活地定制代码生成过程。
总结
通过合理配置OpenAPI Generator的identifierNamingConvention选项，开发者可以有效地控制生成Java代码中字段的命名风格，确保其与OpenAPI规范定义保持一致，从而提高代码的可读性和统一性。在进行代码生成之前，理解并应用这些配置是确保生成代码符合项目规范的关键一步。
