Читать книгу: «Фасад. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Фасад (Facade). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 10. Реализация на Python
10.1. Зачем нужен фасад
Чтобы оформить заказ в интернет-магазине, нужно проверить остатки на складе, зарезервировать товар, списать деньги, создать отправку в службе доставки и отправить письмо. Пять подсистем, у каждой свой интерфейс, свои ошибки и свой порядок вызовов. Если каждый обработчик веб-запроса будет делать это сам, логика размножится, а ошибки отката (деньги списали, а доставка не создалась) появятся в самых неожиданных местах.
Фасад — простой интерфейс к сложной подсистеме. Он знает, каких участников вызвать и в каком порядке, а клиент вызывает один метод place_order. Подсистемы при этом остаются доступны напрямую для тех, кому нужен тонкий контроль.
В стандартной библиотеке Python много фасадов: shutil.copytree прячет обход каталогов и копирование метаданных, subprocess.run — создание процесса, каналы и ожидание, urllib.request.urlopen — сокеты, HTTP и перенаправления.
10.2. Участники и схема

Facade — знает, каким подсистемам делегировать запрос, и координирует их.
Subsystem classes — выполняют реальную работу и ничего не знают о фасаде.
10.3. Классический пример: оформление заказа
Файл 01_order_facade.py :

Листинг 10.1 — Классический пример: оформление заказа

Листинг 10.1 (продолжение) — Классический пример: оформление заказа

Листинг 10.1 (продолжение) — Классический пример: оформление заказа
Разбор. Клиенту нужно знать один метод. Самое ценное в фасаде — согласованность: если оплата не прошла, резерв снимается, и футболок снова две. Без фасада каждый вызывающий код должен был бы помнить об этом откате. Фасад не скрывает подсистемы полностью: inv доступен, и можно, например, проверить остатки напрямую.
10.4. Фасад над стандартной библиотекой
Часто фасад пишут над чужими модулями, чтобы спрятать подробности, которые повторяются в каждом проекте.
Файл 02_archive_facade.py :

Листинг 10.2 — Фасад над стандартной библиотекой

Листинг 10.2 (продолжение) — Фасад над стандартной библиотекой
Разбор. За методом create скрыты pathlib, zipfile, hashlib и json: обход папки, относительные пути с прямыми слешами, сжатие, контрольные суммы и манифест. Клиент вызывает две функции. sorted делает порядок файлов в архиве детерминированным на любой ОС.
10.5. Модификации паттерна
Модуль как фасад
В Python фасадом часто служит модуль или пакет: __init__.py импортирует нужные имена из внутренних модулей и задаёт __all__. Смоделируем это функциями.
Файл 03_module_facade.py :

Листинг 10.3 — Модификации паттерна
Разбор. Подчёркивание в начале имени сообщает: это внутренняя деталь. Публичным остаётся analyze, который собирает разбор, удаление выбросов по межквартильному размаху и расчёт статистики. Выброс 900 исключён. SimpleNamespace здесь изображает модуль stats, с которым работал бы клиент.
Асинхронный фасад
Фасад может прятать и параллельность: клиент вызывает один метод, а внутри одновременно идут запросы к нескольким сервисам.
Файл 04_async_facade.py :

Листинг 10.4 — Модификации паттерна

Листинг 10.4 (продолжение) — Модификации паттерна
Разбор. return_exceptions=True заставляет gather вернуть исключение как значение, а не прервать всё. Фасад решает, как деградировать: без новостей сводка всё равно полезна. Клиенту не нужно знать ни про три сервиса, ни про обработку их сбоев.
10.6. Самостоятельные работы
Работа 1. Домашний кинотеатр
Задание. Подсистемы: проектор, усилитель, плеер, свет. Сделайте фасад с методами watch(movie) и end(), которые включают и выключают всё в правильном порядке.
Полное решение — файл 05_home_theater.py :

