4. OpenAPI Generator — Генерация кода по спецификации

Инструменты для кодогенерации

Swagger-codegen — это инструмент, который позволяет разработчикам автоматически генерировать клиентские SDK, серверные заглушки, документацию API и другие важные части кода непосредственно из спецификации OpenAPI. (продукт компании SmartBear — платный)

OpenAPI Generator — OpenSource проект

Спецификация из прошлого урока

Или из видео урока:

Страница с генераторами

Поскольку мы запускаем из Windows в Git Bush терминале, то скрипт запуска генератора должен быть таким:

here=/c:/dockerData
openapi_file=tools.yaml
language=java

docker run --rm -v $here:/local \
    openapitools/openapi-generator-cli \
    sh -c 'docker-entrypoint.sh generate -i /local/'$openapi_file' -g '$language' -o /local/output/'

Предварительно не забудьте запустить приложение Docker Desktop =)

Обратите внимание есть отдельный генератор для Spring, а так же других языков программирования

here=/c:/dockerData
openapi_file=tools.yaml
language=spring

docker run --rm -v $here:/local \
    openapitools/openapi-generator-cli \
    sh -c 'docker-entrypoint.sh generate -i /local/'$openapi_file' -g '$language' -o /local/output/'

После открытия проекта в Idea и запуска.
По ссылке — http://localhost:8080/swagger-ui/index.html

Будет:

GitHub

Источник

Примечание: В видео на Ютубе в генераторе кода присутствуют ошибки, в текущей реализации на 05.09.2024 таких ошибок нет, после генерации исправлять код не требуется!