Читать книгу: «Наблюдатель. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Наблюдатель (Observer). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 19. Реализация на Python
19.1. Зачем нужен наблюдатель
Курс акции изменился — нужно обновить график, пересчитать портфель и, может быть, отправить уведомление. Пользователь сменил язык — нужно перерисовать все окна. Источник событий не должен знать, кто на них реагирует: сегодня это график, завтра добавится журнал, а послезавтра — бот в мессенджере.
Наблюдатель задаёт зависимость «один ко многим»: субъект хранит список подписчиков и оповещает их при изменении своего состояния. Подписчики подключаются и отключаются во время работы, а субъект знает о них только то, что у них есть метод обновления.
Это один из самых распространённых паттернов: обработчики событий в графических интерфейсах, сигналы в Django, реактивные потоки, механизм addEventListener в браузере. В Python наблюдателем часто служит обычная функция обратного вызова.
19.2. Участники и схема

Subject — хранит подписчиков, оповещает их.
Observer — интерфейс обновления.
Concrete Observer — реагирует на изменения.
19.3. Классический пример: биржевой курс
Файл 01_stock.py :

Листинг 19.1 — Классический пример: биржевой курс

Листинг 19.1 (продолжение) — Классический пример: биржевой курс
Разбор. Наблюдателем может быть любой вызываемый объект: функция chart, экземпляр класса с __call__ (Portfolio) или замыкание (make_alert). Оповещение происходит в сеттере свойства: клиент просто присваивает sber.price = 288. Повторная та же цена не вызывает уведомлений. subscribe возвращает функцию отписки — удобно, не нужно хранить ссылку на наблюдателя. Перебор идёт по копии списка (list(…)), чтобы наблюдатель мог отписаться прямо во время оповещения.
19.4. Слабые ссылки: подписчик не должен жить вечно
Субъект, который хранит обычные ссылки на подписчиков, не даёт сборщику мусора удалить их. Забытая отписка — классическая утечка памяти.
Файл 02_weak_observers.py :

Листинг 19.2 — Слабые ссылки: подписчик не должен жить вечно

Листинг 19.2 (продолжение) — Слабые ссылки: подписчик не должен жить вечно
Разбор. WeakSet хранит слабые ссылки: они не удерживают объект. Когда на окно не осталось других ссылок, оно удаляется и само исчезает из множества подписчиков. Порядок обхода WeakSet не гарантирован; если порядок оповещения важен, используйте список weakref.ref или WeakMethod для связанных методов.
19.5. Модификации паттерна
Наблюдаемое значение с цепочками вычислений
Файл 03_reactive.py :

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

Листинг 19.3 (продолжение) — Модификации паттерна
Разбор. Это ядро реактивного программирования, как в электронной таблице: total зависит от цены и количества, with_vat — от total, а надпись — от with_vat. Изменение исходного значения само распространяется по цепочке. Проверка value!= self._value обрывает лишние волны пересчёта.
Асинхронные подписчики
Файл 04_async_observers.py :

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

Листинг 19.4 (продолжение) — Модификации паттерна
Разбор. Асинхронные подписчики оповещаются параллельно, и общее время равно времени самого медленного, а не сумме. return_exceptions=True изолирует сбои: упавший push не мешает остальным. В синхронном варианте исключение одного наблюдателя оборвало бы оповещение всех следующих — об этом стоит помнить и там.
19.6. Самостоятельные работы
Работа 1. Прогресс загрузки
Задание. Загрузчик файлов сообщает о прогрессе. Подписчики: полоса прогресса в консоли, журнал (только каждые 50%) и обработчик завершения.
Полное решение — файл 05_progress.py :

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

Листинг 19.5 (продолжение) — Самостоятельные работы
Разбор. Два вида событий — два списка подписчиков. Milestones хранит своё состояние и использует while, потому что за один шаг можно перепрыгнуть несколько отметок.
Работа 2. Наблюдатель через дескриптор
Задание. Сделайте дескриптор observable, который превращает атрибут класса в наблюдаемый: при изменении вызывается метод on_change(name, old, new) объекта.
Полное решение — файл 06_descriptor.py :

