تعریف ددلاین(deadline) با استفاده از context

Deadline نشان‌دهنده یک زمان مشخص در آینده است که عملیات باید تا قبل از آن تکمیل شود. اگر عملیات تا آن زمان به پایان نرسد، به‌صورت خودکار لغو (cancel) خواهد شد.
در Go می‌توان با استفاده از context.WithDeadline برای یک عملیات زمان پایان مشخصی تعیین کرد.

ایجاد تایم‌اوت(timeout) با استفاده از context

Timeout به مدت زمانی گفته می‌شود که برای انجام یک عملیات در نظر گرفته می‌شود. اگر عملیات در بازه زمانی تعیین‌شده کامل نشود، به‌صورت خودکار متوقف (cancel) می‌شود.

در Go می‌توان با استفاده از context برای یک عملیات محدودیت زمانی ایجاد کرد.

قرار دادن و خواندن مقادیر از Context 

در Go می‌توان با استفاده از context.WithValue یک مقدار را داخل Context ذخیره کرد و سپس از طریق متد Value به آن دسترسی پیدا کرد.

اگرچه context از طریق context.WithValue امکان ذخیره و انتقال مقادیر را فراهم می‌کند، اما طبق توصیه مستندات Go، این قابلیت باید تنها برای داده‌های مرتبط با محدوده یک درخواست (request-scoped data) که بین APIها و گوروتین‌ها جابه‌جا می‌شوند استفاده شود و نباید به‌عنوان جایگزینی برای ارسال پارامترهای معمولی یا نگهداری داده‌های اختیاری در توابع مورد استفاده قرار گیرد.

تغییر ناپذیری (immutable) کانتکست (context)

کانتکست‌ها در Go تغییرناپذیر (immutable) هستند. این بدان معناست که هر بار تغییری اعمال می‌کنیم، یک کانتکست جدید ایجاد می‌شود که به کانتکست قبلی ارجاع می‌دهد و آن را به‌عنوان والد (parent) خود نگه می‌دارد.

• لغو (cancel) کردن یک کانتکست باعث می‌شود تمامی کانتکست‌های فرزند (descendant) آن نیز لغو شوند، اما کانتکست‌های والد (ancestor) تحت تأثیر قرار نمی‌گیرند و لغو نمی‌شوند.

• هنگامی که متد Value را فراخوانی می‌کنیم، ابتدا مقدار مورد نظر در کانتکست فعلی جست‌وجو می‌شود. اگر مقدار یافت نشود، جست‌وجو در کانتکست والد ادامه پیدا می‌کند و این فرایند تا رسیدن به کانتکست ریشه ادامه می‌یابد.

نکاتی که بهتر است هنگام استفاده از Context رعایت کنیم

• context.Context را همواره به‌عنوان اولین پارامتر به توابعی که به آن نیاز دارند پاس دهید.
• از ذخیره کردن Context در فیلدهای یک struct یا متغیرهای سراسری (global scope) خودداری کنید و آن را به‌صورت صریح بین توابع منتقل کنید.
• از context.Value برای انتقال داده‌های مرتبط با طول عمر یک درخواست (مانند requestID، traceID یا logger) استفاده کنید و از قرار دادن داده‌های اصلی بیزینس در آن بپرهیزید.
• با استفاده از متد Err() می‌توان تشخیص داد که یک کانتکست به دلیل فراخوانی cancel() لغو شده است (context.Canceled) یا به دلیل اتمام مهلت زمانی (context.DeadlineExceeded).

قسمت قبل: چنل‌ها (channels) | گولنگ به زبان ساده

قسمت بعد: یونیت تست (unit test) | گولنگ به زبان ساده