Swagger-UI 中的排序 API 方法

我找不到任何工作示例，如何实现以下目标： 我希望 Swagger-UI 中的 API 方法按方法 (GET-POST-PUT-DELETE) 或/和按字母顺序排序。

到目前为止，所有方法都以随机顺序显示，甚至不是按照我的源代码给出的顺序。

我使用 Jax-RS + Jersey 1。

使用 @ApiOperation 的位置属性进行排序对我来说不是一种选择，因为方法太多，而且 API 仍在扩展，所以如果有新的方法，我需要更新所有方法。

有什么提示吗？

Swagger UI 2.1.0+ 更新： The sorter参数已分为两个参数，如中所述Fix 1040 https://github.com/swagger-api/swagger-ui/issues/1040, Fix 1280 https://github.com/swagger-api/swagger-ui/pull/1280:

apis分类器

对 API/标签列表应用排序。它可以是“阿尔法” （按名称排序）或函数（请参阅 Array.prototype.sort() 了解如何 排序功能有效）。默认是服务器返回的顺序 不变。

操作分拣机

对每个API的操作列表进行排序。它可以是“alpha”（按路径字母数字排序）、“method”（按路径排序） HTTP 方法）或函数（请参阅 Array.prototype.sort() 了解如何 排序功能有效）。默认是服务器返回的顺序 不变。

所以你会想要更新sorter to apisSorter按字母顺序对 API 列表进行排序，和/或operationsSorter对每个API的操作列表进行排序。宠物店demo已经更新为apisSorter，如下图：

Example https://github.com/swagger-api/swagger-ui/blob/master/src/main/html/index.html: (工作演示 http://petstore.swagger.io/，按字母顺序排列）

window.swaggerUi = new SwaggerUi({

...

apisSorter : "alpha"
});

对于 2.1.0 之前的 Swagger UI 版本:

The sorter参数仍然与旧版本的 Swagger UI 相关：

您可以使用sorter实例化 SwaggerUi 时的参数。这发生在 Swagger-Ui index.html 的 javascript 中。来自文档 https://github.com/wordnik/swagger-ui#swaggerui:

排序器对 API 列表进行排序。有可能 'alpha'（对路径进行排序 字母数字）或 'method'（按 HTTP 方法对操作进行排序）。 默认是服务器返回的顺序不变。

Example https://github.com/swagger-api/swagger-ui/blob/97ed093e6ec3a7a778ac6a41d76775c88b1fc951/src/main/html/index.html:

window.swaggerUi = new SwaggerUi({

...

sorter : "alpha"
});