ما الغرض من حزمة context؟

Question

Accepted Answer

تحمل حزمة **`context`** إشارات الإلغاء والمهل الزمنية والقيم ذات نطاق الطلب عبر حدود واجهات برمجة التطبيقات وgoroutines. إنها الآلية القياسية للتحكم في دورة حياة العمليات — خاصة لإلغاء العمل ونشر المهل الزمنية عبر سلسلة من استدعاءات الدوال.

## المشكلة الأساسية التي تحلها

```text
A request starts work across many goroutines/functions (DB query, API call, etc.).
If the client disconnects or a timeout hits, you want to CANCEL all that work
so goroutines don't keep running uselessly (wasting resources / leaking).
→ context propagates the "stop now" signal down the entire call chain.
```

## إنشاء السياقات

```go
ctx := context.Background()          // the root context (top of the tree)
ctx := context.TODO()                 // placeholder when unsure

// with a timeout — auto-cancels after the duration
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()                        // ALWAYS call cancel to release resources

// with manual cancellation
ctx, cancel := context.WithCancel(context.Background())
// call cancel() to signal cancellation

// with a deadline (specific time)
ctx, cancel := context.WithDeadline(ctx, time.Now().Add(time.Minute))
```

`WithTimeout`/`WithDeadline`/`WithCancel` اشتق سياق فرعي يمكن إلغاؤه؛ يجب عليك `defer cancel()` لتحرير موارده.

## الاستجابة للإلغاء

```go
func doWork(ctx context.Context) error {
    for {
        select {
        case <-ctx.Done():            // fires when cancelled or timed out
            return ctx.Err()           // returns context.Canceled or DeadlineExceeded
        case work := <-jobs:
            process(work)
        }
    }
}
```

تتحقق الدوال من `ctx.Done()` (قناة تغلق عند الإلغاء) وتتوقف بسرعة — هذه هي طريقة نشر الإلغاء بالفعل.

## تمرير السياق عبر سلسلة استدعاءات (الاتفاقية)

```go
// ctx is conventionally the FIRST parameter, named ctx
func handler(ctx context.Context, ...) {
    data, err := fetchFromDB(ctx, id)   // pass it down — DB call honors cancellation
}
func fetchFromDB(ctx context.Context, id int) (...) {
    row := db.QueryRowContext(ctx, ...)  // standard-library APIs accept context
}
```

يتدفق السياق لأسفل stack الاستدعاء كمعامل أول، بحيث يصل الإلغاء إلى كل طبقة (بما في ذلك استدعاءات مكتبة قياسية من قاعدة البيانات/HTTP التي تقبل السياق).

## القيم ذات نطاق الطلب (استخدم بحذر)

```go
ctx = context.WithValue(ctx, requestIDKey, "abc-123")   // attach a value
id := ctx.Value(requestIDKey)                            // retrieve it downstream
// ⚠️ for request-scoped metadata (request IDs, auth) — NOT for passing regular params
```

## لماذا يهم

حزمة `context` أساسية لكتابة خدمات Go قوية وفي مستوى الإنتاج — إنها الطريقة القياسية والموضحة لمعالجة **الإلغاء والمهل الزمنية** عبر goroutines وحدود واجهات برمجة التطبيقات.

قيمتها الأساسية هي منع العمل الضائع وتسرب الموارد: عندما ينقطع عميل أو تنقضي مهلة زمنية أو يُغلق الخادم، ينشر السياق إشارة الإلغاء حتى تتوقف جميع goroutines والعمليات التي تم إنشاؤها لهذا الطلب على الفور بدلاً من التشغيل بلا فائدة (دفاع رئيسي ضد تسرب goroutine).

إنها منتشرة في Go الحقيقي — خوادم HTTP وأيضاً استدعاءات قاعدة البيانات و gRPC ومعظم المكتبات الشبكية تقبل `context.Context` كمعامل أول.

فهم كيفية إنشاء السياقات (`WithTimeout`/`WithCancel`)، والاستجابة للإلغاء (`<-ctx.Done()`)، وقاعدة التأكد من استدعاء `cancel()`، والاتفاقية المتمثلة في تمرير السياق عبر سلاسل الاستدعاء ضروري لأي عمل خلفي Go جاد وموضوع قائم للمقابلة.