1. 程式人生 > 程式設計 >ASP.NET Core 奇淫技巧之偽屬性注入的實現

ASP.NET Core 奇淫技巧之偽屬性注入的實現

一.前言

開局先嘮嗑一下,許久未曾更新部落格,一直在調整自己的狀態,去年是我的本命年,或許是應驗了本命年的多災多難,過得十分不順,不論是生活上還是工作上。還好當我度過了所謂的本命年後,許多事情都在慢慢變好,我將會開始恢復更新部落格,爭取恢復到以前的速度上(因為工作比較忙,所以這個過程可能需要一段時間)。

二.關於屬性注入

說到屬性注入,我們就不得不提一下 DI(Dependency Injection),即依賴注入,用過 ASP.NET Core 的同學相信對這個詞不會陌生。ASP.NET Core 自帶了一個IOC容器,且程式執行也是基於這個容器建立起來的,在 Startup 裡的 ConfigureServices

方法就是向容器註冊型別。最直白的講,我們在 ASP.NET Core 中,想使用某個型別的時候可以不用自己去 new,可以由容器通過構造方法來注入具體的實現型別,而我們一般在構造方法上定義的依賴型別都是介面,而不是去依賴具體的實現,這裡就體現了 SOLID 原則中的依賴倒置原則(DIP)。這也是IOC(Inversion of Control),即控制反轉,不直接依賴具體實現,將依賴交給容器去控制。上述幾者是具有一定的關聯關係的,DIP 是一種軟體設計原則,IOC 是 DIP 的具體實現方式,DI 是 IOC 的一種實現方式。

在依賴注入時,我們最常用的便是通過構造方法注入,還有另一種方式那便是屬性注入。

關於屬性注入,如果在網上搜索,大部分內容都是不推薦使用,或者說慎重使用的,因為屬性注入會造成型別的依賴關係隱藏,測試不友好等,我也同意這種說法,屬性注入可以使用,但是要謹慎,不能盲目使用。我的原則:在封裝框架(搭架子)時可以使用,但不能大範圍使用,只有必須使用屬性注入來達到效果的地方才會使用,用來提高使用框架時的編碼效率,來達到一些便利,脫離框架層面,編寫業務程式碼時,不得使用。

在 ASP.NET Core 中,自帶的容器是不支援屬性注入的,但是可以通過替換容器,如:Autofac 等來實現。今天我分享的方法不是使用替換容器,而是通過幾行程式碼來實現屬性注入的效果,我稱為“偽屬性注入”。

三.屬性注入解決的痛點

以下介紹的痛點是我在實際編碼過程中遇到的一些,如果還有其他的,歡迎在評論和我交流

我所遇到的痛點,我歸納為三條:

1.減少常用的型別的重複注入程式碼,使構造方法看起來更為簡潔,提高閱讀性。

2.減少或消除因構造方法注入造成子類繼承後的 base 呼叫鏈。

3.並非是滿足第一條或第二條就需要使用屬性注入來解決,只有當第一、二條發生的情況到達一定的數量。

第一條:

以日誌 ILogger<T> 為例,我們在 Controller 或者 應用服務層(Application Service)等編寫業務的地方可能會常用,那麼我們可能會在大部分的 Controller 或者 Application Service 的構造方法裡寫一句注入,例:

ASP.NET Core 奇淫技巧之偽屬性注入的實現

這裡只是以日誌來舉例,我們還能遇到和日誌這種相同的型別,每個 Controller 等都要注入一堆這種共同的型別,程式碼編寫起來也比較麻煩,如果多了以後還影響程式碼閱讀。

有何解決辦法,那就是定義一個基類,然後通過屬性提供給子類,以 Controller 為例:

ASP.NET Core 奇淫技巧之偽屬性注入的實現

第二條:

在上面的Controller基類注入 ILogger,然後設定了 Logger 屬性,這樣子類就可以使用 Logger 屬性來使用日誌。

這樣做每次都要呼叫 base 將依賴物件傳遞給基類,如果繼承關係有多層,將會造成更大的影響。

ASP.NET Core 奇淫技巧之偽屬性注入的實現

注意:本文演示只以日誌來舉例,如果只有一個ILogger我覺得還可以忍受,實際情況中並非只有一個,比如本地化等等。博主不提倡有上面演示情況的就用屬性注入,當到達一定數量才使用,比如在 Controller 或者應用服務這種數量多的物件以及當這些物件需要的共同的注入型別達到一定數量。

