Изменить порядок отображения api в swagger (используя spring)

Я пытаюсь изменить порядок отображения методов на странице swagger-ui, используя java.

enter image description here

Мне нужно показать сначала метод контроллера welcome, затем метод контроллера hello.

Ниже мой код. enter image description here

Вы уже читали github.com/springfox/springfox/issues/732?

mrkernelpanic 10.09.2018 11:41
7
1
6 218
2

Ответы 2

В аннотации @ApiOperation у вас есть атрибут position, который вы можете установить, чтобы изменить порядок. Обратите внимание, что атрибут устарел, но все еще работает.

Я смотрю на ваш код: контроллер должен быть аннотирован @Api, а не @ApiModel

akuma8 10.09.2018 13:35

Я также пробовал использовать обе аннотации, но не работал, получая тот же результат.

user6808875 10.09.2018 14:11

Как вы можете прочитать в здесь, основной разработчик spring-fox очень четко заявляет о проблеме:

Just to be clear, we have an internal model that totally works as expected and functional. The api descriptions and api operations will be sorted as expected from springfox's standpoint. We're only using the swagger models as DTOs to handle the serialization of our internal service models. Once the DTO's are fixed to preserve the ordering this problem will go away.

We can certainly add a note to describe the problem and the cause to the Readme. Other than waiting for swagger core to fix this, there is nothing to do here other than that I'm afraid.

Поэтому, если Open API не исправит / не улучшит свои модели, он не будет работать для spring-fox.

Другие вопросы по теме