Читать книгу: «Команда. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Команда (Command). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 14. Реализация на Python
14.1. Зачем нужна команда
В текстовом редакторе пользователь печатает, удаляет и форматирует, а потом нажимает «Отменить» — и последнее действие откатывается. Затем «Повторить». Кнопка панели, пункт меню и сочетание клавиш выполняют одно и то же действие. Задачи откладывают в очередь, чтобы выполнить позже или в другом потоке. Всё это возможно, если превратить действие в объект.
Команда инкапсулирует запрос как объект: что сделать, над чем и с какими параметрами. Такой объект можно сохранить в историю, поставить в очередь, передать по сети, отменить, выполнить повторно или объединить с другими в макрокоманду.
В Python любая функция уже объект, поэтому простейшая команда — это функция или functools.partial. Класс нужен, когда у команды есть дополнительное поведение: отмена, описание, сериализация.
14.2. Участники и схема

Command — интерфейс выполнения (и отмены).
Concrete Command — связывает получателя и действие.
Receiver — объект, который выполняет реальную работу.
Invoker — инициирует выполнение и хранит историю.
Client — создаёт команды и настраивает получателей.
14.3. Классический пример: редактор с отменой
Файл 01_editor.py :

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

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

Листинг 14.1 (продолжение) — Классический пример: редактор с отменой
Разбор. Каждая команда знает, как отменить себя. Delete запоминает удалённый текст при выполнении — без этого отмена невозможна. Редактор хранит два стека: выполненные и отменённые команды. Новое действие очищает стек повторов, иначе история стала бы противоречивой. Сам редактор ничего не знает о вставках и удалениях — он работает с любыми объектами, у которых есть execute и undo.
14.4. Функции как команды
Файл 02_function_commands.py :

Листинг 14.2 — Функции как команды

Листинг 14.2 (продолжение) — Функции как команды
Разбор. partial(hall.set, 100) — готовая команда: получатель (hall), действие (set) и параметр (100) упакованы в вызываемый объект. Макрокоманда — замыкание, вызывающее список команд. Пульт хранит команды в словаре и не знает, что за ними стоит.
14.5. Модификации паттерна
Очередь команд и исполнитель в потоках
Файл 03_command_queue.py :

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

Листинг 14.3 (продолжение) — Модификации паттерна
Разбор. Команды кладутся в очередь с приоритетом и выполняются отдельным потоком. dataclass(order=True) с compare=False у остальных полей делает команды сравнимыми только по приоритету: платежи выполняются раньше отчётов. Специальная команда STOP с самым низким приоритетом завершает исполнителя после всех остальных. Одинаковые приоритеты в PriorityQueue не гарантируют порядок вставки; здесь равные платежи упорядочились случайно удачно — для строгого порядка добавьте в ключ счётчик.
Сериализуемые команды
Команду, описанную данными, можно сохранить в журнал и воспроизвести — так работают журналы транзакций и event sourcing.
Файл 04_serializable.py :

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

Листинг 14.4 (продолжение) — Модификации паттерна
Разбор. Команда здесь — словарь, а обработчики выбираются по имени операции. Журнал легко сохранить, передать на другую машину и воспроизвести, получив точно такое же состояние. Воспроизведя часть журнала, можно восстановить состояние на любой момент в прошлом.
14.6. Самостоятельные работы
Работа 1. Транзакция с откатом
Задание. Выполните группу команд как транзакцию: если одна команда падает, все уже выполненные откатываются в обратном порядке.
Полное решение — файл 05_transaction.py :

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

Листинг 14.5 (продолжение) — Самостоятельные работы
Разбор. Откат идёт в обратном порядке: последнее выполненное отменяется первым. Во второй транзакции упала уже первая команда, поэтому откатывать нечего, и состояние не изменилось.
Работа 2. Объединение команд ввода
Задание. В редакторе каждая нажатая буква — команда. Объединяйте подряд идущие вставки в одну, чтобы «Отменить» убирало слово, а не букву.
Полное решение — файл 06_merge.py :

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

