我找不到任何有用的例子,如何实现以下内容:我希望我的Swagger-UI中的API方法按方法(GET-POST-PUT-DELETE)或/按字母顺序排序.
到目前为止,所有方法都以随机顺序显示,甚至不按给定源代码的顺序显示.
我使用Jax-RS + Jersey 1.
使用@ApiOperation的position属性进行排序对我来说不是一个选项,因为有太多的方法而且API仍在扩展,所以如果有一个新的,我需要更新所有.
任何提示?
我正在使用 Docket 来配置我的 Swagger 2 实例。但我目前看到的唯一选项是按类型(POST、GET 等)或端点名称 (az) 排序。
我的端点有一个逻辑顺序,我想按该顺序显示它们
POST /start
POST /uplaod
POST /finalize
POST /checkStatus
Run Code Online (Sandbox Code Playgroud)
POST /checkStatus
POST /finalize
POST /start
POST /upload
Run Code Online (Sandbox Code Playgroud)
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.host(swaggerHost)
.pathProvider(new RelativePathProvider(servletContext) {
@Override
public String getApplicationBasePath() {
return swaggerBasePath;
}
})
.select()
.apis(RequestHandlerSelectors.withClassAnnotation(Api.class))
.build()
.apiInfo(apiInfo())
.securitySchemes(Collections.singletonList(securitySchema()))
.securityContexts(Collections.singletonList(securityContext()));
}
Run Code Online (Sandbox Code Playgroud) 我希望标@ApiOperation有的控制器端点在Swagger规范中按特定顺序排列。试图设置position上@ApiOperation是这样的:
@ApiOperation(value = "xxx", position = 1)
似乎对结果没有影响。有什么建议么?