Тестирование и валидация REST-сервисов - Spring и Swagger

При разработке ПО хорошей практикой является описание некоторого контракта, на который будут опираться все компоненты системы при взаимодействии друг с другом.
Для SOAP у вас есть WSDL, а вот для REST-сервисов такого однозначного способа описания контрактов изначально нет. Какое-то время я для этого использовал связку из Spring RestDocs и Spring Cloud Contract, но со временем и возросшей популярностью Swagger переключился на описание REST-сервисов в формате OpenAPI.
В этом ролике я постараюсь наглядно продемонстрировать способ валидации REST-сервисов на Spring при помощи Swagger во время выполнения интеграционных тестов.
Репозиторий проекта: github.com/ale...
#java #spring #swagger #openapi #rest
Мой сайт: alexkosarev.name/
Паблик в VK: public2...
Канал в Telegram: t.me/+TZCuO38v...
Стать доном: donut/s...
Донаты в Boosty: boosty.to/akos...
Донаты в Tinkoff: www.tinkoff.ru...

[@АлександрМышляев-щ5и]

спасибо что делаешь такой качественный контент

[@linaschwarzer507]

Спасибо! Как всегда в тему! Прям уже даже кажется что мысли читаешь. :))

[@bryanin]

Отличное видео! Я бы хотел предложить в качестве идеи к новым видео запроектировать архитектуру какого-нибудь приложения

[@krab9512]

Спасибо за видео! Планируется ли тема про брокеры сообщений, в частности про Kafka?

[@shurik_codes]

Когда-нибудь)

[@romanovichihin2429]

лайк, коммент, некст!

[@АлександрБугримов-о1е]

Очень круто. Спасибо. А есть опыт в генерации кода на основании openapi спецификации? Мне кажется эта штука не совсем удобной, но... может есть какие-то плюсы этого)

[@shurik_codes]

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

[@dmitrelkin9256]

Спасибо! Очень интересно и полезно - сейчас как раз пытаюсь писать интеграционные тесты - эти уроки очень помогают.

[@chesseranapa]

Спасибо большое. Благодаря таким видео, кругозор повышается. Копнул чуть вглубь, openApi, в get, конечно, тоже позволяет добавлять заголовки в запросе. Только делается это через параметры с указанием места их расположения. Потому в помощнике кода и не отображалось.

[@АлександрБугримов-о1е]

Подскажи, а как можно было бы имеющуюся swagger спецификацию (yaml или json файл) рендерить в виде html? Ну что-то вроде поднимается сервис, заходишь по определенному углу и получаешь спецификацию для например тестирования?

[@shurik_codes]

Не задумывался над таким вариантом использования. Обычно у меня работа с UI OpenAPI-контракта происходит либо в IDE, либо в GitLab. Последний пытается рендерить файлы opeapi.json или openapi.yml при просмотре их в браузере. Как показала практика, этого вполне достаточно. Для ручного тестирования нужно только прописать тестовый сервер в списке серверов. Но вообще могу предположить такой вариант: при сборке проекта файл со спецификацией рендерить при помощи какой-нибудь утилиты (например, redoc-cli из NPM) и полученный файл складывать в директорию со статическим содержимым, если хочется, чтобы UI был доступен в сервисе. Вполне возможно, что Springfox может делать что-то подобное.

[@timlins]

молодец. Человеку важно реализовывать себя и если есть что рассказать и показать что то важное - делай )

[@Алексейм-с7б]

герман, выйди в о к н о

[@stainlesssteel95]

Да + оставь парня в покое@@Алексейм-с7б