Read the book: «Адаптер. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Адаптер (Adapter). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 6. Реализация на Python
6.1. Зачем нужен адаптер
Платёжный модуль приложения работает с интерфейсом charge(amount_kopecks) и исключением PaymentError. Новая платёжная библиотека принимает сумму в рублях с плавающей точкой и возвращает числовой код ошибки. Менять библиотеку нельзя, а переделывать под неё всё приложение — плохо.
Адаптер — промежуточный объект, который реализует ожидаемый интерфейс и переводит вызовы в формат адаптируемого компонента. Клиент работает с привычным интерфейсом, компонент не меняется, а вся «перекодировка» сосредоточена в одном месте.
В Python адаптеры повсюду: io.TextIOWrapper адаптирует поток байтов к потоку строк, csv.DictReader — строки CSV к словарям, functools.partial — функцию с одним набором аргументов к другому. Утиная типизация делает паттерн особенно лёгким: адаптеру не нужно наследоваться от интерфейса, достаточно иметь нужные методы.
6.2. Участники и схема

Target — интерфейс, который ожидает клиент.
Adaptee — существующий компонент с несовместимым интерфейсом.
Adapter — реализует Target и обращается к Adaptee.
GoF различает объектный адаптер (хранит адаптируемый объект) и классовый (наследуется от него). В Python возможны оба, но объектный обычно предпочтительнее: он не смешивает интерфейсы двух классов.
6.3. Классический пример: устаревшая платёжная система
Файл 01_object_adapter.py :

Листинг 6.1 — Классический пример: устаревшая платёжная система

Листинг 6.1 (продолжение) — Классический пример: устаревшая платёжная система
Разбор. Адаптер переводит три вещи: единицы (копейки в рубли), типы (int в float) и способ сообщать об ошибках (числовые коды в исключения). Иерархия исключений позволяет клиенту ловить как конкретную ошибку (InsufficientFunds), так и любую платёжную (PaymentError). Неизвестные коды тоже превращаются в исключение — будущие версии библиотеки не сломают приложение молча.
checkout ничего не знает о библиотеке и её кодах. Если банк сменится, понадобится новый адаптер, а checkout останется прежним.
6.4. Адаптер-функция
Если интерфейс состоит из одной функции, адаптер — это тоже функция. Особенно часто так адаптируют обратные вызовы.
Файл 02_function_adapter.py :

Листинг 6.2 — Адаптер-функция

Листинг 6.2 (продолжение) — Адаптер-функция
Разбор. Три адаптера из стандартной библиотеки и одна своя функция. functools.cmp_to_key адаптирует функцию сравнения «вернуть −1, 0, 1» к ключу сортировки, который ожидает sorted. to_handler — замыкание, переводящее интерфейс (level, message) в интерфейс «словарь». functools.partial адаптирует print к другим значениям аргументов по умолчанию.
6.5. Классовый адаптер и адаптер через наследование
Файл 03_class_adapter.py :

Листинг 6.3 — Классовый адаптер и адаптер через наследование

Листинг 6.3 (продолжение) — Классовый адаптер и адаптер через наследование
Разбор. KeyValueStore наследуется от UserDict и добавляет методы нашего интерфейса — это классовый адаптер: объект одновременно является словарём и хранилищем. Удобно, но интерфейс получается «двойным», и клиент может обойти наши методы. ListStore — объектный адаптер: внутренний список скрыт, наружу виден только наш интерфейс. UserDict лучше подходит для наследования, чем dict: методы dict вроде update не вызывают переопределённый __setitem__.
6.6. Модификации паттерна
Адаптер итератора: строки CSV в объекты
Файл 04_iterator_adapter.py :

Листинг 6.4 — Модификации паттерна
Разбор. Цепочка адаптеров: io.StringIO адаптирует строку к файлу, csv.DictReader — файл к потоку словарей, наш генератор records — словари к объектам Record. Генератор ленивый: строки читаются по мере потребления, и огромный файл не попадёт в память целиком.
Адаптер синхронного кода к asyncio
Частая задача: асинхронное приложение должно вызвать старую блокирующую функцию. Если вызвать её напрямую, весь цикл событий остановится. Адаптер переносит вызов в отдельный поток.
Файл 05_async_adapter.py :

Листинг 6.5 — Модификации паттерна
Разбор. asyncio.to_thread выполняет блокирующую функцию в пуле потоков и возвращает объект, который можно ожидать. Три запроса по 0,1 с выполнились параллельно, а не последовательно за 0,3 с. Цикл событий в это время свободен и может обслуживать другие задачи. Синхронный клиент не изменился.
6.7. Самостоятельные работы
Работа 1. Единый интерфейс датчиков
Задание. Система мониторинга ожидает объекты с методом celsius(). Подключите два чужих датчика: один отдаёт Фаренгейты, второй — десятые доли Кельвина. Выведите показания и среднее.
Полное решение — файл 06_sensors.py :

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

