Читать книгу: «Заместитель. Паттерн GoF на Python, C++23, Rust и Java»

Шрифт:

Введение

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

Как читать

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

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

12.1. Зачем нужен заместитель

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

Заместитель — объект, который подменяет настоящий и контролирует доступ к нему. Клиент не замечает подмены: интерфейс тот же. Различают несколько видов заместителей:

виртуальный — откладывает создание дорогого объекта до первого обращения;

защищающий — проверяет права доступа;

удалённый — представляет объект в другом процессе или на другой машине;

кеширующий — запоминает результаты;

журналирующий — записывает обращения.

Устройством заместитель похож на декоратор, но цель другая: декоратор добавляет поведение, а заместитель управляет доступом к объекту и часто сам управляет его жизненным циклом.

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



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

Real Subject — настоящий объект.

Proxy — хранит ссылку на настоящий объект (или способ его получить) и контролирует обращения.

12.3. Виртуальный заместитель

Файл 01_virtual_proxy.py :




Листинг 12.1 — Виртуальный заместитель

Разбор. Сто заместителей почти ничего не весят, а загружены только три изображения, которые реально показали. Повторный показ использует уже загруженный объект. Для простых случаев в Python есть functools.cached_property: атрибут вычисляется при первом обращении и запоминается.

12.4. Защищающий заместитель

Файл 02_protection_proxy.py :




Листинг 12.2 — Защищающий заместитель




Листинг 12.2 (продолжение) — Защищающий заместитель

Разбор. Documents ничего не знает о пользователях: проверки сосредоточены в заместителе. Обычный читатель видит открытые документы, сотрудник отдела кадров — только свой секретный файл, администратор может всё. Заместитель создаётся для конкретного пользователя, поэтому клиентский код не передаёт пользователя в каждый вызов.

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

Кеширующий заместитель с временем жизни

Файл 03_caching_proxy.py :



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




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

Разбор. Заместитель отдаёт сохранённое значение, пока оно моложе 60 секунд. Часы передаются параметром: в рабочем коде это time.monotonic, а в примере — управляемая функция, поэтому поведение детерминировано и его легко тестировать. monotonic выбран не случайно: системное время может перевести пользователь, а монотонные часы идут только вперёд.

Удалённый заместитель через multiprocessing

Удалённый заместитель скрывает, что объект живёт в другом процессе. Стандартная библиотека предлагает это готовым: менеджеры multiprocessing создают объекты в отдельном серверном процессе и выдают клиентам заместителей.

Файл 04_remote_proxy.py :




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

Разбор. manager.Counter() возвращает не Counter, а заместителя AutoProxy[Counter]. Вызов counter.add(…) в дочернем процессе упаковывается, передаётся серверу менеджера, выполняется там над единственным настоящим объектом, а результат возвращается обратно. Процессы пишут в общий счётчик, хотя память у них раздельная. Сервер обрабатывает вызовы к одному объекту последовательно, поэтому данные не портятся.

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

Работа 1. Журналирующий заместитель с ограничением частоты

Задание. Оберните клиента внешнего API заместителем, который журналирует вызовы и не пропускает больше трёх вызовов за окно в 10 условных секунд.

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



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




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

Разбор. Очередь хранит моменты успешных вызовов за последнее окно — это алгоритм «скользящего окна». В момент 10 вызов из момента 0 выпадает из окна, и место освобождается.

Работа 2. Ленивый атрибут

Задание. У отчёта есть дорогое поле stats. Сделайте его ленивым с помощью functools.cached_property и покажите, что расчёт выполняется один раз и сбрасывается удалением атрибута.

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




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

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

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

Заместитель, меняющий смысл. Кеширующий заместитель для данных, которые должны быть свежими, отдаёт устаревшие ответы. Указывайте время жизни.

Системное время для интервалов. time.time() может прыгнуть назад; для измерения интервалов используйте time.monotonic().

Потеря исключений. Заместитель, который ловит все исключения и возвращает None, скрывает ошибки настоящего объекта.

Удалённый вызов как локальный. Каждый вызов удалённого заместителя — передача данных между процессами. Не вызывайте его в плотных циклах по мелочи.

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

Какие виды заместителей вы знаете?

Чем заместитель отличается от декоратора?

Как виртуальный заместитель экономит ресурсы?

Почему часы передаются кеширующему заместителю параметром?

Почему для интервалов лучше time.monotonic()?

Что возвращает manager.Counter() в multiprocessing?

Как работает functools.cached_property?

Зачем защищающему заместителю знать пользователя при создании?

12.9. Ответы

Виртуальный, защищающий, удалённый, кеширующий, журналирующий.

Целью: заместитель управляет доступом и жизненным циклом объекта, декоратор добавляет поведение.