四. 偽屬性注入核心思想

依託於 ASP.NET Core 自帶的容器,在 Resolve Service 時,為需要“屬性注入”的屬性進行賦值,可以使用 自帶容器提供的 ImplementationFactory 來實現。

五. 為 Controller 實現偽屬性注入

Controller 的實現較為特殊,Controller 預設是不會通過自帶容器來 Resolve&Activate 的,是通過MVC自身管理的,但是微軟提供了這樣的方法:

services.AddControllers().AddControllersAsServices();

可以通過呼叫 AddControllersAsServices() 方法來讓 Controller 使用自帶容器,其主要原始碼如下

ASP.NET Core 奇淫技巧之偽屬性注入的實現

根據第四小節的思想,我們需要 Controller Resolve 時,來對屬性進行賦值,那麼我們需要改造 Controller 啟用器。

定義 Controller 基類

ASP.NET Core 奇淫技巧之偽屬性注入的實現

Controller 繼承基類

ASP.NET Core 奇淫技巧之偽屬性注入的實現

改造 Controller 啟用器

ASP.NET Core 奇淫技巧之偽屬性注入的實現

可以看到我們改造的程式碼也就幾行。

替換預設 Controller 啟用器

services.AddControllers().AddControllersAsServices();
services.Replace(ServiceDescriptor.Transient<IControllerActivator,XcServiceBasedControllerActivator>()); 
//替換預設 Controller 啟用器

執行測試

ASP.NET Core 奇淫技巧之偽屬性注入的實現

測試正常,如需其他屬性的“屬性注入”,參考日誌這樣做就行了。

六. 為 Application Service 實現偽屬性注入

只是以 Application Service 來作為講解,同理可舉一反三到其他地方。Application Service 屬於領域驅動分層架構中的一層,如不瞭解,可自行查詢資料。

定義應用服務基類介面

public interface IAppService
{
  ILogger Logger { get; set; }
}

public class AppService:IAppService
{
  public ILogger Logger { get; set; }
}

定義具體服務,以 User 服務為例

public interface IUserAppService:IAppService
{
  void Create();
}

public class UserAppService : AppService,IUserAppService
{
  public void Create()
  {
    Logger.LogInformation("來自 Application Service 的日誌");
  }
}

定義特殊的註冊服務的方法,以便實現 Resolve 為 Logger 賦值

public static class ServiceExtensions
{
  public static IServiceCollection AddApplicationService<TService,TImpl>(this IServiceCollection services) where TService:IAppService where TImpl:AppService
  {
    services.AddApplicationService(typeof(TService),typeof(TImpl));
    return services;
  }
  // 可以反射程式集呼叫此方法實現批量自動註冊應用服務
  public static IServiceCollection AddApplicationService(this IServiceCollection services,Type serviceType,Type implType)
  {
    services.AddTransient(serviceType,sp =>
    {
      //獲取服務實現的例項
      var implInstance = ActivatorUtilities.CreateInstance(sp,implType); ;

      if (implInstance is AppService obj)
      {
        //為 Logger 賦值
        obj.Logger= sp.GetRequiredService<ILoggerFactory>().CreateLogger(implType);
      }
      
      return implInstance;
    });
    return services;
  }

註冊測試服務

ASP.NET Core 奇淫技巧之偽屬性注入的實現

Controller 注入測試服務

ASP.NET Core 奇淫技巧之偽屬性注入的實現

執行測試

ASP.NET Core 奇淫技巧之偽屬性注入的實現

七.結束

其實到本文寫完,我都在想,要不要封裝一個元件,釋出到 Nuget 來方便的使用文中我所描述的“偽屬性注入”,最後反覆想了想,還是覺得不做。如果要使用完全的屬性注入可以替換使用第三方容器,本文所述旨在不想引入第三方容器,且想在部分地方來達到屬性注入的效果,因為屬性注入這個東西也不推薦大範圍使用。

本文來源於我在工作中的一些靈感總結,我在看 ControllerActivator 原始碼時的突發奇想,最近工作雖然忙,但是知識確實積攢了不少,在後面與大家一一分享。

姊妹篇:ASP.NET Core 奇淫技巧之動態WebApi

到此這篇關於ASP.NET Core 奇淫技巧之偽屬性注入的實現的文章就介紹到這了,更多相關ASP.NET Core 偽屬性注入內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!

作者:曉晨Master(李志強)

文章連結:https://www.cnblogs.com/stulzq/p/12610026.html