Le patron de conception Adapter en Python
Dans cette leçon, vous allez utiliser le patron Adapter pour brancher une ancienne classe, dotée d'une autre interface, sur un code qui attend une nouvelle interface.
Introduction
Le problème
Vous devez souvent utiliser du code que vous ne pouvez pas modifier, comme un ancien système de paiement ou une bibliothèque tierce, dont les méthodes ne correspondent pas à ce qu'attend le reste du programme. Réécrire chaque appelant est risqué. Un adaptateur traduit entre les deux.
Imaginez-le ainsi
Un adaptateur est comme un adaptateur de prise de voyage. La prise de votre ordinateur s'adapte à vos prises à la maison, et celles de l'hôtel ont une autre forme. L'adaptateur se place entre les deux, donc ni l'ordinateur ni le mur n'ont à changer.
gateway.pay(25)🔌 Votre prise : payer en dollarsPaymentAdapter🔁 L'adaptateur de voyage entre les deuxround(dollars * 100)💱 Convertir les dollars en centimesmake_payment(cents)🧱 L'ancienne prise murale : veut des centimesLe pattern Adapter enveloppe un objet à l'interface incompatible dans une classe qui offre l'interface attendue par le client et traduit chaque appel.
Points clés
LegacyGatewayn'offre quemake_payment(cents).PaymentAdapteroffrepay(dollars), la méthode que le reste du programme veut appeler.round(dollars * 100)convertit les dollars en centimes avant d'appelermake_payment.gateway.pay(25)fonctionne sans rien changer àLegacyGateway.
Quand l’utiliser ?
- Utiliser du code ancien ou tiers derrière l'interface attendue par votre programme.
- Passer d'un fournisseur à l'autre, comme des services de paiement ou d'e-mail, sans changer les appelants.
- Convertir des unités ou des formats de données à la frontière.
Quand s'en passer
- Vous possédez les deux côtés et pouvez simplement renommer ou modifier l'un d'eux.
- Les interfaces diffèrent tant que l'adaptateur contiendrait l'essentiel de la logique : repensez plutôt la frontière.
Code d’exemple
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))
Résultat de l’exécution
PAY 25.00
Explication du code
La classe LegacyGateway ne propose que la méthode make_payment(), qui attend un montant en centimes, alors que le nouveau code veut appeler pay(). La classe PaymentAdapter enveloppe LegacyGateway et traduit l'appel pay() en make_payment() avec la bonne unité, d'où le résultat PAY 25.00.
Modifiez les valeurs et exécutez le programme avec le compilateur Python en ligne CodeUtility, sans installation locale.
Exercices d’approfondissement
Essayez de modifier le code en suivant les pistes ci-dessous. Changer le code et observer le résultat vous fera bien mieux comprendre la leçon que la simple lecture.
- Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
- Comparez le pattern à une implémentation plus simple et expliquez les compromis.
- Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
Erreurs fréquentes
Oublier de convertir les valeurs
Renommer seulement la méthode envoie des dollars là où des centimes sont attendus.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
def pay(self, dollars):
return self.gateway.make_payment(round(dollars * 100))
Leçon terminée ?
Marquez-la comme apprise pour suivre votre progression.
S'entraîner avec un défi
Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.
Tous les défis