Листинг 14.6 (продолжение) — Самостоятельные работы
Разбор. Новая команда пытается слиться с последней в истории. Пробел начинает новую команду, к которой затем присоединяются буквы следующего слова.
14.7. Типичные ошибки
Отмена без сохранения состояния. Команда удаления, которая не запомнила удалённое, не может отменить себя.
Общий изменяемый объект в команде. Если команда хранит ссылку на список, который потом меняется, повтор выполнит не то, что было.
Неограниченная история. История команд растёт бесконечно. Ограничьте её (collections.deque(maxlen=…)).
Сброс повторов. Если после новой команды не очистить стек отменённых, redo применит команду к другому состоянию.
14.8. Вопросы для самопроверки
Что инкапсулирует команда?
Кто такие получатель и инициатор?
Почему в Python простейшая команда — функция?
Как реализовать отмену и повтор?
Почему новое действие очищает стек повторов?
Зачем делать команды сериализуемыми?
Как сделать объекты сравнимыми только по приоритету?
Как работает откат транзакции из команд?
14.9. Ответы
Запрос: действие, получателя и параметры.
Получатель выполняет работу, инициатор запускает команды и хранит историю.
Функции — объекты первого класса; partial связывает получателя и аргументы.
Двумя стеками: выполненные и отменённые; каждая команда умеет undo.
Отменённые команды относятся к другой ветке истории и не подходят к новому состоянию.
Чтобы хранить журнал, передавать команды и воспроизводить состояние.
dataclass(order=True) и field(compare=False) у остальных полей.
Выполненные команды запоминаются и при сбое отменяются в обратном порядке.
Глава 14. Реализация на C++23
14.1. От вызова метода к объекту действия
Команда представляет запрос как значение или объект: в нём сохраняются действие, получатель и необходимые параметры. Клиент создаёт команду, инициатор (Invoker) решает, когда её выполнить, а получатель (Receiver) выполняет предметную работу. Так можно ставить действия в очередь, вести историю, составлять группы команд и отправлять данные в обработчик. Паттерн описан в каталоге GoF; его применяют в редакторах, интерфейсах, фоновых задачах и распределённых системах.

Команды уменьшают связь между источником запроса и получателем. Обратимое действие должно хранить достаточно данных для восстановления состояния. Для внешних процессов точная отмена часто невозможна: применяется отдельная компенсирующая операция, которая сама может завершиться ошибкой. Цена паттерна — дополнительные типы или вызываемые объекты, история и необходимость управлять временем жизни получателей.
14.2. Классический пример: редактор с Undo и Redo
Команда Insert знает позицию и вставленный текст; History хранит выполненные и отменённые команды. При новом действии ветка redo очищается. Перед перемещением команды в другой стек зарезервировано место, чтобы ошибка выделения памяти не возникла после успешного изменения документа только из-за роста стека.
Каждый листинг — отдельная полная программа на C++23. В Ubuntu или WSL с подходящей версией GCC обычные примеры собираются так:

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

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

Листинг 14.1 (продолжение) — Классический пример: редактор с Undo и Redo

Листинг 14.1 (продолжение) — Классический пример: редактор с Undo и Redo
Документ должен жить дольше истории и её команд, поскольку команды хранят ссылки на него. Изменения в обход истории могут нарушить её предположения; undo проверяет вставленный участок перед удалением. Позиции относятся к байтам строки, а не к символам Unicode. Этот небольшой редактор не реализует файлы, графический интерфейс и совместное редактирование.
Пример вывода:

14.3. Девять вариантов и самостоятельная практика
1. Simple / Fire-and-Forget Command
Задача: отделить решение отправить уведомление от вызова сервиса. Задание: реализовать простую команду электронной почты без отмены.
Полный код — 01_email_command.cpp :

Листинг 14.2 — Девять вариантов и самостоятельная практика
Разбор и ограничения. SendEmail хранит ссылку на получателя и аргументы и вызывает send при выполнении. EmailService только печатает сообщение; реального SMTP и отправки письма нет. Получатель должен существовать до выполнения команды.
Пример вывода:

2. Undoable / Reversible Command
История обратимых команд позволяет восстановить предыдущее форматирование. Задание: изменить начертание диапазона текста и отменить изменение.
Полный код — 02_format_undo.cpp :

Листинг 14.3 — Девять вариантов и самостоятельная практика

Листинг 14.3 (продолжение) — Девять вариантов и самостоятельная практика
Разбор и ограничения. SetBold сохраняет исходные значения диапазона при первом исполнении, затем может восстановить их. История владеет командой через unique_ptr. Длина content и массива стилей должна оставаться согласованной; документ нельзя изменять в обход команды, пока её история используется. Индексы байтовые, GUI не реализован.
Пример вывода:

3. Compensating Command
Когда фактическая отмена невозможна, бизнес-процесс выполняет встречное действие. Задание: компенсировать бронирование отеля и оплату.
Полный код — 03_hotel_compensation.cpp :

Листинг 14.4 — Девять вариантов и самостоятельная практика
Разбор и ограничения. Пример моделирует резервирование и оплату двумя флагами. undo отменяет бронь и моделирует возврат; повторная компенсация не меняет итог. Настоящая Saga требует устойчивого журнала, идемпотентных внешних вызовов, повторов и обработки ситуации, когда отмена брони или возврат денег завершились ошибкой.
Пример вывода:

4. Macro / Composite Command
Группа команд может исполняться как одно действие клиента. Задание: запустить игровую сессию и отменить её шаги в обратном порядке.
Полный код — 04_game_macro.cpp :

Листинг 14.5 — Девять вариантов и самостоятельная практика

