Swagger上的API分割

Question

我有一个关于微服务架构应用Swagger的问题。应用程序是用Jhipster生成的。由于我的后端应用程序有很多endpoint，所以将那些endpoint加载到swagger是不可能的（整个网关应用程序会被卡住）。所以，我的想法是在Swagger（过滤器）上做某种endpoint组。目前，gateway app下拉列表中的API item打开了带有两个项的Swagger UI，default(/v2/api-docs）和service（/service/v2/api-docs）项。点击第二个项目得到完整的网关应用程序加载所有endpoint卡住。所以，我尝试制作多个下拉项，而不是一个项(service(service/v2/api-docs))。我遵循了这个教程:https://piotrminkowski.wordpress.com/2017/04/14/microservices-api-documentation-with-swagger2/，所以，在我的网关应用程序中，我有GatewayswaggerresourceProvider：

@Override
public List<SwaggerResource> get() {
    List<SwaggerResource> resources = new ArrayList<>();

    //Add the default swagger resource that correspond to the gateway's own swagger doc
    resources.add(swaggerResource("default", "/v2/api-docs"));

    //Add the registered microservices swagger docs as additional swagger resources
    List<Route> routes = routeLocator.getRoutes();
    routes.forEach(route -> {
        resources.add(swaggerResource(route.getId(), route.getFullPath().replace("**", "v2/api-docs")));
    });

    return resources;
}

@Bean
UiConfiguration uiConfig() {
    return new UiConfiguration("validatorUrl", "list", "alpha", "schema",
        UiConfiguration.Constants.DEFAULT_SUBMIT_METHODS, false, true, 60000L);
}

@Bean
public Docket api() throws IOException {
    return new Docket(DocumentationType.SWAGGER_2)
        .groupName("product")
        .select()
        .apis(RequestHandlerSelectors.basePackage("kango.web.rest"))
        .paths(PathSelectors.ant("/product-types/*"))
        .build()
        .apiInfo(apiInfo());
}

在此之后，我重新启动了这两个应用程序，并且Swagger仍然在下拉列表中显示初始的两个项目。我需要的是有多个项目与相似的endpoint组。

我已经浪费了很多时间，在询问之前做了很好的研究，所以请，帮帮我...

Answer 1

您可以在@API下定义标记来对它们进行分组。但它不会给您一个不同的swagger json文件。为了在每个隔离中获得单独的json，下面是一个示例

在本例中，我通过扫描@RestController动态创建SpringFox Docket Bean，并对每个控制器类进行分组。通过定义自定义注释并扫描它们，您可以有自己的分组策略。