Lehrplan Lektion 68 von 148 · APIs, die niemand missbrauchen kann
APIs, die niemand missbrauchen kann

Mache Zustände explizit

Warum das wichtig ist Objekte mit einem Lebenszyklus (Verbindungen, Dateien, Transaktionen, Zahlungen) sind der Ort, an dem "auf meinem Rechner hat es funktioniert" existiert. Ein Aufruf in der falschen Reihenfolge sollte genau dort fehlschlagen und nicht später etwas korrumpieren.

Du bereitest einen Netzwerktransport für den Rest des Teams vor. Der Transport selbst ist Low Level: connect(), write(data), disconnect(), und er tut genau das, was ihm gesagt wird. Eine Postmortem aus dem letzten Quartal fand einen Job, der Daten nach dem Schließen sendete und sich stillschweigend mit dem falschen Server wiederverbindet. Dein Wrapper muss das unmöglich machen.

Zustandsautomat: eine kleine Menge an Zuständen (new, open, closed) und die erlaubten Aufrufe in jedem. Alles andere wird abgelehnt.

c = Connection(transport)
c.open()
c.send(b"hello")
c.close()

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
Du bist dran

Schreibe class Connection mit __init__(self, transport), open(), send(data), close() und with Support (öffnen beim Eintritt, schließen beim Austritt, auch wenn der Block einen Fehler wirft). Sie rufen das connect(), write(data) und disconnect() des Transports auf.

Hidden misuse scripts wird jedes davon versuchen. Jedes muss beim falschen Aufruf auslösen, bevor etwas den Transport erreicht:

  • RuntimeError (oder eine Unterklasse): senden oder schließen vor dem Öffnen; zweimal öffnen; senden, schließen oder nach dem Schließen erneut öffnen (eine geschlossene Verbindung ist beendet; erstelle eine neue); nach einem with Block senden;
  • TypeError: sende alles, was nicht bytes-like ist (bytes oder bytearray). Kodiere keine strings für den Aufrufer.

Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion

Diese Übung öffnet bald

Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.