Czytaj książkę: «Декоратор. Паттерн GoF на Python, C++23, Rust и Java»

Czcionka:

Введение

Эта книга посвящена одному паттерну проектирования — Декоратор (Decorator). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.

Как читать

Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.

Глава 9. Реализация на Python

9.1. Зачем нужен декоратор

Есть класс, который читает данные из источника. Иногда данные нужно сжимать, иногда шифровать, иногда журналировать каждое обращение, а иногда — всё вместе в разном порядке. Наследование здесь не годится: CompressedEncryptedLoggedSource — тупик, а число сочетаний растёт экспоненциально.

Декоратор оборачивает объект другим объектом с тем же интерфейсом. Обёртка делает что-то до или после вызова и передаёт работу внутреннему объекту. Обёртки можно вкладывать друг в друга, как матрёшки, собирая нужную комбинацию во время работы.

В Python есть встроенный синтаксис @decorator для функций и классов. Это не совсем то же самое, что паттерн GoF: синтаксис оборачивает функцию при определении, а паттерн — объект во время работы. Но идея общая — добавить поведение, не меняя исходный код, — и в этой главе мы используем оба инструмента.

9.2. Участники и схема



Component — общий интерфейс.

Concrete Component — базовый объект.

Decorator — хранит ссылку на компонент и реализует тот же интерфейс.

Concrete Decorator — добавляет поведение.

9.3. Классический пример: сжатие и шифрование

Файл 01_data_source.py :




Листинг 9.1 — Классический пример: сжатие и шифрование




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

Разбор. Цепочка Encryption(Compression(raw)) при записи сначала шифрует, затем сжимает, а при чтении разворачивает в обратном порядке. Клиент работает с source через обычный интерфейс write/read. Порядок обёрток важен: шифрованные данные похожи на случайные и почти не сжимаются, поэтому правильно сначала сжимать, а потом шифровать. В нашем примере XOR с одним байтом сохраняет повторы, и сжатие всё равно работает, но с настоящим шифром так не будет — это повод поменять обёртки местами.

9.4. Декоратор-функция в Python

Синтаксис @ — самый частый способ добавить поведение к функции.

Файл 02_function_decorators.py :




Листинг 9.2 — Декоратор-функция в Python




Листинг 9.2 (продолжение) — Декоратор-функция в Python

Разбор. retry(times=3, …) — фабрика декораторов: сначала вызывается с параметрами и возвращает собственно декоратор. Декораторы применяются снизу вверх: fetch = timed(retry(…)(fetch)), поэтому timed замеряет все три попытки как один вызов. functools.wraps переносит имя, документацию и другие атрибуты исходной функции на обёртку — без него fetch.__name__ был бы «wrapper». Блок finally гарантирует замер даже при исключении.

9.5. Модификации паттерна

Динамический декоратор через __getattr__

Если у обёрнутого объекта много методов, а менять нужно один-два, писать делегирование для каждого утомительно. __getattr__ перенаправит всё остальное автоматически.

Файл 03_getattr_decorator.py :



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




Листинг 9.3 (продолжение) — Модификации паттерна

Разбор. __getattr__ вызывается только для атрибутов, которых нет у самой обёртки, поэтому log и _inner берутся напрямую, а всё остальное — у счёта. Методы оборачиваются на лету, обычные атрибуты (balance) возвращаются как есть. Цена удобства — менее явный интерфейс: инструменты автодополнения и проверки типов не видят методов обёртки.

Кеширующий декоратор и потокобезопасность

Файл 04_cache_decorator.py :




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




Листинг 9.4 (продолжение) — Модификации паттерна

Разбор. Восемь потоков одновременно запрашивают курсы, но источник опрашивается ровно трижды — по разу на валюту. Отдельная блокировка на каждую валюту не даёт двум потокам одновременно пойти за одним курсом и при этом не мешает параллельно получать разные валюты. Для чистых функций стандартная библиотека предлагает готовый декоратор functools.lru_cache: он превращает экспоненциальную рекурсию Фибоначчи в линейную.

9.6. Самостоятельные работы

