在Swagger中更改API显示顺序(使用Spring)

时间:2018-09-10 09:12:48

标签: java spring spring-boot swagger-ui

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

enter image description here

我需要先显示welcome,然后再显示hello控制器方法。

下面是我的代码。 enter image description here

2 个答案:

答案 0 :(得分:0)

@ApiOperation批注中,您可以设置属性position来更改顺序。请注意,该属性已弃用,但仍然可以使用。

答案 1 :(得分:0)

您可以阅读here的spring-fox核心开发人员指出这个问题非常清楚:

  

请明确一点,我们有一个内部模型,该模型完全可以像   预期和功能。 api描述和api操作将   从springfox的角度进行排序。我们只用   摇摇欲坠的模型作为DTO来处理内部序列化   服务模式。一旦固定了DTO即可保留订购顺序   问题将会消失。

     

我们当然可以添加注释以描述问题和原因   自述文件。除了等待昂首阔步的核心解决此问题外,还有   除了担心之外,这里无事可做。

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