El patrón de diseño Adapter en Python
En esta lección vas a usar el patrón Adapter para conectar una clase antigua, con otra interfaz, a un código que espera una interfaz nueva.
Introducción
El problema
A menudo tienes que usar código que no puedes cambiar, como un sistema de pagos antiguo o una librería de terceros, cuyos métodos no coinciden con lo que espera el resto de tu programa. Reescribir todas las llamadas es arriesgado. Un adapter traduce entre los dos.
Imagínalo así
Un adapter es como un adaptador de enchufe de viaje. El enchufe de tu portátil encaja en los de casa, pero los del hotel tienen otra forma. El adaptador se pone en medio, así no tienen que cambiar ni el portátil ni la pared.
gateway.pay(25)🔌 Tu enchufe: paga en dólaresPaymentAdapter🔁 El adaptador de viaje en medioround(dollars * 100)💱 Convierte dólares a centavosmake_payment(cents)🧱 El enchufe antiguo: quiere centavosEl patrón Adapter envuelve un objeto con una interfaz incompatible en una clase que ofrece la interfaz que espera el cliente y traduce cada llamada.
Puntos clave
LegacyGatewaysolo ofrecemake_payment(cents).PaymentAdapterofrecepay(dollars), el método que el resto del programa quiere llamar.round(dollars * 100)convierte dólares a centavos antes de llamar amake_payment.gateway.pay(25)funciona sin cambiar nada deLegacyGateway.
¿Cuándo se usa?
- Usar código antiguo o de terceros detrás de la interfaz que espera tu programa.
- Cambiar de proveedor, como servicios de pago o de email, sin cambiar a quien llama.
- Convertir unidades o formatos de datos en la frontera.
Cuándo no hace falta
- Los dos lados son tuyos y puedes simplemente renombrar o cambiar uno de ellos.
- Las interfaces son tan distintas que el adapter contendría casi toda la lógica: mejor rediseña la frontera.
Código de ejemplo
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))
Resultado de la ejecución
PAY 25.00
Explicación del código
La clase LegacyGateway solo ofrece el método make_payment(), que espera un importe en céntimos, mientras que el código nuevo quiere llamar a pay(). La clase PaymentAdapter envuelve a LegacyGateway y traduce la llamada pay() a make_payment() con la unidad correcta, de ahí el resultado PAY 25.00.
Cambia los valores y ejecuta el programa en el compilador Python online de CodeUtility sin instalar Python.
Ejercicios de práctica
Prueba a modificar el código siguiendo las ideas de abajo. Cambiar el código y ver el resultado te ayudará a entender la lección mucho mejor que solo leerla.
- Sustituye el dominio del ejemplo conservando la estructura del patrón.
- Compara el patrón con una implementación más sencilla y explica las ventajas y desventajas.
- Escribe pruebas para cada participante antes de añadir otra implementación.
Errores comunes
Olvidar convertir los valores
Renombrar solo el método envía dólares donde se esperan centavos.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
def pay(self, dollars):
return self.gateway.make_payment(round(dollars * 100))
¿Terminaste esta lección?
Márcala como aprendida para seguir tu progreso.
Practica con un reto
Usa lo que cubre esta lección para resolver un problema real. Cada reto se ejecuta en el navegador, con pruebas al instante y una revisión de IA.
Todos los retos