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

Question

我正在尝试使用java更改swagger-ui页面中显示的方法顺序。

我需要先显示welcome后来的hello控制器方法。

以下是我的代码。

Answer 1

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

Answer 2

正如你可以阅读here一样，spring-fox的核心开发人员说明问题非常明确：

为了清楚起见，我们有一个完全符合预期和功能的内部模型。从springfox的角度来看，api描述和api操作将按预期排序。我们只使用swagger模型作为DTO来处理内部服务模型的序列化。一旦DTO被修复以保持订购，这个问题就会消失。

我们当然可以添加一个注释来描述问题以及自述文件的原因。除了等待摇摇欲坠的核心来解决这个问题之外，除了我害怕之外，这里没有什么可做的。

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