寫在前面

上一篇大家已經粗略接觸了解到.NET Core中間件的使用：ASP .Net Core 中間件的使用（一）：搭建靜態檔案服務器/訪問指定檔案，

.NET Core框架中很多核心物件都是通過依賴注入的方式提供的，那什么是依賴注入？

這也是個老生常談的問題，到底依賴注入是什么？為什么要用它？初學者特別容易對控制反轉IOC(Iversion of Control)，DI等概念搞暈，

什么是依賴注入？

提到依賴注入，大家一定會想到控制反轉，怎么了解，控制反轉是一種設計原則（Inversion of Control，縮寫為IoC），而依賴注入(（Dependency Injection，簡稱DI）)是它的一種實作方式，

當一個類需要另一個類協作來完成作業的時候就產生了依賴，比如我們在AccountController這個控制器需要完成和用戶相關的注冊、登錄等事情，

這里有一個設計原則：依賴于抽象，而不是具體的實作，當一個類依賴于具體依賴時，它被認為與該類緊密耦合，

依賴注入的目的是為了什么？

控制反轉用于解耦，將介面和實作的耦合降低，有一個好處就是，一個介面，可以進行不同的實作，這樣提高擴展性，確保代碼的可維護性和擴展性，

通俗的講，就是物件在被使用前，我們需要New一下物件，創建一個實體物件，然后在進行其他操作，

怎么使用依賴注入？

.NET Core 自帶了依賴注入的框架，我們可以歸納為這幾個使用方式，當然還有很多使用方法（常規，泛型，工廠），就不一一舉例了：

建構式注入；
方法注入；
屬性注入；

這么歸納是不是感覺不太好理解？沒關系，我們進一步細化為如下使用方式：

在Startup型別的建構式中注入；
在Startup型別的Configure方法中注入；
在中間件型別建構式中注入；
在中間件型別的Invoke/InvokeAsync方法中注入；
在Controller型別的建構式中注入；
在Controller的Action方法中注入；

一、在Startup型別的建構式中注入

配置的IConfiguration物件和表示承載環境的IHostEnvironment物件可以直接注入Startup建構式中，

當然也可以通過注入IWebHostEnvironment物件的方式得到當前承載環境相關的資訊，

這是因為ASP.NET Core應用中的承載環境通過IWebHostEnvironment介面表示，IWebHostEnvironment介面派生于IHostEnvironment介面），

我們可以通過一個簡單的實體來驗證針對Startup的建構式注入，

如下面的代碼片段所示，我們在呼叫IWebHostBuilder介面的Startup<TStartup>方法時注冊了自定義的Startup型別，

在定義Startup型別時，我們在其建構式中注入上述3個物件，提供的除錯斷言不僅證明了3個物件不為Null，還表明采用IHostEnvironment介面和IWebHostEnvironment介面得到的其實是同一個實體，

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder.UseStartup<Startup>())
        .Build()
        .Run();
    }
}

public class Startup
{
    public Startup(IConfiguration configuration, IHostEnvironment hostingEnvironment,IWebHostEnvironment webHostEnvironment)
    {
        Debug.Assert(configuration != null);
        Debug.Assert(hostingEnvironment != null);
        Debug.Assert(webHostEnvironment != null);
        Debug.Assert(ReferenceEquals(hostingEnvironment, webHostEnvironment));
    }
    public void Configure(IApplicationBuilder app) { }
}

二、在Startup型別的Configure方法中注入

這種注入方式也叫管道注入，這種是使用比較多的一種注入方式，因為.NET Core創建專案的時候已經在Startup.cs類里面生成框架了（管道注入）,

如果建構式注入還可以對注入的服務有所選擇，那么對于Configure方法來說，通過任意方式注冊的服務都可以注入其中，包括通過呼叫

IHostBuilder、IWebHostBuilder和Startup自身的ConfigureServices方法注冊的服務，還包括框架自行注冊的所有服務，

如下面的代碼代碼片段所示，我們分別呼叫IWebHostBuilder和Startup的ConfigureServices方法注冊了針對IStudent介面和ISchool介面的服務，這兩個服務直接注入Startup的Configure方法中，另外，Configure方法要求提供一個用來注冊中間件的IApplicationBuilder物件作為引數，但是對該引數出現的位置并未做任何限制，

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .UseStartup<Startup>()
            .ConfigureServices(svcs => svcs.AddSingleton<IStudent, Student>()))
        .Build()
        .Run();
    }
}

public class Startup
{
    public void ConfigureServices(IServiceCollection services) => services.AddSingleton<ISchool, School>();
    public void Configure(IApplicationBuilder app, IStudent student, ISchool school)
    {
        Debug.Assert(student != null);
        Debug.Assert(school!= null);
    }
}

三、在中間件型別建構式中注入

ASP.NET Core請求處理管道最重要的物件是用來真正處理請求的中間件，

由于ASP.NET Core在創建中間件物件并利用它們構建整個請求處理管道時，所有的服務都已經注冊完畢，所以任何一個注冊的服務都可以注入中間件型別的建構式中，

如下所示的代碼片段體現了針對中間件型別的建構式注入，

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .ConfigureServices(svcs => svcs
                .AddSingleton<studentschoolMiddleware>()
                .AddSingleton<IStudent, student>()
                .AddSingleton<ISchool, school>())
            .Configure(app => app.UseMiddleware<studentschoolMiddleware>()))
        .Build()
        .Run();
    }
}

public class studentschoolMiddleware : IMiddleware
{
    public studentschoolMiddleware(IStudent student, ISchool school)
    {
        Debug.Assert(student != null);
        Debug.Assert(school != null);
    }

    public Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        Debug.Assert(next != null);
        return Task.CompletedTask;
    }
}

