Read the book: «Мост. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Мост (Bridge). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 7. Реализация на Python
7.1. Зачем нужен мост
Представьте систему уведомлений. Уведомления бывают обычные, срочные и сводные, а доставлять их можно по почте, в SMS и в мессенджер. Если делать отдельный класс на каждое сочетание, получится девять классов: UrgentEmail, UrgentSms, DigestTelegram… Новый канал добавит ещё три, новый вид уведомления — ещё три. Это «взрыв подклассов».
Мост разделяет две независимые оси изменений на две иерархии: абстракцию (что делаем — вид уведомления) и реализацию (как делаем — канал доставки). Абстракция хранит ссылку на реализацию и делегирует ей низкоуровневую работу. Теперь сочетаний по-прежнему девять, а классов — шесть, и оси растут независимо.
7.2. Участники и схема

Abstraction — высокоуровневый интерфейс, хранит ссылку на реализацию.
Refined Abstraction — разновидности абстракции.
Implementor — интерфейс реализации, обычно примитивнее абстракции.
Concrete Implementor — конкретные реализации.
Мост похож на адаптер устройством, но отличается целью: адаптер соединяет уже существующие несовместимые части, а мост проектируют заранее, чтобы две оси развивались независимо.
7.3. Классический пример: уведомления и каналы
Файл 01_notifications.py :

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

Листинг 7.1 (продолжение) — Классический пример: уведомления и каналы
Разбор. Три вида уведомлений и два канала дают шесть сочетаний, но классов пять. Каждая сторона занимается своим: абстракция решает, что отправить и сколько раз (Urgent дублирует, Digest копит), реализация — как доставить (SMS обрезает длинный текст). Добавить Telegram — один новый класс, и он сразу работает со всеми видами уведомлений.
7.4. Мост с функцией в качестве реализации
Когда реализация — одна операция, её удобно передавать функцией. Это облегчённый мост, характерный для Python.
Файл 02_function_bridge.py :

Листинг 7.2 — Мост с функцией в качестве реализации

Листинг 7.2 (продолжение) — Мост с функцией в качестве реализации
Разбор. Иерархия отчётов ничего не знает о форматах. Любая функция dict -> str годится как реализация — хоть лямбда. Тип Serializer документирует контракт моста.
7.5. Модификации паттерна
Смена реализации во время работы
Файл 03_runtime_switch.py :

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

Листинг 7.3 (продолжение) — Модификации паттерна
Разбор. Поскольку абстракция держит реализацию в поле, её можно заменить на ходу — здесь вместе с переносом данных. При наследовании (SettingsInMemory, SettingsInFile) такое было бы невозможно: класс объекта не меняется.
Параллельная реализация
Одна и та же абстракция может работать с последовательной и параллельной реализацией вычислений.
Файл 04_parallel_backend.py :

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

Листинг 7.4 (продолжение) — Модификации паттерна
Разбор. ImageBatch описывает, что делать с картинками, а выбор между последовательным и многопоточным исполнением — забота реализации. ThreadPoolExecutor.map сохраняет порядок результатов, поэтому оба варианта дают одинаковый список. Добавить пул процессов — ещё один маленький класс.
7.6. Самостоятельные работы
Работа 1. Фигуры и способы отрисовки
Задание. Сделайте фигуры (прямоугольник, круг) и два способа отрисовки: текстовый и SVG. Фигура должна знать только геометрию.
Полное решение — файл 05_shapes.py :

Листинг 7.5 — Самостоятельные работы

Листинг 7.5 (продолжение) — Самостоятельные работы

Листинг 7.5 (продолжение) — Самостоятельные работы
Разбор. Геометрия (area, scale) живёт в фигурах, вывод — в рендерерах. Интерфейс реализации примитивен: «нарисуй прямоугольник с такими размерами». Это типично для моста: реализация даёт кирпичики, абстракция собирает из них поведение.
Работа 2. Пульт и устройства
Задание. Обычный пульт умеет включать и менять громкость, расширенный — ещё и выключать звук. Устройства: телевизор и радио с разными пределами громкости.
Полное решение — файл 06_remote.py :

Листинг 7.6 — Самостоятельные работы

