Я работаю над новым Java проектом, который включает веб-сервисы RESTful. Поскольку среда Swagger довольно популярна в настоящее время, я решил попробовать ее, но я не совсем уверен, какую версию выбрать.
После короткого исследования я обнаружил, что Swagger 1.5.x производит Swagger / OpenAPI 2.0. определения и Swagger 2.x производит определения OpenAPI 3.0. Однако мне не удалось найти более глубокую информацию о том, какая версия «лучше» или какая предпочтительнее и почему.
Мне кажется, что есть гораздо больше информации, статей, учебных пособий и т. Д. c. о Swagger 1.5.x, чем о 2.x. С другой стороны, 2.x новее и реализует более новую спецификацию OpenAPI.
Я не знаю, важно ли это, но приложение представляет собой «маленькую» (всего 50 классов) многоуровневую архитектуру. , бизнес логи c выставляется через веб сервисы. Я использую сервер приложений JBoss в сочетании с технологией RESTEasy.
Спасибо за любые объяснения.