是否可以为生成的 openApi 规范文件设置特定的包名称

Question

在我们的项目（java/spring/gradle 堆栈）中，我们使用的是 openApi 规范。我们为他们提供了一些服务和规格。此外，我们还有在每个规范中重复的通用模块。我们将这些通用模块移动到单独的规范文件中，并将它们包含在其他文件中。例如：

specific_project1:
   openapi:
      spec.yaml
      common_modules.yaml
   build.gradle

spec.yaml 有下一个代码：

openapi: 3.0.0
info:
  version: 0.0.1
paths:
  /specific/post:
    post:
      requestBody:
        context:
          application/json:
             schema:
               $ref: "common_modules.yaml#/components/schemas/TestModule"

还有common_modules.yaml下一个：

openapi: 3.0.0
info:
  version: 0.0.1
components:
  schemas:
    TestModule:
      type: object
      properties:
        value:
          type: string

因此，我们需要使用包名com.specific.project1 生成spec.yaml，使用包名com.common.modules 生成common_modules.yaml 并且从spec.yaml 生成的生成的java 类有一个导入TestModule 在导入中带有包 com.common.modules。

Answer 1

有可能

当你在build.grade中添加openapi插件时

plugins { 
 
       id "org.openapi.generator" version "4.3.0"
}

您将可以访问 openApiGenerate Task ，

这可以像这样修改，例如：

openApiGenerate {
    generatorName = "jaxrs-jersey"
    inputSpec = "$rootDir/spec-v1.yaml".toString()
    outputDir = "$rootDir/".toString()
    apiPackage = "name.of.api.package.rest.server.v1.api"
    invokerPackage = "name.of.api.package.rest.server.v1.invoker"
    modelPackage = "name.of.api.package.rest.server.v1.model"
    configOptions = [
        library: "jersey2"
    ]
}

这里是您可以进行的与 spring 相关的所有可能修改的链接，例如 https://github.com/OpenAPITools/openapi-generator/blob/master/docs/generators/spring.md

以及生成器的完整列表：https://github.com/OpenAPITools/openapi-generator/tree/master/docs/generators

为了在单个项目中使用 2 个 yaml 文件，您必须这样做。

task common(type: org.openapitools.generator.gradle.plugin.tasks.GenerateTask){
generatorName = "spring"
inputSpec = "$rootDir//schema/common.yaml".toString()
outputDir = "$rootDir/generated".toString()
apiPackage = "com.abc.code.generated.controller"
modelPackage = "com.abc.code.generated.model"
configOptions = [
        dateLibrary: "java8"
]
systemProperties = [
    invoker : "false", 
    generateSupportingFiles: "true"
]
additionalProperties = [
    interfaceOnly : "true",
]

您可以将 openApiGenerate 留给 spec.yaml 但请务必添加

compileJava.dependsOn common , tasks.openApiGenerate 

所以你会同时执行它们。 希望我有所帮助。