Паттерн проектирования Adapter в Python
В этом уроке вы с помощью паттерна Adapter подключите старый класс с другим интерфейсом к коду, который ожидает новый интерфейс.
Введение
Какую задачу это решает
Часто приходится использовать код, который нельзя изменить, например старую платёжную систему или стороннюю библиотеку, методы которой не совпадают с тем, чего ждёт остальная программа. Переписывать весь вызывающий код рискованно. Adapter (адаптер) служит переводчиком между ними.
Пример из жизни
Adapter похож на дорожный переходник для вилки. Вилка ноутбука подходит к домашним розеткам, а розетки в отеле другой формы. Переходник вставляется между ними, и не нужно менять ни ноутбук, ни розетку в стене.
gateway.pay(25)🔌 Ваша вилка: оплата в долларахPaymentAdapter🔁 Переходник посерединеround(dollars * 100)💱 Перевести доллары в центыmake_payment(cents)🧱 Старая розетка: ей нужны центыШаблон Adapter оборачивает объект с несовместимым интерфейсом в класс с тем интерфейсом, которого ждёт клиентский код. Этот класс переводит каждый вызов.
Главное
- У
LegacyGatewayесть толькоmake_payment(cents). PaymentAdapterдаёт методpay(dollars), который и хочет вызывать остальная программа.round(dollars * 100)переводит доллары в центы перед вызовомmake_payment.gateway.pay(25)работает, вообще не меняяLegacyGateway.
Когда это нужно?
- Использование старого или стороннего кода за интерфейсом, которого ждёт ваша программа.
- Переключение между поставщиками, например платёжных или почтовых сервисов, без изменения вызывающего кода.
- Перевод единиц или форматов данных на границе.
Когда это не нужно
- Обе стороны ваши, и одну из них можно просто переименовать или изменить.
- Интерфейсы так сильно различаются, что в адаптере окажется большая часть логики: лучше перепроектировать границу.
Пример кода
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.
Упражнения для практики
Попробуйте изменить код по подсказкам ниже. Если менять код и смотреть на результат, урок запомнится гораздо лучше, чем при простом чтении.
- Замените предметную область примера, сохранив структуру паттерна.
- Сравните паттерн с более простой реализацией и объясните компромиссы.
- Напишите тесты для каждого участника перед добавлением новой реализации.
Частые ошибки
Забыли пересчитать значения
Если только переименовать метод, туда, где ждут центы, уйдут доллары.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
def pay(self, dollars):
return self.gateway.make_payment(round(dollars * 100))
Закончили этот урок?
Отметьте его как изученный, чтобы следить за прогрессом.
Попрактикуйтесь на задаче
Примените материал этого урока к реальной задаче. Каждая задача запускается в браузере, с мгновенными тестами и разбором от ИИ.
Все задачи