حقن التبعيات (Dependency Injection) Dependency Injection (GetIt)

تخيل إنك بتبني بيت. هل ينفع كل ما تحتاج شاكوش تروح تصنعه من الصفر؟ طبعاً لأ. الأفضل يكون فيه "شنطة عدة" فيها الشاكوش جاهز، وإنت تطلبه وقت ما تحتاجه. ده بالضبط الـ Dependency Injection.

Imagine building a house. Should you manufacture a hammer from scratch every time you need one? Of course not. Better to have a "toolbox" where the hammer is ready, and you request it when needed. This is Dependency Injection.

إحنا اختارنا مكتبة GetIt لأنها بسيطة، سريعة، ومش محتاجة BuildContext. يعني تقدر تجيب أي خدمة حتى لو إنت بره الـ Widgets خالص.

// إزاي بنطلب خدمة؟
final repository = sl<IBookRepository>();

في GetIt، عندنا طريقتين أساسيتين لتسجيل الكلاسات:

تعالوا نشوف إزاي بنرتب "شنطة العدة" بتاعتنا في التطبيق:

final sl = GetIt.instance; // sl = Service Locator

Future initDI() async {
  // تسجيل الداتابيز كـ Singleton (نسخة واحدة للكل)
  sl.registerLazySingleton(() => AppDatabase());

  // تسجيل الـ Repository مع حقن الـ DAO جواه
  sl.registerLazySingleton(
    () => BookRepositoryImpl(sl()),
  );

  // تسجيل البلوك كـ Factory (نسخة جديدة لكل شاشة)
  sl.registerFactory(() => BooksBloc(repository: sl()));
}

أحياناً، الـ Cubit مش بس محتاج Repository، ده محتاج معلومة تانية بتيجي وقت التشغيل (زي الـ bookId). إزاي بنبعت المعلومة دي لـ GetIt؟

// التسجيل في injection_container.dart
sl.registerFactoryParam(
  (bookId, _) => AddEntryCubit(entryDao: sl(), bookId: bookId),
);

// الاستدعاء في الـ UI
final cubit = sl(param1: currentBookId);

بعض الخدمات (زي SharedPreferences) بتحتاج وقت عشان تحمل من ذاكرة الموبايل. عشان كدة الـ initDI لازم تكون Future<void>.

// في main.dart
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initDI(); // لازم نستنى لغاية ما كل العدة تجهز!
  runApp(const MyApp());
}

لو نسينا الـ await، التطبيق ممكن يضرب (Crash) لأنه هيحاول يستخدم خدمة لسه مخلصتش تحميل.

أكبر ميزة للـ DI هي في الـ Unit Testing. إحنا نقدر "نلعب" في شنطة العدة ونشيل الشاكوش الأصلي ونحط واحد بلاستيك (Mock) عشان التست.

void main() {
  test('يجب الحصول على البيانات من النسخة المزيفة', () {
    final mockRepo = MockBookRepository();
    
    // بنسجل النسخة المزيفة بدل الأصلية
    sl.registerSingleton(mockRepo);
    
    // دلوقتي أي حد يطلب IBookRepository هياخد الـ Mock!
    final repo = sl();
    expect(repo, isA());
  });
}

عشان متتوهش، ده جدول بيوضح كل نوع تبعية بيتم التعامل معاه إزاي في المشروع:

لما التطبيق يكبر، مينفعش نحط كل حاجة في ملف واحد. عشان كدة بنستخدم injectDashboardFeature مثلاً.

void injectDashboardFeature(GetIt sl) {
  sl.registerFactory(() => DashboardCubit(
    bookDao: sl(),
    entryDao: sl(),
  ));
}

ده بيخلي كل ميزة مسؤولة عن "حقن" نفسها، وده بيريحنا جداً لما نحب نضيف ميزة جديدة أو نمسح ميزة قديمة.

حاول تلاقي الغلطة في الحالات دي:

من الناحية التقنية، GetIt هو Service Locator. الفرق بسيط بس مهم:

في MRE CashBook، إحنا دمجنا الاتنين. بنسجل في GetIt، بس الـ Blocs بتاخد حاجتها عن طريق الـ Constructor Injection. ده بيجمع بين سهولة GetIt ووضوح الـ DI.

في اختبارات التكامل، إحنا مش بس بنجرب كلاس واحد، إحنا بنجرب "البيت كله". الـ DI بيقدر يبهدل الدنيا لو مش مظبوط، بس GetIt بيسهل لنا التبديل حتى لو الأبلكيشن شغال.

setUp(() async {
  // بنصفر GetIt قبل كل تست
  await sl.reset();
  
  // بنسجل كل الخدمات المزيفة
  sl.registerLazySingleton(() => MockDatabase());
  sl.registerLazySingleton(() => MockPrefs());
  
  // بنشغل باقي الـ DI الأصلي
  initDI();
});

بالطريقة دي، الأبلكيشن بيفضل فاكر إنه بيكلم داتابيز حقيقية، بس في الحقيقة هو بيكلم ملف في الـ Memory بتاع التست. ده بيخليه سريع وآمن.

عشان تحافظ على شنطة عدتك نظيفة، اتبع القواعد دي:

• لا تسجل أي Widget جوه GetIt. الـ Widgets بتعتمد على الـ Context بس.
• لا تستخدم sl.get() جوه الـ UI مباشرة؛ مرر الخدمة للـ Bloc الأول.
• دائماً استخدم LazySingleton لو الخدمة تقيلة (زي الـ DB) عشان متبدأش إلا لو حد طلبها.
• دائماً افصل ملفات الـ DI لكل Feature عشان المشروع ميكبرش منك ويهرب.
• تجنب تسجيل كلاسات بتعتمد على بعض بشكل دائري (Circular Dependency).

عشان تتكلم بلغة المحترفين، لازم تكون عارف المصطلحات دي:

• Dependency: أي كلاس معتمد على كلاس تاني.
• Service Locator: المركز اللي بنطلب منه الخدمات (زي GetIt).
• Decoupling: إننا نفصل الكلاسات عن بعض عشان التغيير في واحد ميبوظش التاني.
• Mock: نسخة مزيفة من الكلاس بنستخدمها في الاختبارات.
• Composition Root: المكان اللي بنربط فيه كل التبعيات ببعض (زي ملف initDI).

أحياناً بنحتاج نسجل تبعيات "مؤقتة" لشاشة معينة بس، ونمسحها أول ما نمشي. GetIt بيدينا ميزة الـ pushNewScope.

// فتح مستوى جديد
sl.pushNewScope();
sl.registerFactory(() => TemporaryCubit());

// مسح كل اللي في المستوى ده
sl.popScope();

ده بيفيد جداً في العمليات المعقدة اللي مش عاوزين دوشتها تفضل موجودة في الذاكرة طول الوقت.

[ User Request ] ──▶ [ GetIt sl ] ──▶ [ Search Toolbox ]
                            │
            ┌───────────────┴───────────────┐
            ▼                               ▼
    [ LazySingleton ]               [ Factory ]
    (One instance)                  (New instance)
    Used for: DB, Repo              Used for: BLoC, Cubit
            │                               │
            └───────────────┬───────────────┘
                            ▼
                    [ Injected Object ]
        

الرسمة دي بتلخص تدفق البيانات والطلبات جوه نظام الـ DI بتاعنا.

الـ Dependency Injection هو اللي بيخلي الكود بتاعنا "مفكوك" (Decoupled)، وده سر سهولة الصيانة والتعديل في المستقبل.