DependencyInjectionRepository

حقن التبعية

مثال نموذجي باستخدام Asp.net core

رابط الفيديو المسجل: https://www.youtube.com/watch?v=oVj1IHw8GLU

نظرة عامة على DI: https://github.com/sandeepmvn/DependencyInjectionRepository/blob/master/OverviewOfDI.txt

يدعم ASP.NET Core نمط تصميم برنامج حقن التبعية (DI)، وهو أسلوب لتحقيق عكس التحكم (IoC) بين الفئات وتبعياتها.

من خلال حاوية IoC، يمكننا تحقيق ذلك

1. فصول مترابطة بشكل فضفاض
2. إدارة عمر الكائن
3. يحقن التبعيات في الفصل
4. من السهل تغيير التنفيذ
5. التطوير القائم على الاختبار (TDD)

في Asp.net core، تحتوي حاوية IoC على واجهات مدمجة.

1. IServiceProvider
2. IServiceCollection

ستكون دورة حياة DI التالية

1. يسجل:-
   1. يجب أن تعرف الحاوية نوع الكائن/التبعية التي يجب إنشاء مثيل لها.
   2. في Asp.net الأساسية، يتم تسجيل الخدمات باستخدام "IServiceCollection".
   3. عادةً ما يتم تسجيل هذه الخدمات في طريقة "Startup.ConfigureServices" الخاصة بالتطبيق.
2. حل:-
   1. عند استخدام حاوية IoC، لا نقوم بإنشاء كائنات يدويًا، بل تقوم الحاوية بذلك نيابةً عنا.
   2. في قلب Asp.net، يتولى إطار العمل مسؤولية إنشاء مثيل للتبعية بدعم من الحاوية المضمنة (IServiceProvider)
3. التخلص: - سيتم الاهتمام بعمر الكائن/التبعية بواسطة حاوية IOC فقط

يوجد أساسًا نوعان من الخدمات في ASP.NET Core:

خدمات إطار العمل: الخدمات التي تعد جزءًا من إطار عمل ASP.NET الأساسي مثل IApplicationBuilder وIHostingEnvironment وILoggerFactory وما إلى ذلك.

خدمات التطبيقات: الخدمات (الأنواع أو الفئات المخصصة) التي تقوم بإنشائها كمبرمج لتطبيقك.

حقن التبعية في وحدة التحكم (MVC): -

تطلب وحدة التحكم Asp.Net Core MVC التبعيات بشكل صريح عبر المُنشئات 1. حقن المُنشئ 2. حقن الطريقة (مستوى الإجراء) 3. حقن الملكية (غير مدعوم) 4. عرض الحقن

1. حقن المُنشئ: - تتم إضافة الخدمات كمعلمة مُنشئ ويقوم وقت التشغيل بحل الخدمة من حاوية الخدمة (IServiceCollection--DiContainer). يتم تعريف الخدمات (أ) عادةً باستخدام فئة (واجهات) غير ملموسة

2. حقن الطريقة: - يتيح استخدام سمة [FromService] حقن الخدمة مباشرة في طريقة الإجراء دون استخدام حقن وحدة التحكم

3. لا تدعم حاوية IOC المدمجة حاليًا (Asp.net core) حقن الخاصية حقن الخاصية. ولهذا يمكنك استخدام حاويات الخدمة المضمنة (IOC) التابعة لجهات خارجية.

4. عرض الحقن باستخدام التوجيه [Inject] يتيح حقن الخدمة مباشرة في صفحة العرض دون استخدام وحدة التحكم أو إدخال الطريقة

عمر الخدمة

تدعم حاوية IoC المدمجة ثلاثة أنواع من العمر:

1. سينجلتون:
   1. يتم إنشاء خدمات عمر المفردة (خدمة الحالة) في المرة الأولى التي يتم طلبها فيها (أو عند تشغيل ConfigureServices إذا قمت بتحديد مثيل هناك) وبعد ذلك سيستخدم كل طلب لاحق "نفس المثيل"، طوال عمر التطبيق
   2. يوفر لك Core طرق تمديد مدمجة
      1. إضافة () (ServiceLifetime.Singleton)
      2. AddSingleton()
