Programma Les 68 van 148 · API's die niemand misbruikt
API's die niemand misbruikt

Maak toestanden expliciet

Waarom dit ertoe doet Objecten met een levenscyclus (verbindingen, bestanden, transacties, betalingen) zijn waar "het werkte op mijn machine" leeft. Een aanroep in de verkeerde volgorde moet daar direct falen, niet iets later corrumperen.

Je bouwt een netwerktransport voor de rest van het team. Het transport zelf is low level: connect(), write(data), disconnect(), en het doet wat het moet doen. Een postmortem van het vorige kwartaal vond een taak die data verzond na het sluiten en stilletjes opnieuw verbond met de verkeerde server. Je wrapper moet dat onmogelijk maken.

State machine: een kleine set van states (new, open, closed) en de calls die in elk zijn toegestaan. Alles wat anders is wordt geweigerd.

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

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
Jij bent aan de beurt

Schrijf class Connection met __init__(self, transport), open(), send(data), close(), en with ondersteuning (open bij binnenkomst, sluit bij vertrek zelfs als het blok een fout geeft). Ze roepen de connect(), write(data) en disconnect() van de transport aan.

Scripts voor verborgen misbruik zullen elk van deze proberen. Elk moet een fout geven bij de verkeerde aanroep, voordat er iets de transportlaag bereikt:

  • RuntimeError (of een subclass): verzenden of sluiten voor openen; twee keer openen; verzenden, sluiten of opnieuw openen na sluiten (een gesloten verbinding is klaar; maak een nieuwe); verzenden na een with blok;
  • TypeError: stuur alles wat niet bytes-like is (bytes of bytearray). Codeer geen strings voor de aanroeper.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.