昂首阔步。 OpenAPI 3. 一个 ymal 文件中的多个规范

Question

我正在使用 Swagger 3 并通过 gradle 插件 (https://github.com/int128/gradle-swagger-generator-plugin) 生成文档。

假设我有 4 个端点。 我想根据 uri 将它们分开。 假设端点 1-2 的 uri 像“/api/v1/”，端点 3-4 的 uri 像“/api/v1/something” 我希望将它们在 Swagger UI 中分成 2 组。我不能使用标签，因为它们已经用于一组内的分隔。

当我从 Java/Spring 生成文档时，我使用了 springfox，它允许我做接下来的事情：

@EnableSwagger2
public class SwaggerConfig {

@Bean
public Docket swaggerSomeGroup() {
    return new Docket(DocumentationType.SWAGGER_2)
            .groupName("SomeGroup")
            .tags(sometags)
            .select()
            .apis(RequestHandlerSelectors.basePackage("somepackage"))
            .paths(PathSelectors.ant("/api/v1/something/**"))
            .build()
        ////
}

 @Bean
public Docket swaggerSomeOtherGroup() {
    return new Docket(DocumentationType.SWAGGER_2)
            .groupName("SomeOtherGroup")
            .tags(sometags)
            .select()
            .apis(RequestHandlerSelectors.basePackage("somepackage"))
            .paths(Predicates.not(PathSelectors.ant("/api/v1/something/**")))
            .build()
        ////
}

因此，我可以从 Swagger UI 的下拉菜单中选择所需的规范。

我可以在 yml 和 swagger 生成器中做同样的事情吗？

Answer 1

看起来不可能是代码生成插件的手段。唯一可能的解决方案是修改 UI 招摇。