Листинг 10.5 — Самостоятельные работы
Разбор. Порядок важен: усилитель выключают после остановки плеера, чтобы не было щелчка в колонках. Фасад хранит это знание в одном месте.
Работа 2. Фасад для запуска команд
Задание. Оберните subprocess.run в функцию sh(cmd), которая возвращает вывод без перевода строки в конце, а при ошибке выбрасывает понятное исключение с кодом и stderr.
Полное решение — файл 06_shell_facade.py :

Листинг 10.6 — Самостоятельные работы
Разбор. subprocess.run и сам фасад над системными вызовами, но у него много параметров. Наш маленький фасад фиксирует удобные значения по умолчанию и превращает три вида результата (успех, ненулевой код, таймаут) в одно поведение: строка или исключение. from None скрывает техническую цепочку исключений.
10.7. Типичные ошибки
Фасад-«бог». Фасад начинает содержать бизнес-логику подсистем вместо координации. Он должен быть тонким.
Полное сокрытие подсистем. Если фасад закрывает доступ к подсистемам, продвинутым клиентам придётся раздувать его новыми параметрами.
Отсутствие отката. Фасад, который вызывает шаги по порядку, но не отменяет сделанное при сбое, оставляет систему в несогласованном состоянии.
Фасад, повторяющий интерфейс подсистемы. Если методы фасада один к одному вызывают методы подсистемы, пользы нет.
10.8. Вопросы для самопроверки
Какую проблему решает фасад?
Должен ли фасад запрещать прямой доступ к подсистемам?
Приведите примеры фасадов в стандартной библиотеке Python.
Почему откат резерва — ответственность фасада?
Как модуль может выступать фасадом?
Зачем в асинхронном фасаде return_exceptions=True?
Чем фасад отличается от адаптера?
Как понять, что фасад стал слишком толстым?
10.9. Ответы
Сложность использования подсистемы из многих частей: фасад даёт простой интерфейс для частых сценариев.
Нет, подсистемы остаются доступными для тех, кому нужен тонкий контроль.
shutil.copytree, subprocess.run, urllib.request.urlopen, json.dump.
Фасад знает последовательность шагов и поэтому отвечает за их согласованность.
Через __init__.py и __all__: публикуются нужные функции, внутренние модули скрыты.
Чтобы сбой одного сервиса не обрушил всю сводку.
Адаптер приводит один интерфейс к другому, фасад упрощает работу со многими объектами.
Если в нём появляются расчёты и правила, которым место в подсистемах, и он растёт с каждой фичей.
Глава 10. Реализация на C++23
10.1. Зачем нужен упрощённый вход в подсистему
Допустим, клиенту видеоконвертера приходится отдельно проверять файл, подготавливать параметры, запускать кодек и обрабатывать результат. Если каждый клиент повторяет эти шаги, он тесно связан с устройством подсистемы и легко нарушает порядок вызовов.
Facade предоставляет более простой высокоуровневый интерфейс к нескольким объектам или операциям подсистемы. Видеоконвертер может предложить клиенту один метод convert, а детали проверки, запуска и обработки ошибок оставить внутри.
Фасад относится к структурным паттернам GoF. Он не обязан реализовывать всю работу самостоятельно и не делает подсистему ненужной: он координирует её компоненты. Для сложных случаев доступ к деталям может быть сохранён или закрыт — это отдельный выбор интерфейса.
10.2. Участники и схема
Facade предоставляет удобные операции клиентам.
Subsystem выполняет конкретные операции и управляет своими ресурсами.
Client использует фасад и зависит от меньшего числа деталей.

Фасад удобен, когда у подсистемы много шагов, но у клиентов есть повторяющиеся сценарии. Он снижает связанность и централизует порядок работы. Если сложить в один класс несвязанные сценарии, фасад может превратиться в перегруженный God Object; тогда имеет смысл разделить его по клиентам или обязанностям.
Отличие от Adapter: адаптер согласует несовместимый интерфейс, фасад упрощает работу с подсистемой. Отличие от Mediator: посредник координирует взаимодействие равноправных компонентов, а фасад обычно предоставляет клиенту высокоуровневую точку входа. Один объект может сочетать несколько ролей, но их цели полезно различать.
10.3. Классический пример: видеоконвертер
Ниже фасад принимает пути std::filesystem::path, проверяет вход и существование выхода, запускает установленный FFmpeg отдельным процессом и возвращает ошибку через std::expected. Аргументы передаются через execlp, без конструирования команды для оболочки.
Пример предназначен для POSIX/Linux/WSL. Он блокирует вызывающий поток до завершения процесса, не перезаписывает существующий выходной файл и не реализует отмену. При неудачном преобразовании FFmpeg может оставить частичный новый файл; это нужно учитывать вызывающей стороне.

