当前位置: 首页 > 知识库问答 >
问题:

对多个swagger文件使用swagger-codegen

乐正宏深
2023-03-14

我们的项目为一个API使用多个swagger文件,但swagger codegen似乎只接受一个。在这种情况下,我们如何使用swagger codegen生成代码?

共有1个答案

阮鸿煊
2023-03-14

您可以使用相对架构文件。

$ref: 'Pet.yaml'

参考:https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#relative-schema-file-example

如果 swagger 文件彼此之间没有链接/相关,则需要将 swagger 文件合并为一个文件并使用标签对操作进行分类。例如

  • https://github.com/swagger-api/swagger-codegen/blob/master/modules/swagger-codegen/src/test/resources/2_0/petstore.yaml#L14
  • https://github.com/swagger-api/swagger-codegen/blob/master/modules/swagger-codegen/src/test/resources/2_0/petstore.yaml#L32
 类似资料:
  • 我使用Spring MVC作为Rest控制器,我已经使用Springfox将Swagger用户界面与我的控制器集成在一起。我希望有一个能够通过Swagger用户界面上传文件的方法。我只需要两个参数,一个对象id的长代理和要上传的文件。 我几乎什么都试过了,但我无法显示文件上传按钮。但是,如果我这样做: 文件上载按钮出现,但在尝试上载文件时,它总是抛出http代码415。此外,我需要输入一个多部分文

  • 我在试着设置Swagger 如您所见,我添加了两个标头,但只有第一个标头随请求一起发送。如果我反转它们,那么另一个将被发送,但我从未同时发送过这两个。文档非常简单,说明: 注意!您可以在单个请求上传递多个标头参数,只需为它们使用唯一名称(上面的示例中使用了key)。 需要明确的是,这两个标头都添加到Access-Control-Allow-Headers中,并且两者都可以由服务器单独接收,情况是我

  • 我在我的Java API中使用了swagger-inflector V.1.0.17。以下是我构建API的基础:https://github.com/swagger-api/swagger-samples/tree/master/java/fintector-dropwizard-guice 我的文件上传API定义如下: 和控制器中的方法:

  • 我们希望将我们的swagger规范拆分为两个文件。一个包含endpoint,一个包含类型定义,因为类型定义用于多个项目,我们希望避免在多个源位置修复某些内容。 我们使用maven codegen插件来生成模型和api,它可以很好地进行拆分。 但是,请求验证不会,因为它无法遵循对它所显示的类型定义的外部引用。 我们使用swagger-request-validator-spring MVC进行请求验

  • 我正在尝试使用 https://github.com/swagger-api/swagger-codegen 生成 nodejs 客户端 sdk 这是我使用的命令 但是对于我需要生成的实际sdk,swagger规范被拆分为两个不同的json文件,我想为两者创建一个sdk。我如何使用Swagger-codecen做到这一点,同时使用多个swagger json?