Настройка Swagger с помощью Play/Java-framework-2.5
Я пытаюсь настроить Swagger с моим проектом Play-2.5.
Я следовал этому уроку, и он работал, но только для старой версии Play и не работал с Play-2.5. Поскольку проект перешел на Play-2.5, нам пришлось убрать конфигурацию swagger.
Во-первых, проблема, казалось, была со статическим контроллером против не статического контроллера в Play-2.5, но я в итоге доказал, что ошибаюсь. Я сталкиваюсь с этой ошибкой
type ApiHelpController is not a member of package controllers
GET /api-docs controllers.ApiHelpController.getResources
Если кто-нибудь знает какую-либо ссылку для конфигурации Swagger с Play-2.5 для Java, пожалуйста, руководство.
PS: для Scala есть учебники, а не для Java.
3 ответа
Попробуйте это репо:
https://github.com/CreditCardsCom/swagger-play
Я создал это как временное решение, пока мы не получим поддержку Play 2.5 в официальном репозитории Swagger-Play.
Я использовал только проект Play-Swagger из Zalando. Существует много документации, и репо обновляется.
Если вы хотите быстрое начало, вы можете взглянуть на их шаблон активатора - просто запустите его, и вы получите документацию, сгенерированную Swagger (интерфейс Swagger уже включен). Оттуда вы можете начать настраивать его (ищите conf/echo.yaml файл).
Проблема в том, что com.wordnik swagger-play2(то, что ваше руководство использует в качестве библиотеки) ломается с Play 2.4 и выше. Вы можете попробовать это, который использует другой (io.swagger). Я использовал это, и он хорошо работает с 2.4. Но это также ломает с 2.5.