Architecture Course Home / Дополнительные материалы / Каталог архитектурных шаблонов / Каталог. Сырой список

Clean

Описание

Clean Architecture (Чистая архитектура) — это архитектурный подход, предложенный Робертом С. Мартином (известным как Uncle Bob), направленный на создание программного обеспечения, которое легко тестируется, расширяется и сопровождается. Основной принцип Clean Architecture заключается в строгом разделении слоев системы, каждый из которых отвечает за определенные аспекты и не зависит от деталей реализации других слоев.

Позитивные драйверыMaintainability, Simplicity, Testability
Негативные драйверыReliability, Deployability, Scalability, Elasticity, Performance

Преимущества

  • Инфрастуктура не влияет на бизнес логику, в layered может
  • Компоненты взаимодействуют через абстракции (интерфейсы), что обеспечивает высокую гибкость
  • Легче тестировать

Недостатки

  • Более высокий порог входа для разработчиков
  • Нужно писать больше кода (делать несколько шагов для передачи данных между слоями)
Полезные ссылки

Пример реализации:

Описание

Подробнее всего чистая архитектура описана в книге Роберта Мартина «Clean Architecture» Сама архитектура расписана размыто, в ней мало конкретики и нет примера реализации, есть только набор принципов. Но несмотря на это можно выделить ряд основных моментов:


Чистая архитектура способствует созданию систем:

Автор выделяет следующий набор слоев:

На практике еще можно добавить слой InfraStucture, domain services для анемичных моделей, Handlers в Use Case .

В свою очередь InfraStucture может делиться на отдельный компонент для интерфейса и реализации каждого адаптера типа базы, брокера, стороннего сервиса и т.д. первичные адаптеры тоже могут делиться на http-контроллеры, консюмеры, grpc-сервисы и бэкграунд-джобы.


Слоев может быть и больше, главное чтобы соблюдалось правило зависимостей.

Внешний круг должен зависеть только от внутренних.

Схематично это можно отобразить на картинке:

Реализация этого достигается посредством DIP.

Dipendency Inversion Principle (DIP)

Основной принцип используемый в чистой архитектуре.

Формулировка на русском языке:

Суть принципа в том, что весь код разделяется на N слоев, аналогично Layered Architecture, но модули верхних уровней не могут зависеть от нижних напрямую.

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

При ситуации наоборот, нижним нужен верхний, то они могут его импортировать напрямую.

Рассмотрим пример:

Допустим у нас будет два слоя - core, data access.

Если core нужна зависимость от data access, то:

1) В core создаем абстракцию

2) Данная абстракция не должна зависеть от  data access, только от core в идеале также не зависеть от фреймворка.

3) Импортируем и реализуем данную абстракцию в data access

4) Передаем в core инстанс data access с реализацией данной абстракции используя инъекцию зависимостей (Dependency injection, DI)

В обратном сценарии, когда data access нужно зависеть от core, то data access может импортировать core напрямую, без использования каких-либо абстракций.


Практика применения чистой архитектуры:

Слой Entities:

Сюда входят сервисы и anemic/reach models.

Пример структуры папок для Rich model:

Пример структуры папок для Anemic model:

Добавляются интерфейсы domain services и их  реализации

Слой Use Cases:

Рекомендуется на каждую роль выделять свой Use Case.

В слой входит:

Слой Controllers:

В слой входит:

Слой Frameworks:

Сюда входят:


Слой Infrastucture:

Также можно добавить набор инструментов для работы с инфраструктурой.

Infrastucture нужно разделить на интерфейсы и реализации.

Интерфейсы кладем рядом с Use Case, т.к. явно он нигде не указан.

Что кладем в Infrastructure.Interfaces:

Реализацию можно положить в слой Framework.

При этом порядок импортов интерфейсов инфраструктуры может быть между Entities и UseCases, а реализация самой последней.


Слой Utils:

Можно добавить слой утилит, к которому могут ссылаться все слои.

Главное чтобы в нем не было логики из других слоев. 


В итоге порядок импортов слоев будет следующий:

Слой Tests:

Тесты можно вынести в отдельный слой.


Резюмируя можно предложить такой пример реализации:


Реализация чистой архитектуры с поддержанием DIP и разбиением кода на слои помогает достичь следующих результатов:

  1. Независимость от фреймворка. Архитектура не зависит от существования какой-либо библиотеки. Это позволяет использовать фреймворк в качестве инструмента, вместо того, чтобы втискивать свою систему в рамки его ограничений.
  2. Тестируемость. Бизнес-правила могут быть протестированы без пользовательского интерфейса, базы данных, веб-сервера или любого другого внешнего компонента.
  3. Независимоcть от UI. Пользовательский интерфейс можно легко изменить, не изменяя остальную систему. Например, веб-интерфейс может быть заменен на консольный, без изменения бизнес-правил.
  4. Независимоcть от базы данных. Вы можете поменять Oracle или SQL Server на MongoDB, BigTable, CouchDB или что-то еще. Ваши бизнес-правила не связаны с базой данных.
  5. Независимость от какого-либо внешнего сервиса. По факту ваши бизнес правила просто ничего не знают о внешнем мире.

Trade-Offs (в сравнении с layered)

Преимущества

Недостатки

Инфрастуктура не влияет на бизнес логику, в layered может.

Более высокий порог входа для разработчиков

Компоненты взаимодействуют через абстракции (интерфейсы), что обеспечивает высокую гибкость.

Нужно писать больше кода (делать несколько шагов для передачи данных между слоями)

Легче тестировать


Когда использовать

В средних и больших проектах:

Описание

Хотя Layered архитектура дает множество преимуществ для разработки программного обеспечения, есть и некоторые потенциальные недостатки, которые следует учитывать. Реализация вертикальной бизнес-логики как правило затрагивает все слои, что плохо укладывается в принципы правильной модульности.

Vertical Slices архитектура направлена ​​на организацию кода вокруг ограниченного контекста, а не на технические проблемы. В отличии от чистой архитектуры, для которой применяются закрытые и открытые слои со строгим разграничением ответственности, vertical slices архитектура по сути делает все горизонтальные слои открытыми. Из любого слоя мы можем вызвать любой слой без ограничения.

В vertical slices архитектуре бизнес функция реализуется на всех уровнях программного обеспечения, от пользовательского интерфейса до базы данных.

Идея vertical slices архитектуры заключается в том, что, вместо создания отдельных слоев кода для каждого технического проблем (таких как пользовательский интерфейс, доступ к данным и бизнес-логика), код организован вокруг конкретной бизнес функции. Это означает, что весь код, связанный с этой функцией, содержится в одном месте, что упрощает понимание, тестирование и изменение.

Trade-Offs

ПреимуществаНедостатки

Благодаря архитектуре вертикального среза мы уменьшаем связь между функциями. Мы можем сосредоточиться на одном фрагменте при реализации функции, а не на разных уровнях, тем самым улучшая удобство обслуживания.

Архитектура вертикальных слоёв склонна к повышенной энтропии

Каждый срез независим и взаимодействует с внешними ресурсами. Мы можем иметь разные срезы, используя разные способы сохранения данных, не мешая друг другу.


Когда использовать

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





Оригинал на wiki