🐸
OpenAPI - спецификация, устанавливающая способ описания REST API. Swagger - туллинг вокруг OpenAPI, генерирующий html-странички, позволяющие изучать REST API в интерактивной форме.
Существует 2 способа работы с OpenAPI:
- Создание OpenAPI на основе написанных спринговых контроллеров
- Генерация java-кода на основе написанного openapi.yml с последующей доработкой напильником. У многих есть опыт работы с OpenAPI по варианту 1. С вариантом 2 никто вживую не сталкивался (разве что Сергей, но это не точно).
Для работы по варианту 1 существует две библиотеки:
- Springfox - весьма популярная в прошлом библиотека. Перестала поддерживаться и не работает с новыми версиями Spring Boot.
- Springdoc - набирающая популярность библиотека
Для того чтобы представить свой REST API, как конфетку, существует несколько сервисов: