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.
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.
gateway.pay(25)🔌 Dein Stecker: zahlt in DollarPaymentAdapter🔁 Der Reiseadapter dazwischenround(dollars * 100)💱 Dollar in Cent umrechnenmake_payment(cents)🧱 Die alte Steckdose: will CentDas Adapter-Muster verpackt ein Objekt mit unpassender Schnittstelle in eine Klasse, die die vom Client erwartete Schnittstelle bietet und jeden Aufruf übersetzt.
Das Wichtigste
LegacyGatewaybietet nurmake_payment(cents).PaymentAdapterbietetpay(dollars), die Methode, die der Rest des Programms aufrufen will.round(dollars * 100)rechnet Dollar in Cent um, bevormake_paymentaufgerufen wird.gateway.pay(25)funktioniert, ohneLegacyGatewayü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
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))
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.
- Ersetze die Beispieldomäne, ohne die Struktur des Patterns zu verändern.
- Vergleiche das Pattern mit einer einfacheren Implementierung und erläutere die Abwägungen.
- Schreibe Tests für jeden Beteiligten, bevor du eine weitere Implementierung hinzufügst.
Häufige Fehler
Werte nicht umrechnen
Nur die Methode umzubenennen schickt Dollar, wo Cent erwartet werden.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
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