Architecture Course Home / Архитектурные шаблоны / Шаблоны высшего порядка / Глубокое погружение в шаблоны высшего порядка

Clean Architecture

Описание

Подробнее всего чистая архитектура описана в книге Роберта Мартина «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 может.

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

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

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

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


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

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

Рейтинг атрибутов качества

Атрибуты качества

Рейтинг

Тип деления на модулиДоменный
Число квантов1
Deployability(star)
Elasticity(star)
Maintainability(star)(star)(star)(star)
Overall cost(star)(star)(star)
Performance(star)(star)
Reliability(star)(star)(star)
Scalability(star)
Simplicity(star)
Testability(star)(star)(star)

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

Оригинал на wiki