四、在中間件型別的Invoke/InvokeAsync方法中注入

如果采用基于約定的中間件型別定義方式，注冊的服務還可以直接注入真正用于處理請求的InvokeAsync方法或者Invoke方法中，

另外，將方法命名為InvokeAsync更符合TAP（Task-based Asynchronous Pattern）編程模式，之所以保留Invoke方法命名，主要是出于版本兼容的目的，

如下所示的代碼片段展示了針對InvokeAsync方法的服務注入，

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .ConfigureServices(svcs => svcs
                .AddSingleton<IStudent, student>()
                .AddSingleton<ISchool, school>())
            .Configure(app => app.UseMiddleware<studentschoolMiddleware>()))
        .Build()
        .Run();
    }
}

public class studentschoolMiddleware
{
    private readonly RequestDelegate _next;

    public studentschoolMiddleware(RequestDelegate next) => _next = next;
    public Task InvokeAsync(HttpContext context, IStudent student, ISchool school)
    {
        Debug.Assert(context != null);
        Debug.Assert(student != null);
        Debug.Assert(school != null);
        return _next(context);
    }
}

對于基于約定的中間件，建構式注入與方法注入存在一個本質區別，

由于中間件被注冊為一個Singleton物件，所以我們不應該在它的建構式中注入Scoped服務，

Scoped服務只能注入中間件型別的InvokeAsync方法中，因為依賴服務是在針對當前請求的服務范圍中提供的，所以能夠確保Scoped服務在當前請求處理結束之后被釋放，

五、在Controller型別的建構式中注入

在一個ASP.NET Core MVC應用中，我們可以在定義的Controller中以建構式注入的方式注入所需的服務，

在如下所示的代碼片段中，我們將IStudentschool服務注入到HomeController的建構式中，

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .ConfigureServices(svcs => svcs
                .AddSingleton<IStudentschool, studentschool>()
                .AddSingleton<ISchool, school>()
                .AddControllersWithViews())
            .Configure(app => app
                .UseRouting()
                .UseEndpoints(endpoints => endpoints.MapControllers())))
        .Build()
        .Run();
    }
}

public class HomeController : Controller
{
    public HomeController(IStudentschool studentschool) => Debug.Assert(studentschool!= null);

}

六、在Controller的Action方法中注入

借助于ASP.NET Core MVC基于模型系結的引數系結機制，我們可以將注冊的服務系結到目標Action方法的引數上，進而實作針對Action方法的依賴注入，

在采用這種型別的注入方式時，我們需要在注入引數上按照如下的方式標注FromServicesAttribute特性，用以確定引數系結的來源是注冊的服務，

在如下所示的代碼片段

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .ConfigureServices(svcs => svcs
                .AddSingleton<IStudentschool, Studentschool>()
                .AddControllersWithViews())
            .Configure(app => app
                .UseRouting()
                .UseEndpoints(endpoints => endpoints.MapControllers())))
        .Build()
        .Run();
    }
}

public class HomeController: Controller
{
    [HttpGet("/")]
    public void Index([FromServices]IStudentschool studentschool)
    {
        Debug.Assert(Studentschool!= null);
    }
}

七、在視圖中注入

在ASP.NET Core MVC應用中，我們還可以將服務注冊到現的View中，

假設我們定義了如下這個簡單的MVC程式，并定義了一個簡單的HomeController，

如下代碼片段

class Program
{
    static void Main()
    {
        Host.CreateDefaultBuilder().ConfigureWebHostDefaults(builder => builder
            .ConfigureServices(svcs => svcs
                .AddSingleton<IStudentschool, Studentschool>()
                .AddControllersWithViews())
            .Configure(app => app
                .UseRouting()
                .UseEndpoints(endpoints => endpoints.MapControllers())))
        .Build()
        .Run();
    }
}

public class HomeController: Controller
{
        [HttpGet("/")]
        public IActionResult Index() => View();
}

我們為HomeController定義了一個路由指向根路徑（“/”）的Action方法Index，該方法在呼叫View方法呈現默認的View之前，

將注入的IStudentschool服務以ViewBag的形式傳遞到View中，

如下所示的代碼片段是這個Action方法對應View（/Views/Home/Index.cshtml）的定義，我們通過@inject指令注入了IStudentschool服務，并

將屬性名設定為Studentschool，這意味著當前View物件將添加一個Studentschool屬性來參考注入的服務，

@inject IStudentschool Studentschool
@
{
    Debug.Assert(Studentschool!= null);
}

寫在后面

到這里就簡單介紹了.NET Core依賴注入的使用方式，更多的使用方式還有待探索，一些使用程序當中的注意事項也需要探索，如：

有效地設計服務及其依賴關系；
防止多執行緒問題；
防止記憶體泄漏；
防止潛在的錯誤；
如果使用了服務注入，還要考慮服務生命周期（服務不能依賴于生命周期小于其自身的服務，）；

參考： https://www.cnblogs.com/artech/p/di-in-asp-net-core-3.html

歡迎關注訂閱我的微信公眾平臺【熊澤有話說】，更多好玩易學知識等你來取
作者：熊澤-學習中的苦與樂
公眾號：熊澤有話說
出處： https://www.cnblogs.com/xiongze520/p/14155858.html
創作不易，著作權歸作者和博客園共有，轉載或者部分轉載、摘錄，請在文章明顯位置注明作者和原文鏈接，

轉載請註明出處，本文鏈接：https://www.uj5u.com/net/237393.html

標籤：.NET Core

上一篇：【英雄帖】FreeRedis 邀請您一起優化專案。

下一篇：紙殼CMS 3.3.6發布升級.Net 5

ASP.NET Core 中間件的使用（二）：依賴注入的使用