避免 Swagger ui 显示双端点

Question

我有一个 yaml 文件来根据 OpenAPI 原则生成我的端点，但是当我打开我的 swagger-ui 时，我看到：

openapi: 3.0.2
info:
  ....
....
paths:
  /cities:
    get:
      tags:
        - Cities
      summary: Get all cities
      operationId: getAllCities
      responses:
        200:
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/City'
        404:
          description: Cities not found
          content: {}

swagger 配置如下所示：

@Configuration
@EnableSwagger2
public class Swagger2Config {

    public static final String REST_PACKAGE = "package";

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage(REST_PACKAGE))
                .paths(PathSelectors.any())
                .build();
    }
}

从 swagger ui 中删除 cities-api-controller 缺少什么？

Answer 1

public class Swagger2Config {

    public static final String REST_PACKAGE = "package";

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage(REST_PACKAGE))
                .paths(regex("/*.*"))
                .build();
    }

}