Пробовали как раз Апикур да swagger-editor. Но к сожалению из-за разных сред работы (разработчики и тестировщики, инхаус и аутстафф, корпоративная техника и терминалу), из общего у нас осталась только IDEA, в которой из коробки идёт OpenAPI плагин, здорово помогающий с рендерингом спецификации. То есть даже не нужно ничего запускать, просто открываешь в Идее файл и он тут же отрисован в swagger ui. А пишем руками...
Страдаем от того как написаны некоторые наши кор системы (
И экспериментируем с их апи чтобы хоть что-то рабочее сгенерировалось. В контексте нашего продукта - все полтора десятка интеграций спрятаны за сервисами-адаптерами или гейтвеями. И вот апи этих адаптеров мы пишем сами, а там даже если когда-нибудь не сможем написать спецификацию другой системы - ну, будет написано руками. Но хоть в одном месте
Добавил в статью пример, вот здесь можно посмотреть как подключить контроллер. В статье и примере в контекст подключаются бины только feign клиентов. Подключать сгенерированный контроллер в контекст не имеет смысла потому что там мы не можем ничего написать.
OneOf, AnyOf, AllOf - поддерживаются, генерируются. Основная сложность - это понять предлагаемую концепцию и правильно написать спецификацию. Если мы работает с event стилем моделей (когда в один эндпоинт приходит много моделей, которые различаются полями и идентифицируются по какому-нибудь eventType полю) - то только так и можно работать. Сделаю отдельную статью с примерами
Пробовали как раз Апикур да swagger-editor. Но к сожалению из-за разных сред работы (разработчики и тестировщики, инхаус и аутстафф, корпоративная техника и терминалу), из общего у нас осталась только IDEA, в которой из коробки идёт OpenAPI плагин, здорово помогающий с рендерингом спецификации. То есть даже не нужно ничего запускать, просто открываешь в Идее файл и он тут же отрисован в swagger ui. А пишем руками...
Страдаем от того как написаны некоторые наши кор системы (
И экспериментируем с их апи чтобы хоть что-то рабочее сгенерировалось. В контексте нашего продукта - все полтора десятка интеграций спрятаны за сервисами-адаптерами или гейтвеями. И вот апи этих адаптеров мы пишем сами, а там даже если когда-нибудь не сможем написать спецификацию другой системы - ну, будет написано руками. Но хоть в одном месте
Мы вот тоже всё склоняем нашего фронтенд разработчика попробовать
Подготовил небольшой пример: https://habr.com/ru/articles/774928/
Добавил в статью пример, вот здесь можно посмотреть как подключить контроллер.
В статье и примере в контекст подключаются бины только feign клиентов.
Подключать сгенерированный контроллер в контекст не имеет смысла потому что там мы не можем ничего написать.
OneOf, AnyOf, AllOf - поддерживаются, генерируются. Основная сложность - это понять предлагаемую концепцию и правильно написать спецификацию.
Если мы работает с event стилем моделей (когда в один эндпоинт приходит много моделей, которые различаются полями и идентифицируются по какому-нибудь eventType полю) - то только так и можно работать.
Сделаю отдельную статью с примерами
Спасибо! Переработал и приложил работающее демо