Создаёт дорогой объект только при первом реальном обращении.

Чтобы управлять временем в тестах и получать детерминированное поведение.

Монотонные часы не идут назад при переводе системного времени.

Заместителя AutoProxy, который передаёт вызовы объекту в процессе-сервере.

Вычисляет значение при первом обращении и сохраняет его в __dict__ экземпляра.

Чтобы не передавать его в каждый вызов и не менять интерфейс объекта.

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

12.1. Зачем нужен заместитель

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



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

12.2. Классический пример: ленивый и кэширующий видеоплеер

VideoProxy сохраняет путь, но создаёт RealVideo только при первом play. После этого объект и прочитанные байты остаются в памяти. mutable разрешает инициализировать кэш внутри логически константной операции. Код читает файл целиком и печатает число байтов: декодирование и воспроизведение изображения не реализованы.

Сохраните листинг в example.cpp и запустите:



Команда создания video.dat перезаписывает файл с таким именем в текущей папке.

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




Листинг 12.1 — Классический пример: ленивый и кэширующий видеоплеер




Листинг 12.1 (продолжение) — Классический пример: ленивый и кэширующий видеоплеер

При успешной загрузке следующие вызовы используют тот же объект. Если конструктор выбросит исключение, video_ останется пустым и следующая попытка повторит загрузку. Этот прокси не рассчитан на параллельный первый вызов: проверка и запись video_ не синхронизированы. Он также не обнаруживает изменения файла и удерживает весь его размер в памяти.

Пример вывода:



12.3. Тринадцать вариантов и практика

Каждый листинг является отдельной полной программой. Если не сказано иначе, используйте команду сборки из примера выше. Файловые программы принимают путь в аргументе; сетевые POSIX-примеры запускаются в Linux или WSL.

1. Virtual Proxy: отложенная загрузка текстуры

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

Полный код — 01_lazy_texture.cpp :



Листинг 12.2 — Тринадцать вариантов и практика




Листинг 12.2 (продолжение) — Тринадцать вариантов и практика

Пример запуска: ./example texture.dat. Файл должен существовать.

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

Пример вывода:



2. Remote Proxy: сервис авторизации

Удалённый заместитель прячет упаковку запроса и сетевой обмен за методом authorize. Задание: реализовать клиентский прокси сервиса авторизации с результатом std::expected.

Полный код — 02_remote_auth.cpp :



Листинг 12.3 — Тринадцать вариантов и практика




Листинг 12.3 (продолжение) — Тринадцать вариантов и практика




Листинг 12.3 (продолжение) — Тринадцать вариантов и практика




Листинг 12.3 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. Демонстрационный сервер слушает loopback TCP и отвечает на один запрос простого строкового RPC; прокси проверяет допустимые символы, отправляет запрос и распознаёт ответ. Это реальный сокет, но не gRPC, не промышленный протокол и не реальная система идентификации. Данные идут без TLS; локальный тестовый токен не является безопасным механизмом авторизации. Таймауты чтения и записи не задают общий срок на весь вызов.

Пример вывода:



3. Protection Proxy: операции с файлом

Перед доступом к ресурсу заместитель может проверить полномочия текущей сессии. Задание: ограничить запись в файл по роли и возвращать причину отказа.

Полный код — 03_protected_file.cpp :



Листинг 12.4 — Тринадцать вариантов и практика




Листинг 12.4 (продолжение) — Тринадцать вариантов и практика

Запуск: ./example output.txt. Разрешённый вызов добавит строку в указанный файл.

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

Пример вывода:



4. Smart Reference: подсчёт обращений

Умная ссылка дополняет обычный указатель управлением временем жизни или учётом операций. Задание: обернуть shared_ptr и подсчитать обращения через operator->.

Полный код — 04_smart_pointer.cpp :




Листинг 12.5 — Тринадцать вариантов и практика

Разбор и ограничения. Копии обёртки разделяют счётчик, атомарное увеличение безопасно для параллельных обращений к счётчику. Оно не делает сам Document потокобезопасным. Подсчитываются вызовы operator->, а не все возможные обращения через ранее полученный сырой указатель. При пустом указателе возникает исключение.

Пример вывода:


5. Caching Proxy: математические вычисления

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

Полный код — 05_math_cache.cpp :




Листинг 12.6 — Тринадцать вариантов и практика




Листинг 12.6 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. В примере два запроса 20! приводят к одному обращению к сервису. Ограничение 20 защищает представление uint64_t от переполнения. Факториал здесь мал и служит проверяемым примером, а не демонстрацией значительного ускорения. Кэш не ограничен по размеру и не синхронизирован.

Пример вывода:



6. Synchronization Proxy: контейнер

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

Полный код — 06_sync_vector.cpp :