Листинг 6.6 (продолжение) — Самостоятельные работы
Разбор. Вся математика пересчёта единиц — в адаптерах. Протокол Thermometer описывает и атрибут name, и метод: оба адаптера ему соответствуют, хотя один хранит имя в экземпляре, а другой — в классе.
Работа 2. Адаптер к файловому интерфейсу
Задание. Чужая библиотека журналирования принимает строки только методом append_line(line). Сделайте адаптер, похожий на файл, чтобы в неё можно было писать стандартной функцией print(…, file=adapter).
Полное решение — файл 07_file_like.py :

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

Листинг 6.7 (продолжение) — Самостоятельные работы
Разбор. print требует от параметра file только метод write — классическая утиная типизация. Адаптер собирает текст до перевода строки и передаёт готовые строки в журнал. Распаковка *complete, self._pending = …split(«\n») отделяет последний незавершённый кусок. Контекстный менеджер гарантирует, что остаток будет дописан при выходе из блока.
6.8. Типичные ошибки
Утечка деталей адаптируемого компонента. Если адаптер возвращает коды ошибок или типы чужой библиотеки, клиент снова от неё зависит.
Адаптер, который меняет смысл. Адаптер переводит формат, но не должен незаметно глотать ошибки или округлять суммы.
Наследование от dict для адаптера. Методы dict не вызывают переопределённые __setitem__/__getitem__; используйте UserDict или композицию.
Блокирующий вызов в асинхронном коде. Синхронную функцию в async def нужно оборачивать в asyncio.to_thread или выполнять в отдельном пуле.
6.9. Вопросы для самопроверки
Чем объектный адаптер отличается от классового?
Почему в Python адаптеру не обязательно наследоваться от интерфейса?
Какие адаптеры есть в functools?
Почему для наследования лучше UserDict, чем dict?
Как генератор помогает адаптировать поток данных без загрузки в память?
Зачем нужен asyncio.to_thread?
Что требуется от объекта, чтобы передать его в print(file=…)?
Почему иерархия исключений удобнее числовых кодов?
6.10. Ответы
Объектный хранит адаптируемый объект и делегирует ему вызовы; классовый наследуется от него и смешивает оба интерфейса.
Утиная типизация: клиенту достаточно, чтобы у объекта были нужные методы.
cmp_to_key (функция сравнения → ключ), partial (другие аргументы), wraps (перенос метаданных обёрнутой функции).
Методы dict вроде update и конструктор не вызывают переопределённые методы подкласса; UserDict написан на Python и вызывает их.
Он обрабатывает элементы по одному по мере потребления.
Чтобы выполнить блокирующую функцию в отдельном потоке и не останавливать цикл событий.
Метод write(str); для надёжности — ещё flush().
Исключения нельзя случайно проигнорировать, их можно ловить по уровню общности и они несут текст ошибки.
Глава 6. Реализация на C++23
6.1. Структурные паттерны
Порождающие паттерны рассматривают создание объектов. Структурные паттерны описывают, как объединять классы и объекты в более крупные структуры и как организовывать их интерфейсы. В GoF к ним относятся Adapter, Bridge, Composite, Decorator, Facade, Flyweight и Proxy.
Композиция и наследование дают разные способы построения структуры. Композиция хранит другой объект или ссылку на него и делегирует работу. Наследование связывает типы на уровне классов и может предоставлять возможность переопределения. Выбор зависит от отношений владения, требуемой подмены и контракта; нельзя считать один механизм автоматически более быстрым или более безопасным во всех программах.
6.2. Несовместимые интерфейсы
Представьте C++-приложение, которое передаёт набор измерений через std::span<const double> и ожидает результат с явной ошибкой. Существующая библиотека принимает указатели и размер массива, а об ошибке сообщает целым числом. Сама библиотека может выполнять нужную операцию, но её интерфейс не совпадает с интерфейсом клиента.
Adapter переводит запросы и результаты между этими интерфейсами. Он может преобразовать аргументы, единицы измерения и формат ошибок. При этом нужно соблюдать правила времени жизни, владения и договор стороннего API: адаптер не исправляет автоматически любые ошибки базовой библиотеки.
6.3. Роли и архитектура
Target — интерфейс, понятный клиенту.
Adaptee — существующий компонент с другим интерфейсом.
Adapter — преобразует вызовы Target в операции Adaptee.
Client — использует Target.
В объектном адаптере Adaptee хранится по значению, ссылке или умному указателю. В классовом адаптере C++ допускает публичное наследование интерфейса Target и закрытое наследование реализации Adaptee. Объектная композиция сама по себе не требует выделения объекта в куче: возможны хранение по значению и невладеющая ссылка. Поэтому выбор класса или объекта нельзя обосновывать только предположением о куче.