2. عابر :
   1. يتم إنشاء خدمات مدى الحياة العابرة في كل مرة يتم طلبها فيها. يعمل هذا العمر بشكل أفضل مع "الخدمات عديمة الحالة" خفيفة الوزن.
   2. يوفر لك Core طرق تمديد مدمجة
      1. أضف () مع (ServiceLifetime.Transient)
      2. إضافة عابرة ()
3. نطاق :
   1. يتم إنشاء الخدمات ذات النطاق الزمني مرة واحدة لكل طلب وستتم مشاركتها في طلب واحد.
   2. يوفر لك Core طرق تمديد مدمجة
      1. أضف () مع (ServiceLifetime.Scoped)
      2. أدسكوبد ()
      3. أددبكونتيكست ()

تسجيل خدمة التطبيق البسيط

في نموذج المثال، تحدد واجهة خدمة "IMyDependency" أسلوب "WriteMessage".

  public interface IMyDependency
  {
      void WriteMessage(string message);
  }

يتم تنفيذ هذه الواجهة بواسطة نوع ملموس، MyDependency:

  public class MyDependency : IMyDependency
  {
      public void WriteMessage(string message)
      {
          Console.WriteLine($"MyDependency.WriteMessage Message: {message}");
      }
  }

الآن، قم بتسجيل خدمة "IMyDependency" بالنوع المحدد "MyDependency" (في ملفstartup.cs)

  public class Startup
  {
      public void ConfigureServices(IServiceCollection services)
      {
          services.Add(new ServiceDescriptor(typeof(IMyDependency), new MyDependency()));        
      }

  }

هنا يتم استخدام طريقة Add() لمثيل "IServiceCollection" لتسجيل خدمة باستخدام حاوية IoC. يتم استخدام "ServiceDescriptor" لتحديد نوع الخدمة والتنفيذ الملموس. سيؤدي هذا إلى تسجيل خدمتنا في الحاوية افتراضيًا باسم "Singleton"

الآن، دعونا نحقن الخدمات بأوقات حياة مختلفة

1. Singleton (حالة الاستخدام: عندما نحتاج إلى إنشاء خدمة حالة):

   Services.Add(new ServiceDescriptor(typeof(IMyDependency), new MyDependency(),ServiceLifetime.Singleton));

2. عابر (حالة الاستخدام: عندما نحتاج إلى إنشاء خدمة عديمة الجنسية):

   Services.Add(new ServiceDescriptor(typeof(IMyDependency), new MyDependency(),ServiceLifetime.Transient));

3. النطاق (حالة الاستخدام: خدمة قاعدة البيانات):

   Services.Add(new ServiceDescriptor(typeof(IMyDependency), new MyDependency(),ServiceLifetime.Scoped));

يمكننا أيضًا حقن الخدمات باستخدام طرق التمديد المضمنة

1. سينجلتون

   Services.AddSingleton(); أو Services.AddSingleton(typeof(IMyDependency), typeof(MyDependency));

2. عابر

   Services.AddTransisent(); أو Services.AddTransient(typeof(IMyDependency), typeof(MyDependency));

3. نطاق

   Services.AddScoped(); أو Services.AddScoped(typeof(IMyDependency), typeof(MyDependency));

مثال مع حقن المنشئ

public class HomeController: Controller { خدمة IMyDependency الخاصة للقراءة فقط؛

 public HomeController(IMyDependency service)
{
    _service = service;
}

public IActionResult Index()
{
    _service.WriteMessage("Constructor level injection")
   
    return View();
}

}

مثال مع حقن العمل

 public class HomeController : Controller
{
  //Fromservice attribute
  public IActionResult Index([FromService]IMyDependency service)
  {
      service.WriteMessage("Action level injection")
      return View();
  }
}

مثال مع حقن العرض

الطبقة العامة HomeController: وحدة التحكم {

 public IActionResult Index()
{
    return View();
}

}

في Index.cshtml

@{ ViewData["Title"] = "الصفحة الرئيسية"; }

 //using Inject directive

@inject IMyDependency service

//code block
@{
  service.WriteMessage("View level Injection");
}

بدون حقن، احصل على الخدمات يدويًا باستخدام HttpContext

الطبقة العامة HomeController: وحدة التحكم {

 public IActionResult Index()
{
    var services = this.HttpContext.RequestServices;
    var dependencyservice = (IMyDependency)services.GetService(typeof(IMyDependency));
    dependencyservice.WriteMessage("without injection, accessing dependent services");
    return View();
}

}