Листинг 7.6 (продолжение) — Самостоятельные работы
Разбор. Пульты (абстракция) работают через общий интерфейс устройства, а ограничения громкости — забота реализации. AdvancedRemote добавляет поведение, не трогая устройства.
7.7. Типичные ошибки
Мост ради одной оси. Если реализация одна и не предвидится второй, мост — лишняя сложность.
Протекающая реализация. Если абстракция проверяет isinstance конкретной реализации, связь двух иерархий восстанавливается. Видите такую проверку (как в migrate_to) — подумайте о методе в интерфейсе реализации.
Слишком богатый интерфейс реализации. Реализация должна давать примитивы; бизнес-логика — в абстракции.
Путаница с адаптером. Адаптер исправляет несовместимость постфактум, мост задаёт структуру заранее.
7.8. Вопросы для самопроверки
Какую проблему решает мост?
Что такое абстракция и реализация в терминах моста?
Сколько классов нужно для 4 видов и 3 реализаций с мостом и без?
Чем мост отличается от адаптера?
Почему мост позволяет менять реализацию во время работы?
Когда реализацию удобно передать функцией?
Почему ThreadPoolExecutor.map подходит для замены последовательной реализации?
Каким должен быть интерфейс реализации?
7.9. Ответы
Взрыв подклассов при двух независимых осях изменений.
Абстракция — высокоуровневая логика для клиента; реализация — низкоуровневые операции, которым абстракция делегирует работу.
С мостом 4 + 3 = 7, без него 4 × 3 = 12.
Целью и моментом появления: мост проектируют заранее для независимого развития, адаптер связывает уже существующее.
Реализация хранится в поле (композиция), а не задаётся наследованием.
Когда интерфейс реализации состоит из одной операции.
Он возвращает результаты в исходном порядке, как обычный map.
Примитивным: набор базовых операций, из которых абстракция собирает поведение.
Глава 7. Реализация на C++23
7.1. Две независимые оси изменений
Представим несколько видов пультов и несколько устройств. Если создавать отдельный подкласс для каждой пары, число конкретных классов растёт вместе с числом комбинаций: обычный пульт для телевизора, расширенный пульт для телевизора, обычный пульт для радио и так далее.
Bridge разделяет абстракцию и её реализацию, чтобы они могли изменяться независимо. Пульт представляет пользовательское поведение, устройство — способ выполнения операций. Пульт хранит ссылку или владеющий указатель на интерфейс устройства и делегирует ему часть работы.
Идея не означает, что число конкретных классов всегда автоматически уменьшится с N × M до N + M: некоторые сочетания могут требовать отдельной логики или быть недоступны. Мост делает независимость двух осей явной и позволяет собирать подходящие комбинации без отдельного подкласса для каждой пары.
7.2. Участники и архитектура
Abstraction определяет клиентский интерфейс и хранит ссылку на реализацию.
RefinedAbstraction расширяет поведение абстракции.
Implementor определяет интерфейс операций реализации.
ConcreteImplementor выполняет операции определённым способом.

Мост полезен при необходимости менять одну сторону без переписывания другой, скрывать платформенные детали или выбирать реализацию во время работы. Цена — дополнительные интерфейсы и переходы между объектами. Если вариаций нет и они не ожидаются, прямая реализация может быть понятнее.
Отличие от Adapter: адаптер согласует уже существующие несовместимые интерфейсы, а мост заранее разделяет две оси развития. Отличие от PIMPL: PIMPL скрывает детали реализации и уменьшает зависимость заголовка, но сам по себе не обязательно предоставляет несколько взаимозаменяемых реализаций.
7.3. Классический пример: пульты и устройства
Remote владеет Device через std::unique_ptr; AdvancedRemote добавляет операцию громкости. Tv и Radio можно подставить под общий интерфейс. Значения устройства в примере моделируются в памяти: программа не управляет физической аппаратурой.

Листинг 7.1 — Классический пример: пульты и устройства

Листинг 7.1 (продолжение) — Классический пример: пульты и устройства
Разбор. Device задаёт операции устройства, Tv и Radio хранят их состояние. Remote владеет одной реализацией и переводит операцию toggle в запросы к интерфейсу устройства. AdvancedRemote добавляет поведение, не создавая отдельные подклассы для каждого типа устройства.
Конструктор отклоняет пустой указатель. Виртуальные деструкторы и unique_ptr освобождают реализацию автоматически. Пример однопоточный; общий изменяемый реальный драйвер потребовал бы собственного договора синхронизации.
Вывод:

7.4. Семь разновидностей и связанных приёмов
1. Classic GoF Orthogonal Bridge
Две иерархии — например, фигуры и рендереры — связываются через интерфейс реализации. Фигуры развиваются независимо от классов рендеринга. Работа 1 использует модельные OpenGL и Vulkan рендереры и не вызывает графические API.
2. PIMPL / Opaque Pointer / Cheshire Cat
Публичный заголовок хранит указатель на неполный Impl, а детали располагаются в .cpp. Деструктор класса с std::unique_ptr<Impl> определяют там, где Impl уже полный. Это уменьшает раскрытие деталей и может помочь стабильности ABI, но не гарантирует её при любых изменениях интерфейса, компилятора или стандартной библиотеки. Работа 2 реализует настоящий блокирующий TCP-клиент на POSIX/Windows.
3. Static / Template Bridge
Реализация задаётся шаблонным параметром и проверяется концептом. Выбор происходит при компиляции, поэтому не требует виртуального вызова; утверждение о полном отсутствии накладных расходов требует измерения конкретного кода. Работа 3 сравнивает файловую систему ОС и тестовую реализацию в памяти.
4. Factory-Configured Bridge
Абстракция сама выбирает или получает от фабрики реализацию, например в зависимости от платформы. Это скрывает выбор от клиента, но необходимо определить способ подмены реализации и поведение при ошибке. Работа 4 создаёт поток через POSIX или Win32 в зависимости от платформы сборки.
5. Degenerate / Single-Implementor Bridge
Даже при одной реализации общий интерфейс может изолировать модуль от конкретной зависимости. Это оправдано, если граница действительно нужна; иначе интерфейс добавляет лишний слой. Работа 5 вычисляет SHA-256 через один бэкенд OpenSSL. Хеширование не является шифрованием.
6. Shared Implementor Bridge
Несколько абстракций могут совместно владеть одной реализацией через shared_ptr. Контракт должен учитывать изменяемое состояние и стоимость синхронизации. Работа 6 разделяет неизменяемый каталог условных GPU-ресурсов; реальные ресурсы GPU там не создаются.
7. Driver / SPI Bridge
Стабильный клиентский API делегирует операции поставщику через описанный интерфейс. Драйвер может выбираться при запуске и загружаться динамически. Работа 7 содержит настоящий загружаемый плагин с C-связыванием и модельным хранилищем в памяти. ABI, версии и время жизни библиотеки являются частью договора.
7.5. Связанные структурные решения
Twin — Adapter + Bridge
Пара связанных объектов может представлять разные роли и делегировать операции партнёру. В работе 9 владелец содержит оба объекта, а их обратные указатели не владеют ресурсами. Запрещённое копирование защищает от случайного переноса внутренних указателей на прежний объект.
Private Class Data — Bridge / PIMPL
Вынесенное состояние может храниться как unique_ptr<const Data>, если после создания оно должно оставаться неизменяемым через этот указатель. Работа 10 хранит параметры сетевого соединения отдельно от открытого интерфейса. Объект конфигурации не создаёт реального подключения.
7.6. Практические работы с полным кодом
Для однофайловых примеров без внешних библиотек используйте:

Работы 2 и 7 состоят из нескольких файлов; работа 5 требует OpenSSL. Для них приведены отдельные команды. Ветви Windows даны для сборки с подходящими средствами Windows и отдельно в этой среде не запускались.
1. Classic Bridge: фигуры и рендереры
Задание. Разделите иерархии фигур и рендереров OpenGL/Vulkan.
Полный код — 01_shapes.cpp :

Листинг 7.2 — Практические работы с полным кодом

Листинг 7.2 (продолжение) — Практические работы с полным кодом
Разбор. Shape владеет реализацией Renderer; Circle и Square делегируют ей рисунок. Разновидности фигур и рендереров можно комбинировать через конструктор. Сами рендереры в примере выводят имена и не вызывают API OpenGL или Vulkan. Объекты не разделяются между потоками.
Пример вывода:

The free sample has ended.