DependencyInjectionRepository

依賴注入

使用 Asp.net core 的範例

錄製影片連結：https://www.youtube.com/watch?v=oVj1IHw8GLU

OverviewOfDI：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. 服務提供者
2. 服務集合

以下 DI 生命週期將是

1. 登記：-
   1. 容器必須知道應實例化哪種類型的物件/依賴項。
   2. 在Asp.net core中，服務是使用「IServiceCollection」註冊的。
   3. 此服務通常在應用程式的「Startup.ConfigureServices」方法中註冊。
2. 解決：-
   1. 使用IoC容器時，我們不需要手動建立對象，容器會幫我們建立對象。
   2. 在Asp.net core中，框架負責在內建容器（IServiceProvider）的支援下建立依賴項的實例
3. Dispose：- 物件/依賴項的生命週期將僅由 IOC 容器負責

ASP.NET Core 中基本上有兩種類型的服務：

框架服務：屬於 ASP.NET Core 框架一部分的服務，例如 IApplicationBuilder、IHostingEnvironment、ILoggerFactory 等。

應用程式服務：您作為程式設計師為應用程式建立的服務（自訂類型或類別）。

控制器（MVC）的依賴注入：-

Asp.Net Core MVC 控制器透過建構函式明確請求依賴項 1. 建構函式註入 2. 方法注入（操作層級） 3. 屬性注入（不支援） 4. 視圖注入

1. 建構子注入： - 服務作為建構子參數添加，運行時從服務容器（IServiceCollection - DiContainer）解析服務。服務a通常使用非特定類別（介面）來定義

2. 方法注入： - 使用 [FromService] 屬性可以將服務直接注入到操作方法中，而無需使用控制器注入

3. 屬性注入 目前（Asp.net core）內建 IOC 容器不支援屬性注入。

4. 視圖注入使用 [Inject] 指令可以將服務直接注入視圖頁面，而無需使用控制器或方法注入

使用壽命

內建的IoC容器支援三種生命週期：

1. 單例：
   1. 單例生命週期服務（狀態服務）是在第一次請求時建立的（或當您在其中指定實例時執行ConfigureServices時），然後每個後續請求將在整個應用程式生命週期中使用「相同的實例」
   2. Core 為您提供了內建的擴充方法
      1. Add() (ServiceLifetime.Singleton)
      2. 新增單例()
2. 瞬態：
   1. 每次請求時都會建立瞬態生命週期服務。此生命週期最適合輕量級的「無狀態服務」。
   2. Core 為您提供了內建的擴充方法
      1. Add() 和 (ServiceLifetime.Transient)
      2. 新增瞬態（）
3. 範圍：
   1. 作用域生命週期服務會針對每個請求建立一次，並將在單一請求中共用。
   2. Core 為您提供了內建的擴充方法
      1. Add() 和 (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}");
      }
  }

現在，使用具體類型「MyDependency」註冊「IMyDependency」服務（在startup.cs中）

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

  }

這裡「IServiceCollection」實例的 Add() 方法用於向 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));

構造函數注入範例

公用類別 HomeController : 控制器 { 私人唯讀 IMyDependency _service;

 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["標題"] = "首頁"; }

 //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();
}

}