Пожалуйста!

Супер, что было полезно)

Отличная новость. Спасибо! Попробую снова)

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

Здравствуйте, на мой взгляд, лучше посоветую вам посмотреть моё последнее видео на эту тему kzfaq.info/get/bejne/equUiaqW2seYaWw.html . Там уже учтены изменения, внесённые за год, большая часть дефектов в библиотеке, о которых тут была речь в видео, поправлена. Плюс там есть ссылка на гитхаб. Надеюсь, это поможет вам.

Добрый день! Предположим, что с одной стороны у нас есть openapi спецификация, а с другой сервис, который ей соответствует, он доступен по http, а вот доступа к исходникам нет. Тогда мы можем либо у себя локально (Swagger Editor, Swagger UI, Insomnia) открыть спецификацию и пользоваться "Try it out", кнопка будет доступна. Либо ещё вариант Insomnia умеет сгенерировать коллекцию Http запросов, которая соответствует спецификации. Ключевое, что сервис точно соответствует этой спецификации, а иметь доступ в код совсем необязательно. PS. У меня в ближайших планах сделать видео про dredd, как раз один из способов тестирования на соответствие сервиса спецификации.

@@IT_like_bricks_building Благодарю за ответ!

Можно посмотреть на x-class-extra-annotation. Ссылки для примера stackoverflow.com/a/71526062/14750092 и github.com/OpenAPITools/openapi-generator/issues/324

@@IT_like_bricks_building Спасибо, попробую и так

@@IT_like_bricks_building добрый день а где это все в доках находить, не получается хорошо читать доки(

Честно говоря в данном случае не подскажу, так как этот атрибут был добавлен кем-то самостоятельно через merge request, соответственно в официальную документацию openapi мог не попасть. Хотя в документе про openapi generator есть его упоминание openapi-generator.tech/docs/generators/spring/

Если вы говорите именно про работу с Swagger Editor, то я не подскажу, я им не пользуюсь. Только для кратких демонстраций. Расскажу про наш опыт. Есть много редакторов openapi схем, внутри продуктов jetbrains, insomnia и тд. Соответственно это становится частью кодовой базы компании, выкладывает в гит. Публикация схемы = 1. ссылка на поднятый swagger-ui конкретного модуля с openapi схемой (url:port/swagger-ui/index.html). 2. ссылка в гит на спецификацию. 3. просто файл переслать со спецификацией. Мы создаем спецификации внутри intellij idea, для целей внешних интеграций даем ссылку на swagger-ui (п1 выше).

Hello, this one: kzfaq.info/get/bejne/nraqotWg0JPLeWg.html

Чуть ранее кто-то из подписчиков писал, что эти дефекты уже пофиксили. Так что должно быть норм. Лично мы в проекте без допиливания прекрасно нынче используем. Последнее видео по генерации кода у меня на канале как раз про наш текущий (+/-) подход.

@@IT_like_bricks_building прежде всего кстате спасибо за видосы, а то я набросился как-то внезапно. ну а вообще когда компилируешь шаблон, то компилятор должен либо давать ошибку и не компилировать, либо компилировать в полном соответствии с шаблоном. представь, компилируешь js через babel и всё проходит без ошибок, но потом оказываеться что функция helloWorld() была просто тупо выпилена из кода. это ж просто нонсенс.

Плюсую)) мы сейчас сделали хитро, мы на ci/cd сделали таск по валидации openapi схемы, чтобы как раз не вышло описанной ситуации. В целом отлавливали пару раз косяки

Простите, запоздал с ответом, можно сделать. В последних версиях генератора кусок спецификации ниже корректно работает. content: application/json: schema: type: array items: $ref: "#/components/schemas/Toy"