Нужно изменить имя отображения GET на Swagger UI - PullRequest
0 голосов
/ 26 марта 2020

Я работаю с Java Spring Boot Application.

Мой текущий метод GET в RestController ниже.

GetMapping на RestController

После запуска мой swagger выглядит следующим образом:

Swgger UI

Есть ли способ, я все еще могу использовать "/ v1 / person" в контроллере, но на swagger я только хочу отобразить "/person".

Я не хочу" / v1 / person "на swagger

1 Ответ

0 голосов
/ 26 марта 2020

Во-первых, это невозможно сделать.

Я думаю, что вы смотрите на это совершенно неправильно. Swagger предназначен для того, чтобы быть похожим на контракт, который вы выставляете клиенту (который когда-либо вызывает ваш API). Это должно содержать подробности о том, что такое конечная точка, как клиент может вызвать вашу конечную точку, с какими аргументами и что клиент может ожидать взамен.

Если вы используете / v1 / person в вашем контроллере, это означает, что он может быть вызван только с URL http://......./v1/person.

Теперь, если вы (каким-то образом) отобразите /person в Swagger, клиент не сможет вызвать вашу конечную точку, и базовая идея Swagger будет уничтожена.

Надеюсь, что все ясно.

...