Как стать автором
Обновить
2
0

Пользователь

Отправить сообщение

Генерация контрактов OpenApi или прикладной API first: совсем немного про зачем

Уровень сложностиПростой
Время на прочтение3 мин
Количество просмотров3.7K

Новое место, новая позиция, новый продукт! Финтех, камунда, ~ 40 (!) микросервисов за которые отвечает наша команда. Первый спринт. Я в роли наблюдателя. В спринте вроде бы обычная задача - нужно вызвать из одного сервиса другой, и обработать результат. Ребята оценивают, начинают работу, и что я вижу в течение следующих дней: один разработчик берёт сервис-сервер, другой сервис-клиент, и каждый начинает реализацию контракта описанного в табличке в confluence. Что-от около десятка полей, если мне не изменяет память. Они уходят на пару дней, возвращаются, начинают тестирование контракта, выясняется что одно или два поля немного различаются в названии, уходят править нейминг, возвращаются, тестируют и только после этого переходят к написанию какой-то логики.

И тут меня понесло. Да, дело не конкретно в этих ребятах или задаче. Или продукте. Или компании. Они просто делают работу как привыкли делать. С точки зрения разработчика - закрыть такую задачу за 3 или 6 дней - нет особой разницы. Над сроками вообще начинаешь заморачиваться только после перехода в роль которая за эти самые сроки хоть как-то отвечает. Но потратить 4 дня силами двух разработчиков только на контрактую обвязку...

Здесь в памяти начали всплывать давние попытки генерации спецификаций по коду. Или документации по коду. Или кода из спецификации. В общем какие-то попытки генерации чего-то связанного с openapi. А дальше мы ушли в углубленное изучение того, как это можно использовать в контексте нашего продукта и большого количества взаимодействий сервисов.

Немного итогов
Всего голосов 6: ↑6 и ↓0+6
Комментарии11

Генерация контрактов OpenApi или прикладной API first: oneOf, anyOf, allOf

Уровень сложностиСредний
Время на прочтение10 мин
Количество просмотров8.5K


В продолжение истории с генерацией по спецификации OpenAPI покажу несколько примеров с использованием композиции и полиморфизма.

OneAllAnyOf
Всего голосов 3: ↑2 и ↓1+5
Комментарии2

Генерация контрактов OpenApi или прикладной API first: гайд по генерации в Spring Boot приложении

Уровень сложностиСредний
Время на прочтение7 мин
Количество просмотров13K

Стек: OpenAPI, Spring Boot, Gradle

Небольшой гайд по генерации серверной и клиентской части в Spring Boot приложении.

Краткое содержание:

Подготовьте репозиторий, в котором будут располагаться спецификации. Выделите отдельные директории для каждого сервиса и каждой версии спецификации внутри сервиса. Разделите спецификацию на удобные для работы части. Подготовьте техническую учётную запись с помощью который можно получить доступ к репозиторию.

В сервисе-сервере сгенерируйте сервер по спецификации. Настройте созданные контроллеры/имплементируйте интерфейсы.

В сервисе-клиенте сгенерируйте клиентскую часть по спецификации. Подключите сгенерированного feign клиента.

Generate it
Всего голосов 4: ↑3 и ↓1+4
Комментарии9

Информация

В рейтинге
Не участвует
Зарегистрирован
Активность

Специализация

Backend Developer
Lead
Docker
PostgreSQL
Java
Spring Boot
Java Spring Framework
Hibernate
Junit