Как включить swagger iu в Quarkus с реактивными маршрутами?

Question

Я использую Quarkus для создания проекта, и я решил использовать Реактивные маршруты .

Я хотел бы добавить в свой проект информацию OpenAPI и пользовательский интерфейс Swagger. Кажется, что это возможно с использованием RestEasy , но я не нашел информации о том же с реактивными маршрутами.

Возможно ли это? Я попытался включить его, но не смог.

Answer 1

На самом деле это невозможно.

Подход RESTeasy основан на сочетании отражения и аннотаций, чтобы определить, что такое интерфейс REST. При использовании веб-маршрутов Vert.x вы получаете большую гибкость, чем тот уровень информации, который недоступен стандартным способом.

Есть несколько альтернатив:

• Напишите Определение OpenAPI заранее и используйте его для генерации маршрутов (https://how-to.vertx.io/web-and-openapi-howto/)
• Найдите (или напишите) генератор, который ограничивает ваш код Vert.x, чтобы он мог определять контракт динамически (https://jitpack.io/p/ckaratzas/vertx-openapi-spec-generator является примером, он может быть не единственным).

Лично я использую RESTeasy, если мне нужно сгенерировать документы OpenApi.