OpenAPI – генерировать серверный код для меняющегося API? ⇐ JAVA

[Anonymous]

Я поддерживаю приложение Java, в которое мы постоянно добавляем новые функции (изменения в API). Я хочу перейти к использованию OpenAPI как способа документирования API. Я вижу две школы мысли:

• Напишите код, используйте аннотации для создания спецификации OpenAPI.
• Напишите OpenAPI, используйте его для генерации серверного кода.

Хотя оба кажутся прекрасными и модными, серверный код просто отключен, и тогда потребуется много ручного подключения служб. Хотя это кажется приемлемым единовременным затратом, но в следующий раз, когда я обновлю интерфейс, мне кажется, что есть только два варианта:


[*]Создать их все снова, заново выполните все подключения вручную.
[*]Вручную отредактируйте ранее созданные классы, чтобы они соответствовали новому файлу спецификации (потенциально могут возникнуть ошибки).
< /ol>

Правильна ли я с этими вариантами? Если это так, то, похоже, использование кода для создания файла спецификации API — действительно единственный разумный выбор.

Подробнее здесь: https://stackoverflow.com/questions/549 ... anging-api