Листинг 10.1 — Классический пример: видеоконвертер

Листинг 10.1 (продолжение) — Классический пример: видеоконвертер
Сборка и проверка в Ubuntu / WSL:

Выполняйте опыт в отдельной папке: команда создания source.mp4 использует перезапись, а фасад откажется перезаписывать уже существующий output.mkv.
Разбор. VideoConverter проверяет входной и выходной пути и переводит их в абсолютные строки. Дочерний процесс запускает FFmpeg с отдельными аргументами; оболочка не интерпретирует имена файлов как команду. Родитель обрабатывает прерывание waitpid и проверяет код завершения.
Проверка наличия файла не гарантирует его доступность в момент последующего чтения: между операциями файловая система может измениться. Код не ограничивает время работы FFmpeg и не удаляет частичный результат при ошибке. Для настоящего сервиса нужны контроль ресурсов, журналирование и политика очистки.
Вывод: Conversion finished.
10.4. Шесть разновидностей фасада
1. Opaque / Strict Facade
Клиенту доступен только публичный интерфейс фасада, детали подсистемы скрыты в .cpp или не экспортируются из модуля. Работа 2 использует PIMPL для учебной инициализации движка. Реальный рендерер и загрузка ресурсов в ней не реализованы.
2. Transparent / Open Facade
Фасад упрощает распространённые сценарии, но оставляет продвинутому клиенту доступ к подсистеме. Это повышает гибкость ценой более сильной зависимости от деталей. Работа 3 открывает локальное TCP-соединение и позволяет напрямую настроить таймаут в реестре соединений.
3. Abstract / Polymorphic Facade
Общий интерфейс допускает разные реализации всей подсистемы, включая тестовую. Работа 4 генерирует настоящий WAV-файл и сравнивает его с MockAudio, считающим вызовы. Генерация файла не воспроизводит звук на аудиоустройстве.
4. Scoped / Role-Based Facade
Разным клиентам можно предоставить узкие интерфейсы поверх общей подсистемы. Работа 5 разделяет операции пользователя и администратора. Само существование двух классов не выполняет проверку личности или прав: авторизация должна быть реализована отдельно.
5. Stateful Session Facade
Фасад может хранить этапы длительного процесса. Работа 6 моделирует подготовку и фиксацию перевода в памяти. Состояние баланса при подготовке может измениться, поэтому фиксация повторно проверяет условия под мьютексом. Это учебная модель, не банковская система и не долговечная транзакция.
6. Remote Facade / API Gateway / BFF
Сетевой фасад принимает запрос и агрегирует результаты нескольких сервисов. Работа 7 содержит локальный HTTP-шлюз, который запускает две корутины и собирает ответы двух локальных HTTP-сервисов. Сами блокирующие сетевые операции выполняются в отдельных рабочих потоках; это не полноценный неблокирующий сетевой стек.
10.5. Reactor и событийный цикл
Reactor ожидает готовности источников событий и направляет управление соответствующему обработчику. Работа 1 использует POSIX poll, канал pipe, std::jthread и корутину. Это ограниченный пример с одним ожидающим обработчиком, а не универсальный событийный цикл для множества сокетов.
10.6. Самостоятельные работы с полным кодом
Однофайловые переносимые примеры можно собрать так:

Работы с poll, процессами и сокетами рассчитаны на Linux/WSL. Для видеоконвертера дополнительно нужен установленный ffmpeg. В работе 2 используются три отдельных файла.
Бесплатный фрагмент закончился.