6.4. Применимость и ограничения
Адаптер полезен при интеграции существующей библиотеки, замене устаревшего компонента, преобразовании DTO и постепенной миграции между интерфейсами. Он может сохранить клиентский код и локализовать несовместимость. Цена — дополнительный слой и необходимость явно описать преобразования, ошибки и владение.
Похожая внешняя структура встречается и у других паттернов, но намерения различаются. Adapter согласует несовместимые интерфейсы; Decorator добавляет поведение через обёртку; Bridge разделяет абстракцию и реализацию, позволяя им изменяться независимо. В одной программе эти идеи могут сочетаться.
6.5. Классический пример: адаптер C-API аналитики
Ниже сторонний C-совместимый интерфейс моделируется функцией в том же файле C++, чтобы пример можно было собрать без отдельной библиотеки. Адаптер принимает string_view и span, создаёт строку с нулевым завершением и переводит код результата в std::expected.

Листинг 6.1 — Классический пример: адаптер C-API аналитики

Листинг 6.1 (продолжение) — Классический пример: адаптер C-API аналитики
Разбор. std::span представляет массив без владения; вектор в main живёт до завершения вызова. Адаптер проверяет непустое имя, отсутствие внутреннего нулевого байта и наличие измерений. Он создаёт собственную нуль-терминированную строку, потому что произвольный string_view не обязан оканчиваться \0.
Функция старого API вызывается синхронно и не сохраняет переданные адреса. Нулевой код преобразуется в unexpected, успех — в значение expected. Учебный API проверяет конечность чисел и суммы; точность вычисления и договор с настоящей библиотекой нужно оценить отдельно. Если библиотека сохраняет указатель после вызова, время жизни буфера придётся организовать иначе.
Вывод: Average: 20.
6.6. Девять разновидностей и соседних подходов
1. Object Adapter — адаптер объектов
Адаптер реализует целевой интерфейс и содержит Adaptee. Делегирование допускает выбор и замену компонента в зависимости от правил владения. Работа 1 превращает целочисленные микроградусы в DTO с координатами в градусах.
2. Class Adapter — адаптер классов
Адаптер публично наследует Target и закрыто наследует Adaptee, предоставляя нужный интерфейс поверх методов старого класса. В C++ это возможно благодаря множественному наследованию. Такой вариант сильнее связывает классы и не подходит, например, для final-типа Adaptee. Работа 2 адаптирует печать строки.
3. Two-Way Adapter — двустороннее преобразование
Один компонент реализует два интерфейса и переводит данные в обе стороны. Не каждое преобразование обратимо без потерь: важно перечислить поддерживаемые свойства и ошибки. Работа 3 показывает упрощённое сопоставление полей HTTP-запросов; полноценные HTTP/1.1 и HTTP/2 включают существенно больше правил, фрейминг и обработку заголовков.
4. Pluggable Adapter — подключаемые правила
Правило преобразования передаётся объектом-функцией. Оно может меняться без отдельного подкласса под каждую небольшую вариацию. Работа 4 использует std::move_only_function; перед вызовом пустая функция отклоняется.
5. Default / Stub Adapter — адаптер-заглушка
Базовый адаптер предоставляет пустые реализации методов большого интерфейса, чтобы клиент переопределил только интересующие события. Это удобно, но может скрыть забытое обработанное событие. Работа 5 демонстрирует слушатель щелчков.
6. Functional / Closure Adapter — функциональная адаптация
Лямбда или std::bind_front/std::bind_back может приспособить сигнатуру функции к алгоритму. Работа 6 связывает два аргумента трёхаргументной функции и передаёт результат в std::ranges::for_each.
7. Extension Method / Typeclass / Trait Adapter
Типажи, свободные функции и концепты позволяют добавить операцию для внешнего типа без изменения его класса. Это статическое согласование интерфейса; оно не требует виртуальной диспетчеризации. Работа 7 специализирует сериализатор для сторонней структуры.
8. Data / DTO Mapper Adapter
Функция маппинга превращает структуру одного слоя в модель другого, проверяя обязательные значения. Работа 8 переводит условную SQL-запись с optional в доменного пользователя и возвращает ошибки через expected.
9. Anti-Corruption Layer — антикоррупционный слой
ACL защищает доменную модель от терминологии и форматов внешней системы. Он может состоять из нескольких адаптеров, преобразователей и фасадов. Работа 9 переводит код статуса учебной ERP в перечисление домена и отклоняет неизвестный код.
6.7. Сочетания и многопоточная обработка
Half-Sync / Half-Async — Mediator + Adapter + Command
Событийный слой может принимать входящие события, преобразовывать их в команды и передавать через очередь синхронным обработчикам. Работа 11 моделирует поступление двух событий и рабочий поток, который опустошает очередь. Реального асинхронного сетевого ввода-вывода она не реализует; промышленный сервер также должен решить вопросы отмены, перегрузки, ошибок и ограничений очереди.
The free sample has ended.