Python-Entwurfsmuster

Das Entwurfsmuster Adapter in Python

In dieser Lektion verbindest du mit dem Adapter-Muster eine alte Klasse mit anderer Schnittstelle mit Code, der eine neue Schnittstelle erwartet.

  • Profi
  • 2 Min. Lesezeit
  • 1 ausführbares Beispiel

Einführung

Das Problem

Oft musst du Code verwenden, den du nicht ändern kannst, etwa ein altes Zahlungssystem oder eine Fremdbibliothek, deren Methoden nicht zu dem passen, was der Rest deines Programms erwartet. Jeden Aufrufer umzuschreiben ist riskant. Ein Adapter übersetzt zwischen beiden.

Stell es dir so vor

Ein Adapter ist wie ein Reisestecker-Adapter. Der Stecker deines Laptops passt in deine Steckdosen zu Hause, die Steckdosen im Hotel haben eine andere Form. Der Adapter sitzt dazwischen, sodass weder Laptop noch Wand sich ändern müssen.

Vom Reisestecker zum Code
gateway.pay(25)🔌 Dein Stecker: zahlt in Dollar
PaymentAdapter🔁 Der Reiseadapter dazwischen
round(dollars * 100)💱 Dollar in Cent umrechnen
make_payment(cents)🧱 Die alte Steckdose: will Cent
Der Adapter übersetzt den Aufruf, keine Seite ändert sich.
In einem Satz

Das Adapter-Muster verpackt ein Objekt mit unpassender Schnittstelle in eine Klasse, die die vom Client erwartete Schnittstelle bietet und jeden Aufruf übersetzt.

Das Wichtigste

  1. LegacyGateway bietet nur make_payment(cents).
  2. PaymentAdapter bietet pay(dollars), die Methode, die der Rest des Programms aufrufen will.
  3. round(dollars * 100) rechnet Dollar in Cent um, bevor make_payment aufgerufen wird.
  4. gateway.pay(25) funktioniert, ohne LegacyGateway überhaupt zu ändern.

Wann verwendet man das?

  • Alten oder fremden Code hinter der Schnittstelle verwenden, die dein Programm erwartet.
  • Zwischen Anbietern wechseln, etwa Zahlungs- oder E-Mail-Diensten, ohne die Aufrufer zu ändern.
  • Einheiten oder Datenformate an der Grenze umwandeln.

Wann du es nicht brauchst

  • Beide Seiten gehören dir, und du kannst eine davon einfach umbenennen oder ändern.
  • Die Schnittstellen unterscheiden sich so stark, dass der Adapter die meiste Logik enthalten würde: Gestalte die Grenze lieber neu.

Beispielcode

Code ausführen →
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))
Run-Button für dieses Beispiel erstellen

Ergebnis der Ausführung

PAY 25.00

Erklärung des Codes

Die Klasse LegacyGateway hat nur die Methode make_payment(), die den Betrag in Cent erwartet, während der neue Code pay() aufrufen möchte. Die Klasse PaymentAdapter umschließt LegacyGateway und übersetzt den Aufruf pay() in make_payment() mit der passenden Einheit, deshalb lautet das Ergebnis PAY 25.00.

Ändere die Werte und führe das Programm im CodeUtility Python Online-Compiler aus, ohne Python lokal zu installieren.

Übungen zur Vertiefung

Ändere den Code anhand der folgenden Vorschläge. Wenn du selbst etwas änderst und das Ergebnis beobachtest, verstehst du viel mehr, als wenn du den Code nur liest.

  1. Ersetze die Beispieldomäne, ohne die Struktur des Patterns zu verändern.
  2. Vergleiche das Pattern mit einer einfacheren Implementierung und erläutere die Abwägungen.
  3. Schreibe Tests für jeden Beteiligten, bevor du eine weitere Implementierung hinzufügst.
Im Python-Compiler ausführen →

Häufige Fehler

Werte nicht umrechnen

Nur die Methode umzubenennen schickt Dollar, wo Cent erwartet werden.

Problem
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Lösung
def pay(self, dollars):
    return self.gateway.make_payment(round(dollars * 100))

Lektion fertig?

Markiere sie als gelernt, um deinen Fortschritt zu verfolgen.

Mit einer Challenge üben

Nutze den Inhalt dieser Lektion, um ein echtes Problem zu lösen. Jede Challenge läuft im Browser, mit sofortigen Tests und einem KI-Review.

Alle Challenges