Работа 1. Конвейер обработки текста

Задание. Базовый объект возвращает текст. Декораторы: обрезка пробелов, замена запрещённых слов, ограничение длины. Соберите разные цепочки.

Полное решение — файл 05_text_pipeline.py :



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




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

Разбор. Последние две строки показывают, что порядок декораторов меняет результат: если обрезать до сжатия пробелов, в 20 символов попадает мусор из пробелов, и слов остаётся меньше.

Работа 2. Декоратор класса

Задание. Напишите декоратор @frozen_after_init, который запрещает менять атрибуты объекта после конструктора.

Полное решение — файл 06_class_decorator.py :




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

Разбор. Декоратор класса получает класс и возвращает его, подменив методы. Внутри конструктора атрибуты устанавливаются свободно, потому что флага _frozen ещё нет. Сам флаг ставится через object.__setattr__, чтобы обойти собственную проверку. Для таких задач стандартная библиотека предлагает @dataclass(frozen=True).

9.7. Типичные ошибки

Забытый functools.wraps. Обёртка теряет имя, документацию и сигнатуру исходной функции — это ломает отладку и документацию.

Неверный порядок обёрток. Шифрование до сжатия, обрезка до очистки — результат формально работает, но хуже.

Проверка isinstance на обёрнутый объект. isinstance(Audited(acc), Account) ложно; декоратор меняет тип объекта. Опирайтесь на протоколы.

Кеш без ограничения. lru_cache(maxsize=None) для функции с бесконечным множеством аргументов — утечка памяти.

9.8. Вопросы для самопроверки

Чем декоратор лучше наследования для комбинирования поведения?

Чем синтаксис @ отличается от паттерна GoF?

В каком порядке применяются несколько декораторов @?

Зачем нужен functools.wraps?

Как устроена фабрика декораторов с параметрами?

Когда вызывается __getattr__?

Почему в примере с курсами нужна блокировка на каждую валюту?

Почему важен порядок сжатия и шифрования?

9.9. Ответы

Комбинации собираются во время работы, без отдельного класса на каждое сочетание.

@ оборачивает функцию или класс при определении; паттерн оборачивает объекты во время работы.

Снизу вверх: ближайший к функции применяется первым.

Чтобы обёртка сохранила имя, документацию и другие метаданные исходной функции.

Внешняя функция принимает параметры и возвращает декоратор, который принимает функцию.

Только когда атрибут не найден обычным способом.

Чтобы два потока не запросили одну валюту дважды, но разные валюты загружались параллельно.

Зашифрованные данные выглядят случайными и не сжимаются; сжимать нужно до шифрования.

Глава 9. Реализация на C++23

9.1. Дополнительное поведение без взрыва подклассов

Представим запись данных в файл. В одном случае нужно только записать данные, в другом — сжать их, в третьем — сжать и зашифровать. Отдельный подкласс для каждой комбинации быстро увеличит число классов и затруднит добавление нового поведения.

Decorator оборачивает объект и предоставляет тот же интерфейс. При вызове он выполняет дополнительную работу и делегирует операцию вложенному компоненту. Несколько обёрток можно соединить в цепочку во время выполнения. В классической реализации декоратор и компонент наследуют общий интерфейс; дополнительное поведение при этом добавляется оборачиванием, без создания подкласса для каждой комбинации конкретного компонента.

Decorator входит в структурные паттерны GoF. Его удобно применять, когда нужны независимо комбинируемые обязанности. За гибкость платят дополнительными объектами, передачей вызовов, необходимостью управлять временем жизни и учитывать порядок обёрток.

9.2. Роли и схема

Component объявляет операции, доступные клиенту.

ConcreteComponent выполняет базовую работу.

Decorator хранит компонент и поддерживает тот же интерфейс.

ConcreteDecorator добавляет поведение до, после или вместо части вызова.



Клиент может передавать готовую цепочку через общий интерфейс. При std::unique_ptr каждая обёртка единолично владеет следующим объектом, а разрушение внешней обёртки освобождает всю цепь.

