المنهج الدراسي الدرس 68 من 148 · واجهات برمجة تطبيقات لا يمكن لأحد إساءة استخدامها
واجهات برمجة تطبيقات لا يمكن لأحد إساءة استخدامها

اجعل الحالات صريحة

لماذا هذا مهم الكائنات ذات دورة حياة (الاتصالات، الملفات، المعاملات، المدفوعات) هي المكان الذي تظهر فيه مشكلة "لقد عملت على جهازي". يجب أن يفشل الاستدعاء إذا كان بترتيب خاطئ في تلك اللحظة، وليس أن يتسبب في إتلاف شيء لاحقاً.

أنت تقوم بتغليف وسيلة نقل الشبكة لبقية الفريق. وسيلة النقل نفسها منخفضة المستوى: connect()، write(data)، disconnect()، وهي تنفذ ما يُطلب منها فقط. كشفت مراجعة ما بعد التنفيذ من الربع الأخير عن وظيفة أرسلت بيانات بعد الإغلاق وأعادت الاتصال بالخادم الخطأ بصمت. يجب أن يجعل الغلاف الخاص بك ذلك أمرا مستحيلا.

آلة الحالة: مجموعة صغيرة من الحالات (new, open, closed) والاستدعاءات المسموح بها في كل منها. أي شيء آخر يتم رفضه.

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

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
دورك

اكتب class Connection مع دعم __init__(self, transport) و open() و send(data) و close() و with (فتح عند الدخول، إغلاق عند الخروج حتى لو أثار block خطأ). هي تستدعي connect() و write(data) و disconnect() الخاصة بـ transport.

نصوص إساءة الاستخدام المخفية ستحاول كل واحدة منها. يجب على كل منها إثارة خطأ عند الاستدعاء الخاطئ، قبل وصول أي شيء إلى transport:

  • RuntimeError (أو فئة فرعية): إرسال أو إغلاق قبل الفتح؛ فتح مرتين؛ إرسال، إغلاق أو فتح مرة أخرى بعد الإغلاق (الاتصال المغلق انتهى؛ قم بإنشاء اتصال جديد)؛ إرسال بعد كتلة with؛
  • TypeError: أرسل أي شيء ليس من نوع bytes-like (bytes أو bytearray). لا تقم بتشفير strings للمستدعي.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.