Листинг 19.6 — Самостоятельные работы
Разбор. Дескриптор перехватывает присваивание атрибута на уровне класса. Метод __set_name__ узнаёт имя атрибута автоматически. Первое присваивание в конструкторе не считается изменением, а присваивание того же значения не порождает записи.
19.7. Типичные ошибки
Утечка памяти. Субъект держит подписчиков, которые давно не нужны. Отписывайтесь или используйте слабые ссылки.
Изменение списка во время обхода. Отписка в обработчике ломает перебор; обходите копию.
Каскады и циклы уведомлений. Подписчик меняет субъект, тот снова оповещает… Проверяйте, изменилось ли значение.
Исключение одного подписчика ломает остальных. Ловите и журналируйте ошибки обработчиков, если они независимы.
19.8. Вопросы для самопроверки
Какую зависимость описывает наблюдатель?
Что может быть наблюдателем в Python?
Зачем subscribe возвращать функцию отписки?
Почему список подписчиков обходят через копию?
Как weakref.WeakSet предотвращает утечку памяти?
Как работает распространение изменений в реактивной цепочке?
Чем полезен return_exceptions=True при асинхронном оповещении?
Как дескриптор помогает сделать атрибут наблюдаемым?
19.9. Ответы
«Один ко многим»: изменение субъекта оповещает всех подписчиков.
Любой вызываемый объект: функция, метод, замыкание, объект с __call__.
Чтобы отписаться, не храня ссылку на наблюдателя.
Чтобы подписчик мог отписаться во время оповещения, не ломая перебор.
Он не удерживает объекты, и удалённые подписчики исчезают из него автоматически.
Производные значения подписаны на исходные и пересчитываются при их изменении.
Сбой одного подписчика не прерывает оповещение остальных.
Он перехватывает присваивание атрибута и вызывает обработчик изменения.
Глава 19. Реализация на C++23
19.1. Поведение, зависящее от состояния
Один и тот же запрос может иметь разные последствия в зависимости от текущего состояния объекта: кнопка воспроизведения запускает остановленный плеер, ставит играющий на паузу и продолжает приостановленный. Когда условные переходы размножаются по многим методам, трудно проверить допустимые комбинации. Паттерн State из каталога GoF выделяет поведение состояний и поручает контексту делегировать ему события. Конечные автоматы и их табличные описания применялись и до объектно-ориентированных паттернов.

Выделенные состояния локализуют правила и упрощают добавление поведения, но увеличивают число типов и не всегда оправданы для маленького автомата. Нужно явно описать допустимые переходы, владение и реакцию на неподходящие события. Не следует уничтожать объект состояния посреди выполнения его собственного метода: в примере метод возвращает новое состояние, а контекст заменяет старое после возврата.
19.2. Классический пример: плеер
Player владеет текущим IState через unique_ptr. Состояние выбирает следующий объект в ответ на нажатие; контекст применяет переход после завершения вызова. Пример моделирует состояния и не воспроизводит звук.
Каждый листинг — отдельная полная программа на C++23:

Полный код — 00_player.cpp :

Листинг 19.1 — Классический пример: плеер

Листинг 19.1 (продолжение) — Классический пример: плеер
При смене состояния создаётся новый объект; состояние может вернуть пустой указатель, чтобы оставить прежнее. В примере все реализации возвращают следующий объект. Потокобезопасность и обработка внешних медиаошибок не предусмотрены.
Пример вывода:

19.3. Восемь вариантов и практика
1. Context-Driven State: турникет
Контекст централизованно решает, когда менять состояние, а состояния описывают действия. Задание: автомат турникета.
Полный код — 01_turnstile.cpp :

Листинг 19.2 — Восемь вариантов и практика
Разбор и ограничения. Монета переводит заблокированный турникет в открытое состояние, проход — обратно. Здесь состояние продублировано в логическом флаге и полиморфном объекте: контекст обязан обновлять их вместе. Оплата и оборудование моделируются.
Пример вывода:

2. State-Driven Transitions: персонаж
Правила перехода находятся в классах конкретных состояний. Задание: поведение персонажа с децентрализованными переходами.
Полный код — 02_character.cpp :

Листинг 19.3 — Восемь вариантов и практика

Листинг 19.3 (продолжение) — Восемь вариантов и практика
Разбор и ограничения. Idle и Walking предлагают переход через change_state, но контекст откладывает замену до окончания handle. Это предотвращает уничтожение выполняющегося объекта. Вложенная повторная диспетчеризация и конкурентные события не поддерживаются.
Пример вывода:

3. Table-Driven State Machine: парсер протокола
Таблица явно связывает состояние и событие со следующим состоянием и действием. Задание: парсер простой строки протокола.
Полный код — 03_table_parser.cpp :

Листинг 19.4 — Восемь вариантов и практика