Листинг 14.5 (продолжение) — Девять вариантов и самостоятельная практика
Разбор и ограничения. Macro отслеживает число успешно завершённых шагов и при ошибке expected отменяет их в обратном порядке. Все операции в примере — изменения флагов. Это не универсальная транзакция: исключение из execute, невозвратимый побочный эффект или ошибка компенсации потребовали бы другой политики.
Пример вывода:

5. Queued / Transactional Job Command: PDF-отчёт
Длительную генерацию отчёта можно передать фоновому работнику. Задание: сериализовать параметры команды и сформировать PDF через потокобезопасную очередь.
Полный код — 05_pdf_job.cpp :

Листинг 14.6 — Девять вариантов и самостоятельная практика

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

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

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

Листинг 14.6 (продолжение) — Девять вариантов и самостоятельная практика
Запуск: ./example report.pdf. Файл будет создан или перезаписан. Для проверки можно выполнить pdfinfo report.pdf и pdftotext report.pdf -.
Разбор и ограничения. Путь и заголовок кодируются в двоичную последовательность с длинами; работник декодирует её и формирует настоящий одностраничный PDF с таблицей xref. future переносит результат или ошибку вызывающему. Очередь хранится только в памяти и не является долговечной или транзакционной. Поддерживаются печатаемые ASCII-заголовки, один встроенный шрифт и одна страница; программа не является полноценной библиотекой PDF.
Пример вывода:

6. Closure / Lambda Command
Функциональные объекты позволяют обойтись без отдельного класса для каждого действия. Задание: очередь команд на std::move_only_function.
Полный код — 06_function_queue.cpp :

Листинг 14.7 — Девять вариантов и самостоятельная практика
Разбор и ограничения. Первая лямбда владеет unique_ptr, поэтому её нельзя скопировать в обычный std::function; move_only_function допускает такую команду. Очередь здесь однопоточная. Если команда выбросит исключение, выполнение цикла прервётся.
Пример вывода:

7. Command + Separate Handler: CQRS
Команда может быть только структурой данных, а её обработка — обязанностью отдельного класса. Задание: команда создания пользователя и обработчик.
Полный код — 07_cqrs_user.cpp :

Листинг 14.8 — Девять вариантов и самостоятельная практика
Разбор и ограничения. Обработчик проверяет пустое и повторное имя. Это небольшая иллюстрация разделения команды и обработчика, а не полная архитектура CQRS: постоянного хранилища, отдельной модели чтения и распределённых событий здесь нет.
Пример вывода:

8. Active Object: безопасная очередь базы данных
Клиенты передают запросы в очередь объекта, а выделенный поток последовательно выполняет операции. Задание: реализовать Active Object для базы данных.
Полный код — 08_active_database.cpp :

Листинг 14.9 — Девять вариантов и самостоятельная практика

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

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

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

Листинг 14.9 (продолжение) — Девять вариантов и самостоятельная практика
Для Ubuntu / WSL установите libsqlite3-dev, затем соберите: g++ -std=c++23 -Wall -Wextra -Wpedantic -pthread example.cpp -lsqlite3 -o example. Запуск: ./example demo.sqlite. Программа создаёт или изменяет таблицу records в указанной базе.
Разбор и ограничения. Пример действительно создаёт таблицу SQLite, записывает и читает значение параметризованными запросами. Команды содержат promise, а ошибки SQL возвращаются через соответствующий future. Одно соединение используется работником последовательно и уничтожается после его завершения. Это не пул соединений и не распределённая база; встроенный NUL в текстовом параметре отклоняется.
Пример вывода:

9. Idempotent Command: проведение платежа
Повторная доставка одной команды не должна повторять действие. Задание: обработать платёж по уникальному ключу и обнаружить конфликт повторного использования.
Полный код — 09_idempotent_payment.cpp :

Листинг 14.10 — Девять вариантов и самостоятельная практика

Листинг 14.10 (продолжение) — Девять вариантов и самостоятельная практика
Разбор и ограничения. Мьютекс объединяет проверку ключа и изменение модели суммы; повтор с той же суммой возвращает прежний статус, а повтор с другой суммой отклоняется. UUID-подобная строка задаётся вызывающей стороной и здесь не проверяется на формат или уникальность. Это модель в памяти: после перезапуска сведения теряются, денежный перевод не производится. Для настоящего платежа ключ и операция должны фиксироваться атомарно и долговечно.
Пример вывода:

14.4. Классическая практика: умный дом
Пульт с отменой
Задание: выполнить действие над устройством через команду и восстановить предыдущее состояние при отмене.
Полный код — 10_smart_home.cpp :

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

Листинг 14.11 (продолжение) — Классическая практика: умный дом
Разбор и ограничения. Пульт хранит историю команд, а LampOn запоминает состояние лампы до включения. Устройство моделируется флагом; реальные сети, ошибки устройств и повторные нажатия с сохранением истории после перезапуска отсутствуют.
Пример вывода:

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