Паттерны проектирования Python

Паттерн проектирования Adapter в Python

В этом уроке вы с помощью паттерна Adapter подключите старый класс с другим интерфейсом к коду, который ожидает новый интерфейс.

  • Продвинутый
  • Чтение: 2 мин
  • Примеров для запуска: 1

Введение

Какую задачу это решает

Часто приходится использовать код, который нельзя изменить, например старую платёжную систему или стороннюю библиотеку, методы которой не совпадают с тем, чего ждёт остальная программа. Переписывать весь вызывающий код рискованно. Adapter (адаптер) служит переводчиком между ними.

Пример из жизни

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

От дорожного переходника к коду
gateway.pay(25)🔌 Ваша вилка: оплата в долларах
PaymentAdapter🔁 Переходник посередине
round(dollars * 100)💱 Перевести доллары в центы
make_payment(cents)🧱 Старая розетка: ей нужны центы
Adapter переводит вызов, а обе стороны остаются как есть.
Одним предложением

Шаблон Adapter оборачивает объект с несовместимым интерфейсом в класс с тем интерфейсом, которого ждёт клиентский код. Этот класс переводит каждый вызов.

Главное

  1. У LegacyGateway есть только make_payment(cents).
  2. PaymentAdapter даёт метод pay(dollars), который и хочет вызывать остальная программа.
  3. round(dollars * 100) переводит доллары в центы перед вызовом make_payment.
  4. gateway.pay(25) работает, вообще не меняя LegacyGateway.

Когда это нужно?

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

Когда это не нужно

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

Пример кода

Запустить код →
main.py
class LegacyGateway:
    # Adapter: wrap an incompatible API with the expected interface.
    def make_payment(self, cents):
        return f"PAY {cents / 100:.2f}"


class PaymentAdapter:
    def __init__(self, gateway):
        self.gateway = gateway

    def pay(self, dollars):
        # Translate both the method name and amount format.
        return self.gateway.make_payment(round(dollars * 100))


gateway = PaymentAdapter(LegacyGateway())
print(gateway.pay(25))
Получить кнопку запуска для этого примера

Результат выполнения

PAY 25.00

Разбор кода

Класс LegacyGateway предлагает только метод make_payment(), который ожидает сумму в центах, а новый код хочет вызывать pay(). Класс PaymentAdapter оборачивает LegacyGateway и переводит вызов pay() в make_payment() с правильной единицей измерения, отсюда результат PAY 25.00.

Измените значения и запустите программу в онлайн-компиляторе Python CodeUtility без локальной установки Python.

Упражнения для практики

Попробуйте изменить код по подсказкам ниже. Если менять код и смотреть на результат, урок запомнится гораздо лучше, чем при простом чтении.

  1. Замените предметную область примера, сохранив структуру паттерна.
  2. Сравните паттерн с более простой реализацией и объясните компромиссы.
  3. Напишите тесты для каждого участника перед добавлением новой реализации.
Запустить в компиляторе Python →

Частые ошибки

Забыли пересчитать значения

Если только переименовать метод, туда, где ждут центы, уйдут доллары.

Ошибка
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Исправление
def pay(self, dollars):
    return self.gateway.make_payment(round(dollars * 100))

Закончили этот урок?

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

Попрактикуйтесь на задаче

Примените материал этого урока к реальной задаче. Каждая задача запускается в браузере, с мгновенными тестами и разбором от ИИ.

Все задачи