Patrons de conception Python

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.

  • Avancé
  • 2 min de lecture
  • 1 exemple exécutable

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.

De l'adaptateur de voyage au code
gateway.pay(25)🔌 Votre prise : payer en dollars
PaymentAdapter🔁 L'adaptateur de voyage entre les deux
round(dollars * 100)💱 Convertir les dollars en centimes
make_payment(cents)🧱 L'ancienne prise murale : veut des centimes
L'adaptateur traduit l'appel ; aucun des deux côtés ne change.
En une phrase

Le 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

  1. LegacyGateway n'offre que make_payment(cents).
  2. PaymentAdapter offre pay(dollars), la méthode que le reste du programme veut appeler.
  3. round(dollars * 100) convertit les dollars en centimes avant d'appeler make_payment.
  4. 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

Exécuter le code →
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))
Obtenir un bouton Run pour cet exemple

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.

  1. Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
  2. Comparez le pattern à une implémentation plus simple et expliquez les compromis.
  3. Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
Exécuter dans le compilateur Python →

Erreurs fréquentes

Oublier de convertir les valeurs

Renommer seulement la méthode envoie des dollars là où des centimes sont attendus.

Problème
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Correction
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