Листинг 12.7 — Тринадцать вариантов и практика

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

Пример вывода:



7. Logging / Metrics Proxy: задержка вызовов

Измерение времени помогает понять задержку обращения к удалённой службе. Задание: создать обёртку измерения задержек, принимающую сетевую операцию как вызываемый объект.

Полный код — 07_latency.cpp :



Листинг 12.8 — Тринадцать вариантов и практика

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

Пример вывода:



8. Firewall Proxy: структурированные JSON-запросы

Фильтрация перед передачей запроса сервису помогает отклонять неожиданные операции и поля. Задание: проверить структуру JSON и разрешить только чтение.

Полный код — 08_json_firewall.cpp :




Листинг 12.9 — Тринадцать вариантов и практика




Листинг 12.9 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. Принимается намеренно узкое подмножество JSON: объект из двух строковых полей в заданном порядке, ограниченный набор символов и длина. Многие корректные JSON-документы, включая экранированные строки и другой порядок полей, будут отклонены. Это не универсальный JSON-парсер и не полноценный межсетевой экран; для реальных данных применяют проверенную библиотеку, схему и авторизацию.

Пример вывода:


9. Copy-on-Write Proxy: большой массив

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

Полный код — 09_cow_array.cpp :




Листинг 12.10 — Тринадцать вариантов и практика

Разбор и ограничения. Копирование CowArray разделяет shared_ptr<const vector<int>>. При записи создаётся изменяемая копия и публикуется как константная. Здесь копия создаётся на каждую запись, даже если владелец один: это простой неизменяемый снимок, а не оптимизация с проверкой уникальности. Одна и та же обёртка не рассчитана на конкурентные изменения.

Пример вывода:



10. Fallback / Resilient Proxy: тайм-аут

При задержке или ошибке сервиса прокси может вернуть резервный результат. Задание: добавить ожидание с тайм-аутом и запасной ответ.

Полный код — 10_fallback.cpp :




Листинг 12.11 — Тринадцать вариантов и практика




Листинг 12.11 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. Основная операция получает stop_token и добровольно реагирует на отмену. По истечении срока прокси запрашивает остановку и возвращает резервное значение после завершения рабочего потока. Это не жёсткий тайм-аут для произвольного блокирующего API: если операция игнорирует отмену, присоединение потока может затянуться.

Пример вывода:



11. Virtual Mock / Spy: платёжный API

Шпион записывает вызовы, а тестовая подмена позволяет воспроизвести отказ. Задание: проверить порядок и параметры обращений к платёжному интерфейсу.

Полный код — 11_payment_spy.cpp :



Листинг 12.12 — Тринадцать вариантов и практика




Листинг 12.12 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. Шпион сохраняет суммы и может намеренно вернуть ошибку один раз. Реальный платёж не совершается: FakePayment создаёт тестовую квитанцию. Журнал не синхронизирован и предназначен для однопоточного теста.

Пример вывода:



12. Static Proxy: концепт C++23

Шаблонная обёртка выбирает тип получателя при компиляции, а концепт проверяет наличие нужной операции. Задание: реализовать статический прокси-декоратор.

Полный код — 12_static_proxy.cpp :




Листинг 12.13 — Тринадцать вариантов и практика

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

Пример вывода:



13. Dynamic / Runtime Proxy: гетерогенные вызовы

Некоторым приложениям нужно выбирать имя операции и аргументы во время выполнения. Задание: создать динамический перехватчик с гетерогенными значениями.

Полный код — 13_dynamic_proxy.cpp :



Листинг 12.14 — Тринадцать вариантов и практика




Листинг 12.14 (продолжение) — Тринадцать вариантов и практика

Разбор и ограничения. Таблица явно регистрирует допустимые операции, std::any хранит аргументы различных типов, ошибки приводятся к std::expected. Стандарт C++23 не предоставляет универсальной встроенной рефлексии, позволяющей автоматически перечислить и перехватить произвольные методы. Типы проверяются во время выполнения; неверный any_cast приводит к ошибке.

Пример вывода:



12.4. Самостоятельная работа по классическому паттерну

Защищающий и кэширующий прокси базы данных

Задание: проверять права до чтения и не обращаться повторно к сервису за уже полученным значением.

Полный код — 14_db_protected_cache.cpp :




Листинг 12.15 — Самостоятельная работа по классическому паттерну




Листинг 12.15 (продолжение) — Самостоятельная работа по классическому паттерну

Разбор и ограничения. Проверка роли выполняется даже при попадании в кэш, поэтому гость не получает кэшированное значение. Сервис и база моделируются std::map в памяти: SQL, постоянное хранение, аутентификация, обновления и инвалидирование кэша здесь отсутствуют.

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