Отличие от Adapter: декоратор обычно сохраняет интерфейс и расширяет поведение; адаптер согласует несовместимые интерфейсы. Отличие от Proxy: прокси в первую очередь контролирует доступ к объекту, хотя конкретная обёртка может сочетать обе роли.

9.3. Порядок и границы ответственности

Порядок обёрток важен. Сжатие до шифрования обычно имеет смысл, тогда как шифротекст трудно сжать. При обратной обработке сначала проверяют и расшифровывают данные, затем распаковывают их. В отдельных протоколах совместное сжатие секретных и контролируемых атакующим данных может раскрывать информацию через длину; допустимость сжатия зависит от угроз и протокола.

Декоратор не делает код автоматически безопасным и не защищает разделяемые данные, если в нём нет соответствующей синхронизации. Для ошибок и частичной записи необходимо определить договор каждого слоя.

9.4. Классический пример: сжатие, шифрование и файл

Следующая программа использует реальные zlib и OpenSSL: данные сжимаются, затем шифруются AES-256-GCM и записываются в файл. Для демонстрации она читает файл обратно, проверяет тег аутентичности, расшифровывает и распаковывает данные. Sink — общий интерфейс, FileSink — компонент, остальные классы — декораторы.

Программе нужен путь выходного файла; существующий файл с этим именем будет перезаписан. Пример создаёт случайный ключ в оперативной памяти на один запуск и не сохраняет его. Это не готовый формат долговременного хранения: управление ключами, их защита и безопасное уничтожение отдельно не реализованы. Демонстрация обрабатывает один небольшой блок целиком, а не поток произвольной длины.



Листинг 9.1 — Классический пример: сжатие, шифрование и файл




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




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




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



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




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




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

Сборка в Ubuntu / WSL:




Разбор. CompressSink записывает длину и сжимает входной блок, EncryptSink создаёт случайный nonce, шифрует результат AES-256-GCM и добавляет тег, а FileSink пишет пакет в файл. Магическая метка также передаётся как аутентифицируемые дополнительные данные. unique_ptr и пользовательские удалители освобождают цепочку и контексты OpenSSL.

При чтении decrypt проверяет тег до передачи данных в decompress, а распаковка ограничивает размер результата. В тесте изменение шифротекста приводит к ошибке проверки. Ключ для демонстрации генерируется заново и не сохраняется; формат не является готовой системой хранения ключей или потоковым шифрованием. Комбинирование сжатия с секретами и данными атакующего требует отдельной оценки утечек по длине.

Вывод: Round trip: true.

9.5. Девять разновидностей и связанных подходов

1. Classic GoF Wrapper Decorator

Общий интерфейс поддерживается как базовым компонентом, так и обёртками. Вложенный объект хранится, например, через unique_ptr. Порядок построения цепи определяет порядок преобразований. Работа 1 повторяет полностью рабочий пример zlib и AES-GCM.

2. Single-Method / Functional Decorator

Функция высшего порядка возвращает новую функцию, которая вызывает исходную и добавляет измерение или журналирование. Работа 2 принимает вызываемый объект с произвольной подходящей сигнатурой; состояние времени передаётся отдельно, а исходный объект может быть перемещаемым.

3. Language / Syntactic Decorator

Шаблонная обёртка или макрос может сделать применение дополнительного поведения более декларативным. Стандартные атрибуты C++23 сами по себе не являются универсальным механизмом перехвата функций, подобным декораторам некоторых других языков. Работа 3 оборачивает вызов и переводит исключение в expected.

4. Middleware / Pipeline Decorator

Промежуточный слой получает запрос и следующую функцию. Он может остановить запрос или вызвать следующий слой, а затем выполнить действия после него. Работа 4 показывает структуру проверки с учебной функцией валидации; настоящая проверка токенов должна быть реализована соответствующим безопасным компонентом.

5. Aspect / AOP Weaver Decorator

Сквозное поведение, например аудит, можно вынести в обёртку вокруг бизнес-операции. Это не означает, что стандартный C++ автоматически внедряет аспект во все вызовы: точку оборачивания нужно определить явно или использовать внешние средства. Работа 5 показывает шаблонный аудит.

