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

  • 2020 年 12 月 19 日
  • 筆記

寫在前面

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

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

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

 

 什麼是依賴注入？

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

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

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

 

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

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

通俗的講，就是對象在被使用前，我們需要New一下對象，創建一個實例對象，然後在進行其他操作。

 

怎麼使用依賴注入？

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

  • 構造函數注入；

  • 方法注入；

  • 屬性注入；

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

  1. 在Startup類型的構造函數中注入；

  2. 在Startup類型的Configure方法中注入；

  3. 在中間件類型構造函數中注入；

  4. 在中間件類型的Invoke/InvokeAsync方法中注入；

  5. 在Controller類型的構造函數中注入；

  6. 在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依賴注入的使用方式，更多的使用方式還有待探索，一些使用過程當中的注意事項也需要探索，如：

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

 

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

 

歡迎關注訂閱我的微信公眾平台【熊澤有話說】，更多好玩易學知識等你來取

作者：熊澤-學習中的苦與樂
公眾號：熊澤有話說


出處： //www.cnblogs.com/xiongze520/p/14155858.html


創作不易，版權歸作者和部落格園共有，轉載或者部分轉載、摘錄，請在文章明顯位置註明作者和原文鏈接。
  

 

VirMach 便宜 VPS

QNews

QNews