Листинг 19.4 (продолжение) — Восемь вариантов и практика
Разбор и ограничения. Допускается сообщение вида @42 с завершающим переводом строки; неожиданный символ и незавершённое сообщение возвращают ошибку. Формат учебный, ограничение длины и сетевое чтение не реализованы.
Пример вывода:

4. Hierarchical State Machine: светофор
Подсостояния могут разделять общие переходы родителя, например выключение питания. Задание: иерархический автомат светофора.
Полный код — 04_hierarchical_light.cpp :

Листинг 19.5 — Восемь вариантов и практика

Листинг 19.5 (продолжение) — Восемь вариантов и практика
Разбор и ограничения. Событие сначала предлагается цвету в режиме On, а затем общему обработчику режима. При повторном включении выбирается красный. Это модель последовательности, не безопасный контроллер дорожного движения и не полная реализация всех правил statecharts.
Пример вывода:

5. Typestate: сетевое соединение
Тип объекта выражает допустимые операции на этапе компиляции. Задание: соединение с отдельными типами до и после подключения.
Полный код — 05_typestate_connection.cpp :

Листинг 19.6 — Восемь вариантов и практика

Листинг 19.6 (продолжение) — Восемь вариантов и практика

Листинг 19.6 (продолжение) — Восемь вариантов и практика

Листинг 19.6 (продолжение) — Восемь вариантов и практика
Разбор и ограничения. connect_local доступен для Connection<Disconnected>, а send и close — для Connection<Connected>. Пример действительно подключается по TCP к локальному тестовому серверу. Состояния перемещаются, а дескриптор закрывается через RAII. C++ не является языком линейных типов: перемещённый объект всё ещё существует, поэтому для него остаются проверки во время выполнения. TLS, удалённые адреса и полный контроль тайм-аутов отсутствуют.
Пример вывода:

6. Enum / std::variant: заказ
Небольшой набор состояний можно хранить прямо в variant и выбирать обработчик через visit. Задание: компактный автомат заказа.
Полный код — 06_variant_order.cpp :

Листинг 19.7 — Восемь вариантов и практика
Разбор и ограничения. Переход сначала возвращает новый вариант, а замена выполняется после visit; так не уничтожается активная альтернатива в процессе её посещения. Данные состояний в примере пустые, и сам variant не требует отдельного выделения под них. Нулевые накладные расходы для произвольных типов и программ стандарт не гарантирует.
Пример вывода:

7. Persistent / Database-Backed State: страховая заявка
Бизнес-процесс должен продолжаться после перезапуска программы. Задание: загружать код состояния из базы данных и создавать соответствующий объект состояния.
Полный код — 07_persistent_claim.cpp :

Листинг 19.8 — Восемь вариантов и практика

Листинг 19.8 (продолжение) — Восемь вариантов и практика

Листинг 19.8 (продолжение) — Восемь вариантов и практика

Листинг 19.8 (продолжение) — Восемь вариантов и практика
В Ubuntu / WSL установите libsqlite3-dev и соберите g++ -std=c++23 -Wall -Wextra -Wpedantic -pthread example.cpp -lsqlite3 -o example. Запустите ./example claims.sqlite на новой тестовой базе. Программа создаст таблицу и изменит состояние заявки.
Разбор и ограничения. SQLite действительно хранит код заявки. hydrate создаёт класс для прочитанного кода, а условный UPDATE проверяет, что состояние не изменилось между чтением и записью. Это простая модель одной заявки: миграции, журнал событий, внешние сервисы, идентичность, повторные попытки и полноценные транзакции процесса отсутствуют.
Пример вывода:

8. Pushdown Automaton: меню
Стек позволяет временно открыть новое состояние и затем вернуться к предыдущему. Задание: навигация по меню игры.
Полный код — 08_menu_stack.cpp :

Листинг 19.9 — Восемь вариантов и практика
Разбор и ограничения. Поверх игры открываются пауза и настройки; back снимает верхнее состояние, но не удаляет базовое. Реальный UI, события клавиатуры и сохранение стека не реализованы.
Пример вывода:

19.4. Null Object / Special Case — Strategy / State
Пустое состояние сетевого соединения
Задание: заменить отсутствующее состояние объектом с безопасным пустым поведением.
Полный код — 09_null_state.cpp :

Листинг 19.10 — Null Object / Special Case — Strategy / State
Разбор и ограничения. После отключения send вызывает NullState и ничего не делает; в состоянии Connected пример печатает модель отправки. Настоящего сокета нет. Молчаливый отказ подходит не всегда: если потерю данных нужно сообщать, следует возвращать явную ошибку.
Пример вывода:

Бесплатный фрагмент закончился.