6. Forwarding Wrapper

Обёртка может предоставлять ограниченный безопаснее сформулированный интерфейс существующего объекта без виртуальной иерархии. Работа 6 принимает span на буфер и проверяет границы, но не владеет памятью и не продлевает её жизнь.

7. Mixin / Trait Decorator

Шаблонное наследование позволяет собрать цепочку обёрток при компиляции. Работа 7 комбинирует префикс и счётчик вызовов. Такая схема не обеспечивает выбор произвольной цепочки во время выполнения без дополнительных механизмов.

8. Skin vs. Guts — Decorator и Strategy

Внешний декоратор добавляет поведение вокруг объекта, а Strategy подменяет алгоритм внутри него. Работа 8 соединяет журналирование и стратегию обработки пикселей. Границы между идеями зависят от контракта конкретной программы.

9. Transparent / Dynamic Proxy Decorator

Прокси может перехватывать доступ и добавлять кэширование, журналирование или другие функции. В C++23 нет стандартного универсального рефлексивного прокси для произвольных методов, поэтому интерфейс нужно описать явно либо применять генерацию кода и специальные библиотеки. Работа 9 кэширует конкретную операцию сервиса.

9.6. Сочетания и многопоточность

Synchronized / Thread-Safe Wrapper — Decorator + Proxy

Обёртка управляет доступом к внутреннему контейнеру. В работе 11 shared_mutex допускает совместные чтения и исключительную запись. Метод чтения возвращает копию значения: нельзя безопасно выдавать ссылку на элемент и отпускать блокировку без дополнительного договора времени жизни.

Circuit Breaker — Proxy + State + Decorator

Предохранитель прерывает вызовы после серии ошибок, ждёт заданный интервал и допускает ограниченное пробное обращение. Работа 12 синхронизирует состояния Closed, Open и Half-Open и не позволяет устаревшему результату закрыть новую открытую цепь. Таймаут самой сетевой операции должен обеспечивать вызываемый транспорт.

Pipeline / Fan-Out / Fan-In

Несколько работников могут параллельно обрабатывать входные элементы и складывать результаты в другую очередь. Работа 13 использует условные номера кадров, а не кодек или реальный видеопоток. Очереди учебные и не имеют ограничений размера.

Extension Object / Role Object

Роли Loggable и Auditable можно добавлять объекту через реестр, не оборачивая его во все возможные статические комбинации. Работа 14 демонстрирует динамическое назначение ролей; это отдельный приём, который может сочетаться с декораторами.

Interceptor

Перехватчики предоставляют точки до вызова, после него и при исключении. Работа 15 регистрирует журналирование и учебную проверку доступа. Пример не является сетевым сервером и не заменяет реальную систему аутентификации.

Ambassador — Remote Proxy + Decorator

Локальный процесс может принимать ограниченный запрос и выполнять исходящий вызов к удалённому сервису, централизуя TLS и повторы. Работа 16 содержит полноценный учебный POSIX/WSL-процесс: соединение с удалённой стороной использует взаимный TLS, проверяет CA и имя сервера и повторяет некоторые транспортные ошибки. Код намеренно обрабатывает только один локальный запрос GET /, а не полный HTTP-протокол.

9.7. Практические работы с полным кодом

Каждая программа ниже самостоятельна. Обычные примеры можно собрать так:



Работы 1 и 16 требуют OpenSSL; работа 1 дополнительно требует zlib. Работа 16 использует POSIX-сокеты и предназначена для Linux/WSL. Для них приведены отдельные команды.

1. Classic GoF Decorator: сжатие и шифрование

Задание. Создайте цепочку сжатия и шифрования поверх файлового потока.

Полное решение — 00_crypto_compress.cpp :




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




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




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




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




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




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

Darmowy fragment się skończył.

Ograniczenie wiekowe:
0+
Data wydania na Litres:
18 listopada 2026
Data napisania:
2026
Objętość:
168 str. 197 ilustracji
Właściciel praw:
Автор
Format pobierania: