Адаптер. Паттерн GoF на Python, C++23, Rust и Java - читать онлайн бесплатно, автор Алексей Примак, ЛитПортал
Настройки чтения
Размер шрифта
Высота строк
Поля

Адаптер. Паттерн 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 останется прежним.

Конец ознакомительного фрагмента.

Текст предоставлен ООО «Литрес».

Прочитайте эту книгу целиком, купив полную легальную версию на Литрес.

Безопасно оплатить книгу можно банковской картой Visa, MasterCard, Maestro, со счета мобильного телефона, с платежного терминала, в салоне МТС или Связной, через PayPal, WebMoney, Яндекс.Деньги, QIWI Кошелек, бонусными картами или другим удобным Вам способом.

Вы ознакомились с фрагментом книги.
Приобретайте полный текст книги у нашего партнера: