在 Swagger 中更改 API 显示顺序（使用 Spring）

Question

我正在尝试swagger-ui使用 java更改页面中显示的方法顺序。我需要先展示welcome稍后的hello控制器方法。下面是我的代码。 

Answer 1

在@ApiOperation注释中position，您可以设置一个属性来更改顺序。请注意，该属性已被弃用，但仍然有效。

Answer 2

正如您在此处阅读的那样，spring-fox 的核心开发人员非常清楚地说明了问题：

需要明确的是，我们有一个完全按预期工作且功能正常的内部模型。从 springfox 的角度来看，api 描述和 api 操作将按预期排序。我们只使用 swagger 模型作为 DTO 来处理我们内部服务模型的序列化。一旦 DTO 被修复以保持顺序，这个问题就会消失。

我们当然可以在自述文件中添加注释来描述问题和原因。除了等待 swagger 核心来解决这个问题外，我担心除此之外别无他法。

因此，除非 Open API 将修复/增强他们的模型，否则它不适用于 spring-fox。