ما هو الحقن والتبعيات (Dependency Injection) وعكس التحكم (Inversion of Control)؟

Question

Accepted Answer

**Dependency Injection (DI)** يعني أن الكائن يستقبل تبعياته من الخارج بدلاً من إنشاؤها بنفسه. وهي شكل من أشكال **Inversion of Control (IoC)**: المسؤولية عن ربط الكائنات *معكوسة* بعيداً عن الكائن وتُعطى لمستدعٍ أو حاوية.

## بدون DI مقابل مع DI

```python
# WITHOUT DI — the class controls its own dependencies (tight coupling)
class OrderService:
    def __init__(self):
        self.repo = PostgresOrderRepo()   # hard-wired; can't swap or test

# WITH DI — dependencies are passed in (loose coupling)
class OrderService:
    def __init__(self, repo: OrderRepo):  # any OrderRepo implementation
        self.repo = repo

# wiring happens outside:
service = OrderService(PostgresOrderRepo())   # prod
test    = OrderService(InMemoryOrderRepo())   # test — no DB needed
```

الفئة الآن تعتمد على *التجريد* `OrderRepo`، وشخص آخر يقرر أي تنفيذ محدد سيتم توفيره.

## أشكال الحقن

| الشكل | الكيفية |
|---|---|
| المُنشئ | تمريره إلى المُنشئ (مفضّل — التبعيات المطلوبة واضحة) |
| Setter | تعيينه عبر دالة بعد الإنشاء (التبعيات الاختيارية) |
| الواجهة/الحاوية | يقوم framework بالحل والحقن (Spring, .NET DI) |

## المقارنات

```text
✓ Testable (inject fakes/mocks)   ✓ Swappable implementations
✓ Explicit dependencies            ⚠️ More wiring; indirection can obscure flow
⚠️ DI containers add "magic" → harder to trace what's wired where
```

## لماذا يهم

DI هو التحقق العملي من مبدأ عكس التبعيات — المنطق الرفيع المستوى يتوقف عن الاعتماد على الفئات الملموسة منخفضة المستوى.

الفائدة هي القابلية للاختبار والمرونة: يمكنك استبدال قاعدة بيانات مزيفة في الاختبارات أو تبديل مزود الدفع في الإنتاج بتغيير الربط، وليس المنطق التجاري.

الشكل	الكيفية
المُنشئ	تمريره إلى المُنشئ (مفضّل — التبعيات المطلوبة واضحة)
Setter	تعيينه عبر دالة بعد الإنشاء (التبعيات الاختيارية)
الواجهة/الحاوية	يقوم framework بالحل والحقن (Spring, .NET DI)