#java #swagger #openapi #swagger-2.0
Вопрос:
В настоящее время у нас есть база кода java с достаточным количеством конечных точек REST, которые были аннотированы аннотациями io.swagger 1.5. Мы хотели бы перейти на OpenAPI 3.0, поэтому я ищу инструмент, который обновит аннотации в нашем коде до аннотаций io.swagger 2.x. Существует ли такой инструмент?
Ответ №1:
Насколько мне известно, нет. Я знаю только об инструментах, которые могут переносить спецификации swagger yml или swagger json из версий 1.x в версии 2.x или даже из swagger в OpenAPI. Конвертер Swagger был бы одним из них.
Но миграция кода Java с аннотациями потребует много ручной работы.
Возможно, это руководство от Дэвида Меррика и некоторые инструкции по поиску и замене вашей любимой IDE могут сэкономить вам некоторое время.
Хорошей будущей инвестицией может быть рефакторинг всего кода, связанного с swagger, в спецификацию yaml и создание кода javacode на основе этой спецификации.
Таким образом, вы можете выполнить инструментальную миграцию файлов спецификаций и впоследствии сгенерировать Javacode.
Комментарии:
1. Спасибо за это предложение @Erunafailaro. Я попробую заменить его регулярное выражение. Я согласен с вами, что было бы неплохо иметь возможность генерировать код из документов, а не наоборот. Я могу попробовать использовать конвертер для переноса текущего документа Swagger в OpenAPI, а затем посмотреть, что выдает CodeGen, но, честно говоря, я довольно скептически отношусь к тому, что этот процесс даст удовлетворительный результат. Хотя я был бы рад, если бы мне доказали, что я ошибаюсь!