Всем привет! Подскажите, на сколько в целом считается хорошей практикой

Question

Всем привет! Подскажите, на сколько в целом считается хорошей практикой

поднимать swagger вместе с сервером, написанным на spring’е? Меня смутило большая колбаса аннотаций перед методами для описания.

Или же лучше отдельно описывать в json’е?

#backend #java #programming #russian

0

09.04.2022

6 ответов

17 просмотров

Vyacheslav Yashunin Автор вопроса

Alexander Komarov
> spring > большая колбаса аннотаций перед методам...

С учетом текущего кол-ва, появляется еще больше😅

0

09.04.2022

Ilya Kuznetsov

Если у вас подход contract first (и у него в целом много плюсов), то можно сначала описать openapi definition, а затем воспользоваться кодогенерацией Если же просто хотите документировать свое API, но никоиу раньше времени с ним особо интегрироваться не надо - да, пользуются аннотациями

0

09.04.2022

Vyacheslav Yashunin Автор вопроса

Ilya Kuznetsov
Если у вас подход contract first (и у него в целом...

Спасибо! Подскажи, а есть какие-либо годные статьи про подход contract-first? Хотелось бы по подробнее почитать) В моем случае, интеграций особо не будет)

0

09.04.2022

Ilya Kuznetsov

Vyacheslav Yashunin
Спасибо! Подскажи, а есть какие-либо годные статьи...

https://habr.com/ru/company/yoomoney/blog/647441/

0

09.04.2022

Vyacheslav Yashunin Автор вопроса

Ilya Kuznetsov
https://habr.com/ru/company/yoomoney/blog/647441/

Благодарю!

0

09.04.2022