Facade: простой интерфейс для сложной системы
Facade: простой интерфейс для сложной системы
Хорошая регистрация пользователя - это пять-семь шагов внутри и одна функция снаружи. Facade - про эту одну функцию.
Проблема
Чтобы зарегистрировать пользователя, нужно:
- Валидировать данные
- Создать запись в БД
- Отправить welcome-email
- Записать событие в аналитику
- Создать настройки по умолчанию
Если клиентский код вызывает каждый сервис отдельно:
// в обработчике
if err := validator.Check(email, pass); err != nil { return err }
user, err := userRepo.Create(email, pass)
if err != nil { return err }
_ = mailer.SendWelcome(user.Email)
tracker.Event("register", user.ID)
settingsRepo.CreateDefaults(user.ID)
<?php
declare(strict_types=1);
// в обработчике
$validator->check($email, $pass);
$user = $userRepo->create($email, $pass);
try {
$mailer->sendWelcome($user->email);
} catch (Throwable) {
// некритично
}
$tracker->event('register', $user->id);
$settingsRepo->createDefaults($user->id);
# в обработчике
validator.check(email, password)
user = user_repo.create(email, password)
try:
mailer.send_welcome(user.email)
except Exception:
pass # некритично
tracker.event("register", user.id)
settings_repo.create_defaults(user.id)
Тот же код повторяется в API-обработчике, в CLI, в тестах. Каждый «клиент» знает все 5 шагов и правильный порядок - клиентский код не следует SRP, потому что вынужден держать в голове чужие детали.
Решение: Facade
Facade - один метод (или структура), который скрывает координацию нескольких подсистем. Клиент вызывает Register() и не думает о деталях.
Сценарий регистрации: фасад или Use Case?
Ниже - классический учебный «фасад регистрации». Посмотри на код, а чуть дальше разберём, почему по намерению он ближе к Use Case.
type RegisterFacade struct {
validator Validator
users UserRepo
mail Mailer
tracker Tracker
settings SettingsRepo
}
func NewRegisterFacade(
v Validator, u UserRepo, m Mailer, t Tracker, s SettingsRepo,
) *RegisterFacade {
return &RegisterFacade{
validator: v, users: u, mail: m, tracker: t, settings: s,
}
}
func (f *RegisterFacade) Register(email, pass string) (*User, error) {
// 1. Валидация
if err := f.validator.Check(email, pass); err != nil {
return nil, fmt.Errorf("validation: %w", err)
}
// 2. Создание пользователя
user, err := f.users.Create(email, pass)
if err != nil {
return nil, fmt.Errorf("create user: %w", err)
}
// 3. Некритичные операции - ошибки не блокируют регистрацию
if err := f.mail.SendWelcome(email); err != nil {
log.Printf("welcome email failed: %v", err)
}
f.tracker.Event("register", user.ID)
f.settings.CreateDefaults(user.ID)
return user, nil
}
Клиентский код прост:
user, err := facade.Register(email, pass)
final class RegisterFacade
{
public function __construct(
private readonly Validator $validator,
private readonly UserRepo $users,
private readonly Mailer $mail,
private readonly Tracker $tracker,
private readonly SettingsRepo $settings,
private readonly LoggerInterface $logger,
) {}
public function register(string $email, string $pass): User
{
// 1. Валидация
$this->validator->check($email, $pass);
// 2. Создание пользователя
$user = $this->users->create($email, $pass);
// 3. Некритичные операции - ошибки не блокируют регистрацию
try {
$this->mail->sendWelcome($email);
} catch (Throwable $e) {
$this->logger->warning('welcome email failed', ['err' => $e->getMessage()]);
}
$this->tracker->event('register', $user->id);
$this->settings->createDefaults($user->id);
return $user;
}
}
Клиентский код прост:
$user = $facade->register($email, $pass);
import logging
logger = logging.getLogger(__name__)
class RegisterFacade:
def __init__(
self,
validator: Validator,
users: UserRepo,
mail: Mailer,
tracker: Tracker,
settings: SettingsRepo,
) -> None:
self._validator = validator
self._users = users
self._mail = mail
self._tracker = tracker
self._settings = settings
def register(self, email: str, password: str) -> User:
# 1. Валидация - при ошибке validator бросает ValidationError
self._validator.check(email, password)
# 2. Создание пользователя
user = self._users.create(email, password)
# 3. Некритичные операции - ошибки не блокируют регистрацию
try:
self._mail.send_welcome(email)
except Exception:
logger.warning("welcome email failed", exc_info=True)
self._tracker.event("register", user.id)
self._settings.create_defaults(user.id)
return user
Клиентский код прост:
user = facade.register(email, password)
Критичные ошибки (валидация, БД) не перехватываются и летят вызывающему исключением - аналог return nil, err. Перехватывается только некритичная почта.
Один вызов вместо пяти. Порядок, обработка ошибок, логирование - всё внутри фасада.
ℹ️ Фасад упрощает клиентский код
Без фасада каждый клиент (handler, CLI, тест) повторяет одну и ту же последовательность вызовов. Фасад - единая точка входа. Изменил порядок шагов? Правишь одно место.
Facade и Use Case: похожи снаружи, разные по назначению
В коде они часто выглядят одинаково - один входной метод вместо пяти вызовов, - и отсюда рождается путаница. Различает их намерение, а не форма:
| Facade (GoF) | Use Case / Application Service | |
|---|---|---|
| Что решает | сложность доступа к готовой подсистеме | описывает прикладной сценарий целиком |
| Откуда берётся | из желания спрятать неудобный или разросшийся API | из требования продукта: «пользователь регистрируется» |
| Что внутри | последовательность вызовов подсистемы | сценарий: проверки, вызовы домена, транзакция, публикация события |
| Можно ли выбросить | да, если API стал удобным | нет: сценарий никуда не денется |
| Уровень | приём проектирования | слой архитектуры |
⚠️ «Use Case - это Facade с бизнес-правилами» - формулировка, от которой стоит отказаться
Она склеивает два понятия так, что потом их трудно разделить.
Проверка на практике простая: Facade появляется из-за неудобства существующего кода, Use Case - из-за требования предметной области. Если подсистему завтра заменят удобной библиотекой, фасад исчезнет; сценарий «зарегистрировать пользователя» останется, потому что он есть в продукте, а не в коде.
Из этого следует и разное отношение к бизнес-правилам. Facade их не должен содержать - иначе правила расползутся по обёрткам инфраструктуры. Use Case содержит правила уровня сценария (что проверить, в каком порядке позвать, чем закончить транзакцию), но не правила самого домена - те живут в сущностях и агрегатах.
А теперь честно про
RegisterFacadeиз примера выше: он пограничный, и назван фасадом по инерции. Посмотри, что он делает: вызывает валидацию, создаёт пользователя, а дальше принимает решение - «ошибка приветственного письма не отменяет регистрацию». Последнее и есть правило уровня сценария: его придумал не программист ради удобства, а продукт («не терять регистрации из-за почты»).По намерению это Use Case. Фасадом он был бы, если бы только пробрасывал вызовы, а решение о том, что критично и что нет, принимал вызывающий.
Это и есть главная мысль раздела: по коду отличить нельзя, отличают по причине появления. Один и тот же набор строк оказывается фасадом или сценарием в зависимости от того, откуда взялось требование - из неудобства API или из предметной области. Поэтому «Facade с бизнес-правилами» - плохое определение: как только правила появились, это уже не фасад.
Когда фасад полезен
| Сценарий | Зачем фасад |
|---|---|
| Отправка письма: шаблон + рендер + SMTP | Один вызов Send() вместо трёх |
| Оплата: проверка → списание → чек | Клиент не знает деталей |
| Импорт данных: парсинг → маппинг → БД | Один метод Import() |
| Деплой: сборка → тест → пуш → SSH | make deploy = фасад |
Фасад в Go stdlib
http.ListenAndServe(addr, handler)
- фасад над: создание Server, TCP-listener, Accept-loop, goroutine per conn
json.Marshal(v)
- фасад над: рефлексия, encoder, буфер, типы
exec.Command(name, args...).Run()
- фасад над: fork, exec, pipe, wait
http.ListenAndServe - одна строка, за которой скрыта сложная машинерия: создание TCP-сокета, принятие соединений, запуск горутин, парсинг HTTP.
Когда фасад маскирует проблемы
Фасад - это «удобная дверца». Но если за дверцей хаос, фасад его не исправит, а только спрячет:
God Facade - метод DoEverything() на 200 строк. Это не фасад, это монолит с красивым именем. Фасад должен делегировать, а не содержать логику.
Сокрытие плохого API - если подсистемы спроектированы плохо, фасад лишь откладывает рефакторинг. Лучше исправить подсистемы.
Фасад над фасадом - если ты оборачиваешь фасад другим фасадом, что-то пошло не так с декомпозицией.
⚠️ Бизнес-правила живут в домене
Фасад координирует вызовы, но НЕ содержит бизнес-правила. «Пароль минимум 8 символов» - это домен/валидатор. Фасад просто вызывает validator.Check(). Это применение SRP на уровне модуля: у фасада ровно одна причина меняться - изменение оркестрации шагов.
Когда НЕ использовать
Одна подсистема - если ты координируешь один сервис, фасад - лишняя обёртка. Вызывай сервис напрямую.
Клиенту нужен контроль - если разные клиенты вызывают шаги в разном порядке или пропускают некоторые, один фасад не подойдёт. Возможно, нужен Builder или несколько фасадов.
Тривиальная координация - если «фасад» это 2 вызова подряд, проще оставить как есть.
Связь с другими паттернами
Facade + Adapter - адаптер внутри фасада для внешних SDK
Facade + Observer - фасад публикует событие после выполнения
Facade + Factory - фабрика создаёт фасад с нужными зависимостями
Facade + Mediator - похожи: оба координируют, но Mediator управляет
взаимодействием МЕЖДУ объектами
Мини-задание
- Выдели один фасад для частого сценария в приложении (регистрация, оплата, импорт)
- Проверь: фасад только координирует? Или содержит бизнес-логику? Если да - вынеси логику в домен
- Найди
http.ListenAndServeв исходниках Go - сколько шагов он скрывает? - Подумай: есть ли в проекте «God Service» на 500 строк? Может, его стоит разбить на фасад + отдельные сервисы?