Silabus Pelajaran 68 dari 148 · API yang tidak bisa disalahgunakan siapa pun
API yang tidak bisa disalahgunakan siapa pun

Buat state jadi eksplisit

Kenapa ini penting Objek dengan lifecycle (koneksi, file, transaksi, pembayaran) adalah tempat di mana "di komputer saya jalan" terjadi. Pemanggilan dalam urutan yang salah harus gagal saat itu juga, bukan merusak sesuatu nantinya.

Kamu membungkus transport jaringan untuk sisa tim. Transport itu sendiri bersifat low level: connect(), write(data), disconnect(), dan ia melakukan apa pun yang diperintahkan. Postmortem dari kuartal lalu menemukan sebuah job yang mengirim data setelah ditutup dan diam-diam menyambung kembali ke server yang salah. Wrapper kamu harus membuat hal itu mustahil.

State machine: sekumpulan kecil state (new, open, closed) dan pemanggilan yang diizinkan di setiap state. Selain itu ditolak.

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

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

Tulis class Connection dengan dukungan __init__(self, transport), open(), send(data), close(), dan with (buka saat masuk, tutup saat keluar meskipun blok memicu error). Mereka memanggil connect(), write(data), dan disconnect() dari transport.

Skrip penyalahgunaan tersembunyi akan mencoba masing-masing dari ini. Setiap skrip harus memicu error pada panggilan yang salah, sebelum apa pun mencapai transport:

  • RuntimeError (atau subclass): kirim atau tutup sebelum buka; buka dua kali; kirim, tutup atau buka lagi setelah tutup (koneksi tertutup sudah selesai; buat yang baru); kirim setelah blok with;
  • TypeError: kirim apa pun yang bukan bytes-like (bytes atau bytearray). Jangan encode string untuk caller.

Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini

Latihan ini akan segera dibuka

Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.