DependencyInjectionRepository

依存関係の注入

Asp.netコアを使用したサンプル例

録画ビデオリンク: https://www.youtube.com/watch?v=oVj1IHw8GLU

DI の概要: https://github.com/sandeepmvn/DependencyInjectionRepository/blob/master/OverviewOfDI.txt

ASP.NET Core は、クラスとその依存関係の間で制御の反転 (IoC) を実現するための技術である依存関係注入 (DI) ソフトウェア デザイン パターンをサポートしています。

IoC コンテナを通じて、次のことを実現できます。

1. 疎結合クラス
2. オブジェクトのライフタイムの管理
3. クラスに依存関係を注入します
4. 実装の変更が容易
5. テスト駆動開発 (TDD)

Asp.net コアでは、IoC コンテナーにインターフェイスが組み込まれています。

1. Iサービスプロバイダー
2. Iサービスコレクション

次の DI ライフサイクルは次のようになります。

1. 登録する：-
   1. コンテナは、どのタイプのオブジェクト/依存関係をインスタンス化する必要があるかを認識している必要があります。
   2. Asp.net Core では、サービスは "IServiceCollection" を使用して登録されます。
   3. このサービスは通常、アプリの「Startup.ConfigureServices」メソッドに登録されます。
2. 解決する：-
   1. IoC コンテナを使用する場合、オブジェクトを手動で作成するのではなく、コンテナが自動的に作成します。
   2. Asp.net コアでは、フレームワークは、組み込みコンテナー (IServiceProvider) のサポートを使用して依存関係のインスタンスを作成する責任を負います。
3. 破棄:- オブジェクト/依存関係の有効期間は IOC コンテナのみによって処理されます。

ASP.NET Core には基本的に 2 種類のサービスがあります。

フレームワーク サービス: IApplicationBuilder、IHostingEnvironment、ILoggerFactory などの ASP.NET Core フレームワークの一部であるサービス。

アプリケーション サービス: プログラマとしてアプリケーション用に作成するサービス (カスタム タイプまたはクラス)。

コントローラーへの依存関係の注入 (MVC): -

Asp.Net Core MVC コントローラーは、コンストラクターを介して依存関係を明示的に要求します。 1. コンストラクター インジェクション 2. メソッド インジェクション (アクション レベル) 3. プロパティ インジェクション (サポートされていません) 4. ビュー インジェクション

1. コンストラクターの挿入: - サービスはコンストラクター パラメーターとして追加され、ランタイムはサービス コンテナー (IServiceCollection--DiContainer) からサービスを解決します。サービスは通常、非具象クラス (インターフェイス) を使用して定義されます。

2. メソッドインジェクション: - [FromService] 属性を使用すると、コントローラーインジェクションを使用せずにサービスをアクションメソッドに直接挿入できます。

3. プロパティ インジェクション 現在 (Asp.net コア) 組み込み IOC コンテナーはプロパティ インジェクションをサポートしていません。このためには、サードパーティの組み込みサービス コンテナー (IOC) を使用することをお勧めします。

4. [Inject] ディレクティブを使用したビュー インジェクションにより、コントローラーやメソッド インジェクションを使用せずにビュー ページにサービスを直接挿入できます。

サービス寿命

組み込み IoC コンテナは、次の 3 種類のライフタイムをサポートします。

1. シングルトン:
   1. シングルトン ライフタイム サービス (状態サービス) は、最初にリクエストされたとき (または、そこでインスタンスを指定した場合は ConfigureServices が実行されたとき) に作成され、その後のすべてのリクエストは、アプリケーションのライフタイムを通じて「同じインスタンス」を使用します。
   2. コアは組み込みの拡張メソッドを提供します
      1. Add() (ServiceLifetime.Singleton)
      2. AddSingleton()
2. トランジェント :
   1. 一時的なライフタイム サービスは、要求されるたびに作成されます。この有効期間は、軽量の「ステートレス サービス」に最適です。
   2. コアは組み込みの拡張メソッドを提供します
      1. Add() と (ServiceLifetime.Transient)
      2. AddTransient()
3. 対象範囲:
   1. スコープ付きライフタイム サービスはリクエストごとに 1 回作成され、単一のリクエストで共有されます。
   2. コアは組み込みの拡張メソッドを提供します
      1. Add() と (ServiceLifetime.Scoped)
      2. AddScoped()
      3. AddDBContext()

簡単アプリサービスの登録

サンプル例では、「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()));        
      }

  }

ここでは、「IServiceCollection」インスタンスの Add() メソッドを使用して、サービスを IoC コンテナに登録します。 「ServiceDescriptor」はサービスの種類と具体的な実装を指定するために使用されます。これにより、サービスがデフォルトの「Singleton」でコンテナに登録されます。

次に、異なる存続期間を持つサービスを注入してみましょう

1. シングルトン (ユースケース: 状態サービスを作成する必要がある場合):

   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 { private readonly 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();
}

}