github swagger-samples - не найден файл swagger.json - PullRequest
Новая
       8

github swagger-samples - не найден файл swagger.json

0 голосов
/ 20 ноября 2018

Я разместил следующий вопрос в группах Google Swagger , но не получил там ответа.

==========================================================

Генерируют образцы чванстваswagger.json?

Я предполагаю, что целью примеров программ swagger-samples является предоставление небольших реализаций REST, в которых генерируется файл swagger.json, и вы можете просмотреть это с помощью SwaggerUI.программа.Если нет, пожалуйста, скажите мне, потому что я пытаюсь узнать, как аннотировать мое приложение на основе JAX-RS и генерировать спецификацию OpenAPI, чтобы ее можно было просмотреть в SwaggerUI.

Я запустил два примера: java-jersey2 и java-jersey-jaxrs.

И компилируются, и работают нормально (с Java 8).Я использую задокументированную команду:

mvn package -Dlog4j.configuration = file: ./ conf / log4j.properties jetty: run

Я открываю свой браузер для http://localhost:8002и увидеть диалоговое окно (см. прикрепленный файл) и все.Я не уверен, куда идти оттуда.

Я пробовал вводить разные значения в поля ввода, но ссылка "Исследовать" ничего не делает, только обновляет страницу.Я изучил JavaScript на странице, чтобы узнать это.

Отдельно я узнал, как работает SwaggerUI.Я также вручную создал файл swagger.json для одной из остальных конечных точек и подтвердил, что он работает с помощью SwaggerUI, но (пока) не выяснил, как получить файл спецификации OpenAPI (он же swagger.json), созданный из аннотаций,Итак, я разбираюсь в деталях.

Итак, два вопроса:

  1. Эти примеры генерируют файл Swagger.json?Если это так, где это (я искал и не нашел его).

  2. Если нет, каковы дальнейшие шаги для создания этого файла swagger.json, чтобы я мог указать на негов экземпляре SwaggerUI я работаю.

====================================================

Я вижу, что я не одинок в своем стремлении создать файл swagger.json, используярешения с открытым исходным кодом.Вот некоторые другие вопросы и ресурсы, которые я использовал:

  • Swagger и swagger.json location - задает аналогичный вопрос.

  • Swagger не генерирует swagger.json

  • Начало работы с Swagger - Где я начал изучать swagger.

  • Swagger Core Jersey 2.X Project Setup - Это то, что я изначально пытался заставить работать.Это все еще может быть лучшим способом (для того, что я пытаюсь сделать). ПРИМЕЧАНИЕ. В моем случае я пытаюсь заставить Джерси-2 работать со сваггером, используя плагин swagger-maven-plugin, но мой вопрос на самом деле о сэмплах, и они должны работать так, как я объяснил.

...