سرفصل‌ها درس 68 از 148 · رابط‌های برنامه‌نویسی که هیچ‌کس نمی‌تواند از آن‌ها سوءاستفاده کند
رابط‌های برنامه‌نویسی که هیچ‌کس نمی‌تواند از آن‌ها سوءاستفاده کند

ایالات را صریح کنید

چرا اهمیت دارد ابجه‌هایی با چرخهٔ عمر (اتصالات، فایل‌ها، تراکنش‌ها، پرداخت‌ها) جایی هستند که «روی دستگاه من کار می‌کرد» در آن رخ می‌دهد. یک فراخوانی در ترتیب اشتباه باید همان‌جا با خطا مواجه شود، نه اینکه بعداً چیزی را خراب کند.

شما در حال پیاده‌سازی یک لایهٔ روکش (wrapper) برای انتقال شبکه هستید تا سایر اعضای تیم بتوانند از آن استفاده کنند. خودِ مکانیزم انتقال سطح پایینی است: connect(), write(data), disconnect()، و هر کاری را که به آن گفته شود انجام می‌دهد. بررسی پس از وقوع حادثه در سه‌ماهه گذشته نشان داد که یک وظیفه پس از بسته شدن داده ارسال کرده و بی‌صدا به سرور اشتباه دوباره متصل شده است. لایه پوششی شما باید این کار را غیرممکن سازد.

ماشین حالت: مجموعه‌ای کوچک از حالت‌ها (جدید، باز، بسته) و فراخوانی‌های مجاز در هر یک. هر چیز دیگری رد می‌شود.

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 حمایت (در ورود باز، در خروج بسته حتی اگر بلوک بالا رود). آنها آن را «حمل‌ونقل» می‌نامند. connect(), write(data) و disconnect().

اسکریپت‌های سوءاستفاده مخفی هر یک از این موارد را امتحان خواهند کرد. هر کدام باید در تماس نادرست خطا تولید کنند، قبل از اینکه هیچ چیزی به ترانسپورت برسد:

  • RuntimeError (یا یک زیرکلاس): ارسال یا بستن قبل از باز کردن؛ باز کردن دوبار؛ ارسال، بستن یا باز کردن دوباره پس از بستن (یک اتصال بسته شده پایان یافته است؛ یکی جدید بسازید)؛ ارسال پس از یک with block;
  • TypeError: ارسال هر چیزی که از نوع بایت‌ها نیست (bytes یا bytearray). رشته‌ها را برای فراخواننده رمزگذاری نکنید.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.