Оффлайн-документация с использованием плагина maven
Я пытаюсь создать документацию swagger, для этого мне нужно запустить сервер. Я хочу генерировать документацию swagger в автономном режиме (без запуска сервера), я только что получил эту ссылку https://github.com/garethjevans/swagger-codegen-maven-plugin
Но когда я добавил вышеуказанный плагин в POM.xml (предположим, для генерации HTML-документа во время сборки Maven, я чувствую), он вообще ничего не делает. Пожалуйста помоги.
2 ответа
Взгляните на этот плагин: https://github.com/teamcarma/swagger-jaxrs-doclet
Поскольку список ресурсов JSON генерируется в автономном режиме из исходного кода, это означает, что вам не нужно добавлять какие-либо зависимости времени выполнения в ваш проект и избегать потенциальных проблем с различными версиями jar и реализациями jaxrs. Это также позволяет избежать увеличения размера ваших артефактов.
Чтобы сгенерировать документацию HTML, вам нужно установить значение языкового тега в конфигурации на HTML. В примере по вашей ссылке он установлен на java, Измените это на html, Если вам нужно сгенерировать как Java, так и HTML, имейте два execution блоки, один для Java, один для HTML.