Есть ли какойто подход к программированию называемый Api First?

Question

[ZakkMalin]

Существует ли уже какойто подход к программированию, когда архитектура вся выстраивается вокруг заранее составленного API?

Comments

[amimotogo]

когда архитектура вся выстраивается вокруг заранее составленного API?

Термин "архитектура приложения" здесь не уместен.
Разве что "логика приложения".

Answer 1

[kafkiansky]

Тут даже придумывать ничего не надо, так половина приложений создается.

Comments

[ZakkMalin]

Какие минусы от такого подхода?

[kafkiansky]

ZakkMalin, причем здесь минусы? Это просто подход. Как и у любого подхода, у него могут быть минусы в способе приготовления, но не перед другими подходами. Все зависит от ваших способностей.

[ZakkMalin]

kafkiansky,

Все зависит от ваших способностей.

При чём тут мои или чьито способности, у любого подхода есть какието свои минусы, если не знаете, то просто ответьте что: "Не знаю.", никто обижаться на вас не будет, но зачем переходить в атаку?

[kafkiansky]

ZakkMalin, я не переходил в атаку. Ваш вопрос странный, следующие вопросы в комментарии еще более странные.

При чём тут мои или чьито способности

Как раз-таки ваши способности играют здесь не последнюю роль и могут превратить подход или в нормальный способ построить приложение, или в самый неудачный. Все зависит от ситуации: есть готовое апи, делаете вокруг него приложение, нет - пишете и делаете вокруг него приложение. Этот подход даже не параллелен какому-то другому, он просто предназначен для других задач.

[ZakkMalin]

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

[Иван Шумов]

ZakkMalin, это принципиально другой подход и он не может быть лучше или хуже. Это принципиально другая архитектура

[amimotogo]

ZakkMalin,

Какие минусы от такого подхода?

Нельзя учесть всего заранее, просто абстрактно создавая API.

Буквально на позапрошлой неделе серьезно перепиливал созданное таким образом "API first".
При реальной работе оказалось, что так делать API нельзя.

Но до создания ПО, использующего ПО - это было не очевидно.

[ZakkMalin]

Иван Шумов @amimotogo

это принципиально другой подход и он не может быть лучше или хуже. Это принципиально другая архитектура

Но до создания ПО, использующего ПО - это было не очевидно.

Мне показалось что API First как и сервис-ориентированная архитектура потенциально не зависит от каких либо технологий...

[Иван Шумов]

ZakkMalin, SOA не обязательно вообще должна иметь API. Удивительно, да?)

[Иван Шумов]

ZakkMalin, не то чтобы совсем не зависит от технологий, но протоколов общения, как и типов клиентов (смартфон, браузер, iot, ...), не так и много, поэтому все зависит скорее от способа взаимодействия между системами

[ZakkMalin]

Иван Шумов,

SOA не обязательно вообще должна иметь API. Удивительно, да?)

А API базируется на какомто стеке?

[Иван Шумов]

ZakkMalin, не на стеке, а на типовых протоколах и форматах обмена данными

[amimotogo]

ZakkMalin,

Мне показалось что API First как и сервис-ориентированная архитектура потенциально не зависит от каких либо технологий...

Ну я тоже так когда-то думал.

Иван Шумов,

SOA не обязательно вообще должна иметь API. Удивительно, да?)

Снова этот ребенок....

Обязана.
API - это совсем не обязательно красивый/модный/молодежный протокол. А всего-навсего банальная договоренность о способе взаимодействия, любым способом, всего-навсего публичный интерфейс для доступа к сервисам. А уж что это будет - дело десятое.

[Иван Шумов]

amimotogo, это мы понимаем, но в данном контексте человек имеет вполне определенное понимание.

PS. Да и людей за 30 называть детьми как-то должно быть, ну, как минимум неуважительно что ли

Answer 2

[Zanak]

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