ASP.NET Core 中間件的使用(二):依賴注入的使用 ASP .Net Core 中間件的使用(一):搭建靜態文件服務器/訪問指定文件

寫在前面

上一篇大家已經粗略接觸瞭解到.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方法來說,通過任意方式註冊的服務都可以注入其中,包括通過調用

IHostBuilderIWebHostBuilderStartup自身的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
創作不易,版權歸作者和博客園共有,轉載或者部分轉載、摘錄,請在文章明顯位置註明作者和原文鏈接。  

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章