在net Core3.1上基於winform實現依賴註入實例

来源:https://www.cnblogs.com/JerryMouseLi/archive/2019/12/22/12080618.html
-Advertisement-
Play Games

在net Core3.1上基於winform實現依賴註入實例 [toc] 1.背景 net core3.1是微軟LTS長期3年支持版本,正式發佈於2019 12 03,並且在windows平臺上支持了Winfrom跟WPF桌面應用。本文介紹了使用Winform時的第一步,將應用層以及ORM涉及到的D ...


目錄

在net Core3.1上基於winform實現依賴註入實例

1.背景

net core3.1是微軟LTS長期3年支持版本,正式發佈於2019-12-03,並且在windows平臺上支持了Winfrom跟WPF桌面應用。本文介紹了使用Winform時的第一步,將應用層以及ORM涉及到的DBconfig,倉儲層等依賴註入到容器中,並通過構造函數法從容器中調用實例,供給各窗體控制項使用。
備註:本文的依賴註入講解基於微軟原生自帶的DI,通過Ninject或者AutoFac可自行仿照操作,原理相通。

2.依賴註入

2.1依賴註入是什麼?

依賴註入是通過反轉控制(IOC),設計模式屬於代理模式+工廠模式,由serviceProvider根據實例介面或者實例類型調用,註入時生命周期的設置,控制實例化及配置實例生命周期,並返回實例給程式員調用,從而達到解放程式員的生產力,不用再去new 一個個實例,也不用去考慮實例之間的依賴關係,也不用去考慮實例的生命周期。實現,分為三個階段,第一,程式員將服務註入服務容器階段,第二程式員DI實例調用階段,第三serviceProvider服務管理者根據註入時的配置返回給程式對應的實例以及配置好實例的生命周期。

一張圖就可以理解依賴註入實例調用過程

圖片來源出處,感謝作者。

這裡再向讀者做個說明ServiceCollection是服務容器,serviceProvider是服務管理者,管理著服務容器,當程式發送抽象介面,或者類型時,serviceProvider會根據設置好的生命周期,返回需要的實例配置好實例的生命周期給程式員使用。

2.1依賴註入的目的

通過代理模式serviceProvider控制反轉,他將持有控制權,將所有需要用到的介面,類型,反射出對應的實例,實例化以及設置好實例的生命周期,然後將控制權返還給程式員,不用再去new 一個個實例,也不用去考慮實例之間的依賴關係,也不用去考慮實例的生命周期,最終目的就是解放程式員的生產力,讓程式員更輕鬆地寫程式。

2.2依賴註入帶來的好處

2.2.1生命周期的控制

在註入的同時可以設置如下三種生命周期:

  • Transient
    每次註入時,都重新 new 一個新的實例。
  • Scoped
    每個 Request 都重新 new 一個新的實例,同一個 Request 不管經過多少個 Pipeline 都是用同一個實例。
  • Singleton
    被實例化後就不會消失,程式運行期間只會有一個實例。

    2.2.1.1 生命周期測試舉例

  • 定義同一個例子對應三個不同生命周期的介面
public interface ISample
{
    int Id { get; }
}

public interface ISampleTransient : ISample
{
}

public interface ISampleScoped : ISample
{
}

public interface ISampleSingleton : ISample
{
}

public class Sample : ISampleTransient, ISampleScoped, ISampleSingleton
{
    private static int _counter;
    private int _id;

    public Sample()
    {
        _id = ++_counter;
    }

    public int Id => _id;
}
  • 將對應的服務與介面註冊到容器中
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddTransient<ISampleTransient, Sample>();
        services.AddScoped<ISampleScoped, Sample>();
        services.AddSingleton<ISampleSingleton, Sample>();
        // Singleton 也可以用以下方法註冊
        // services.AddSingleton<ISampleSingleton>(new Sample());
    }
}
  • Controller中獲取對應DI實例的HashCode
public class HomeController : Controller
{
    private readonly ISample _transient;
    private readonly ISample _scoped;
    private readonly ISample _singleton;

    public HomeController(
        ISampleTransient transient,
        ISampleScoped scoped,
        ISampleSingleton singleton)
    {
        _transient = transient;
        _scoped = scoped;
        _singleton = singleton;
    }

    public IActionResult Index() {
        ViewBag.TransientId = _transient.Id;
        ViewBag.TransientHashCode = _transient.GetHashCode();

        ViewBag.ScopedId = _scoped.Id;
        ViewBag.ScopedHashCode = _scoped.GetHashCode();

        ViewBag.SingletonId = _singleton.Id;
        ViewBag.SingletonHashCode = _singleton.GetHashCode();
        return View();
    }
}
  • VewBag 顯示組件
<table border="1">
    <tr><td colspan="3">Cotroller</td></tr>
    <tr><td>Lifetimes</td><td>Id</td><td>Hash Code</td></tr>
    <tr><td>Transient</td><td>@ViewBag.TransientId</td><td>@ViewBag.TransientHashCode</td></tr>
    <tr><td>Scoped</td><td>@ViewBag.ScopedId</td><td>@ViewBag.ScopedHashCode</td></tr>
    <tr><td>Singleton</td><td>@ViewBag.SingletonId</td><td>@ViewBag.SingletonHashCode</td></tr>
</table>

可自行做測試,具體可參考此博客

2.2.2 實現了展現層(調用者)與服務類之間的解耦

如上,實例是在HomeController中通過介面來調用實例的,因此修改程式只需要在實例中需改,而不需要在調用層修改。
這符合了6大程式設計原則中的依賴倒置原則:
1.高層模塊不應該依賴於低層模塊,兩者都應該依賴其抽象
展現層Controller沒有依賴Model層Sample類,兩者都依賴了Sample的介面抽象ISample,ISampleTransient,ISampleScoped,ISampleSingleton.
2.抽象不應該依賴於細節
介面層只定義規範,沒有定義細節。

public interface ISample
{
    int Id { get; }
}

public interface ISampleTransient : ISample
{
}

public interface ISampleScoped : ISample
{
}

public interface ISampleSingleton : ISample
{
}

3.細節應該依賴於抽象
DI中取實例依賴於介面:

ISampleTransient transient;

服務類的實現也依賴於介面:

public class Sample : ISampleTransient, ISampleScoped, ISampleSingleton
{
    private static int _counter;
    private int _id;

    public Sample()
    {
        _id = ++_counter;
    }

    public int Id => _id;
}

2.2.3 開發者不用再去考慮依賴之間的關係

使程式員不用再去考慮各個DI實例之間的依賴,以及new很多個相互依賴的實例。

2.3 依賴註入使用的設計模式

2.3.1 代理模式

在依賴註入的服務調用的地方,容器管理者serviceProvider從程式員手中取得控制權,控制所需服務實例化以及設置好他的生命周期,然後返回給程式員。

2.3.2 工廠模式

根據DI的生命周期設置,根據介面或者類型,生產出各種生命周期的實例,需要註意的是這裡有可能是同一實例(scope的單次請求中,或者Transient生命周期),Transient每次產生的都是新的實例。

3.在Net Core 3.1上基於winform實現依賴註入

3.1 Net Core 3.1中對winform的支持。

筆者發現在最新的VS發行版中,能創建winform工程,但卻無法打開設計器,也無法打開winform的工具箱。怎麼辦?
微軟官方博客中提到在VS16.5預覽版中支持了winform設計器,根據博客中提到,需要在此下載鏈接下載VS16.5預覽版。

NetCore3.1 winform截圖如下:

可以看到控制項明顯比基於dot Net Framework的好看很多,同時,工具箱中的控制項很少,微軟把一些老的已經有替代的控制項刪除了,並且以後會慢慢加入一些必要的控制項。

3.2 winform依賴註入與net core MVC的不同?

net core MVC容器是自動創建好的,只需要在ConfigureServices方法里配置服務即可。而在Net Core3.1上創建了winform工程之後窗體是new實例,以單例的形式跑的。容器的配置創建,都需要自己來做。

    static class Program
    {
        /// <summary>
        ///  The main entry point for the application.
        /// </summary>
        [STAThread]
        static void Main()
        {
            Application.SetHighDpiMode(HighDpiMode.SystemAware);
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new Form1());
        }
    }

那如果需要向Form窗體中註入服務就需要在new實例的時候就傳入實參。

[STAThread]
  static void Main()
  {
      Application.SetHighDpiMode(HighDpiMode.SystemAware);
      Application.EnableVisualStyles();
      Application.SetCompatibleTextRenderingDefault(false);
 
      var services = new ServiceCollection();
 
      ConfigureServices(services);
 
      using (ServiceProvider serviceProvider = services.BuildServiceProvider())
      {
          var logg = services.BuildServiceProvider().GetRequiredService<ILogger<Form1>>();
 
          var businessObject = services.BuildServiceProvider().GetRequiredService<IBusinessLayer>();
 
          Application.Run(new Form1(logg, businessObject));
      }
  }

調用的時候用窗體的構造函數調用服務介面即可。

public partial class Form1 : Form
    {
        private readonly ILogger _logger;
 
        private readonly IBusinessLayer _business;
        public Form1(ILogger<Form1> logger, IBusinessLayer business)
        {
            _logger = logger;
            _business = business;
            InitializeComponent();
        }
 
        private void button1_Click(object sender, EventArgs e)
        {
            try
            {
                _logger.LogInformation("Form1 {BusinessLayerEvent} at {dateTime}", "Started", DateTime.UtcNow);
 
                // Perform Business Logic here 
                _business.PerformBusiness();
 
                MessageBox.Show("Hello .NET Core 3.0 . This is First Forms app in .NET Core");
 
                _logger.LogInformation("Form1 {BusinessLayerEvent} at {dateTime}", "Ended", DateTime.UtcNow);
 
            }
            catch (Exception ex)
            {
                //Log technical exception 
                _logger.LogError(ex.Message);
                //Return exception repsponse here
                throw;
 
            }
 
        }
    }

本方法摘自此文

這樣至少有兩個缺點:

  1. Form1中構造函數的依賴註入實例調用泄露在了他的調用層,這不符合6大程式設計原則中的依賴倒置原則;
  2. 當Form1中需要從DI中增加介面實例調用時,也需要在如下調用代碼中增加對應實參。而且實參多了,會很冗長。
    Application.Run(new Form1(logg, businessObject));

    3.3 解決3.2的思路

    把form的類型也以單例的形式註入到容器中,調用時,獲取MainForm類型的服務。這樣此服務實例依賴於其他的服務。ServiceProvider容器管理者會自動解決好服務之間的依賴關係,並將對應的服務實例化並根據生命周期設置好,交給程式員去使用。問題完美解決。

此思路有借鑒於以下兩篇文章
微軟MSDN
stackoverflow
這裡向大家重點推薦下stackoverflow,這個基於世界級的程式員論壇,在我遇到很多的疑難雜症,孤立無援的時候,他都會給予我解決問題的思路,方向甚至方案,再次致敬感謝stackoverflow,同時也感謝谷歌。

3.4代碼實現

3.4.1 在Program.cs中建立服務註冊靜態方法

        private static void ConfigureServices(ServiceCollection services)
        {
            //App
            services.ApplicationServiceIoC();
            //Infra

            //Repo
            services.InfrastructureORM<DapperIoC>();


            //Presentation 其他的窗體也可以註入在此處
            services.AddSingleton(typeof(MainForm));
        }

這裡需要說明的是,筆者這裡的IoC是應用層,展現層,倉儲層分層註入了,每層都寫了ServiceCollection服務容器的靜態方法,所以服務可以在各層註入,讀者可以不去追究,將自己的服務註入在此即可。
分層註入:

分層註入簡單實現
CameraDM_Service註冊在了ApplicationServiceIoC,ApplicationServiceIoC註冊在了ConfigureServices。這就是我剛說的分層註入每層的依賴。

    public static class ServicesIoC
    {
        public static void ApplicationServiceIoC(this IServiceCollection services)
        {
            services.AddScoped(typeof(IServiceBase<>), typeof(ServiceBase<>));
            services.AddScoped<ICameraDM_Service, CameraDM_Service>();
        }
    }

重點關註
將窗體類型註入,當然後續加入其它窗體也可用同樣方法進行註入。

services.AddSingleton(typeof(MainForm));

3.4.2 創建服務容器對象

var services = new ServiceCollection();

3.4.3 添加服務註冊

 ConfigureServices(services);

此步驟調用的就是3.4.1中的方法。

3.4.4 構建ServiceProvider對象

  var serviceProvider = services.BuildServiceProvider();

3.4.5 運行MainForm服務

向服務管理者請求MainForm類型的實例服務,具體調用過程詳見2.1。

Application.Run(serviceProvider.GetService<MainForm>()); 

這一步是重點,也是winform跟MVC使用上的區別,但是本質卻是相同的,都是由serviceProvider管理著WPF,winform或者MVC這些實例以及他們對應的類型,只不過MVC容器已經創建好了,容器管理者serviceProvider也已經創建好了,直接往容器里Add服務即可,而winform,WPF,net core控制台程式需要我們自己去往容器里添加註冊服務,並且創建容器管理者serviceProvider。因為ServiceCollection容器是死的,只有創建了serviceProvider容器管理者這個代理角色,容器才能體現出他的價值。而只有serviceProvider,沒有ServiceCollection里的服務也是毫無意義的。

3.4.1到3.4.5整體代碼如下:

    static class Program
    {
        /// <summary>
        ///  The main entry point for the application.
        /// </summary>
        [STAThread]
        static void Main()
        {
            Application.SetHighDpiMode(HighDpiMode.SystemAware);
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            //創建服務容器對象
            var services = new ServiceCollection();

            //添加服務註冊
            ConfigureServices(services);
            //構建ServiceProvider對象
            var serviceProvider = services.BuildServiceProvider();
            //向服務管理者請求MainForm類型的實例服務
            Application.Run(serviceProvider.GetService<MainForm>());    
        }
        private static void ConfigureServices(ServiceCollection services)
        {
            //App
            services.ApplicationServiceIoC();
            //Infra

            //Repo
            services.InfrastructureORM<DapperIoC>();


            //Presentation 其他的窗體也可以註入在此處
            services.AddSingleton(typeof(MainForm));
        }
    }

3.4.6構造函數法調用DI實例

    public partial class MainForm : Form
    {
        ICameraDM_Service _cameraDM_Service;
        public MainForm(ICameraDM_Service cameraDM_Service)
        {
            _cameraDM_Service = cameraDM_Service;
            InitializeComponent();          
        }
        private async void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show(_cameraDM_Service.GetAllCameraInfo().ToList().Count().ToString());
            var _camera  =await _cameraDM_Service.GetAllIncludingTasksAsync();
            //textBox1.Text = _camera.ToList().Count().ToString();
            var _cameraNo3 = await _cameraDM_Service.GetByIdAsync(3);
            textBox1.Text = _cameraNo3.InstallTime.ToString();
        }
    }

3.5演示效果

點擊按鈕之後從攝像頭服務中獲取到了攝像頭的數量。

點擊確定之後從攝像頭服務中獲取到了3號攝像頭的安裝時間。

4.最後

本來就想寫篇短文,誰知道洋洋灑灑還寫得有點長。本文如果大家讀了有疑惑,請提出來,我會耐心解答;如果知識點上有不妥當不正確或者不同見解的地方,也懇請指出,我同時也很渴望進步。最後祝大家冬至安康,闔家幸福。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • "5292. 劃分數組為連續數字的集合" 給你一個整數數組 和一個正整數 k,請你判斷是否可以把這個數組劃分成一些由 k 個連續數字組成的集合。 如果可以,請返回 True;否則,返回 False。 題目表述為集合,不是數組。 =__= 分析: 需要將數組按照k個一組劃分。所以一共有 個集合。如果不 ...
  • 瞭解來這麼久許可權控制許可權的知識,卻不知道如何寫代碼,網上的代碼多數並沒有多少完整的源碼能提供參考。偶然看到官網的例子,現在終於也把源碼的實現也弄得明白了一點。 tp5框架的Auth類可以實現頁面的訪問許可權,還可以精確到頁面上的按鈕。頁面訪問主要靠rule表的name欄位。附加條件許可權主要看condi ...
  • Indellij IDEA的菜單 File Edit View等主菜單欄不小心刪除,恢復的解決辦法 ...
  • 本節主要介紹在上一節中通過搭建基架而創建的Razor頁面,並做一些UI改變。 一、創建、刪除、詳細信息和編輯頁面 1、雙擊Pages/Movies/Index.cshtml.cs文件,這是一個Razor頁面模型: ① 第13行:表示該Razor頁面派生自PageModel。約定:PageModel派 ...
  • 首先說一下,這個項目框架是使用ASP.NET MVC搭建的,訪問資料庫這塊,是使用我自己封裝的c#代碼生成器生成的代碼,整個資料庫操作,全是通過代碼生成器生成的代碼來執行的,我只需要關心業務邏輯即可, 那麼這個項目的最初想法其實就是想搭建一個公用的後臺管理系統模塊,然後在這個模塊的基礎之上,可以開發 ...
  • 1.通過流的方式 1 public void WriteLog(string log) 2 { 3 StreamWriter stream; 4 string path = "D:/WriteLog/"; 5 if (!Directory.Exists(path)) 6 { 7 Directory. ...
  • 一、概念講解: 1、值類型: 包括:sbyte、short、int、long、float、double、decimal(以上值類型有符號) byte、ushort、uint、ulong(以上值類型無符號) bool、char 2、引用類型: 包括:對象類型、動態類型、字元串類型 二、具體區別: 1、 ...
  • 將表的行列倒置顯示(透視變換) 1)、創建數據表並添加數據 create table Score ( 學號 nvarchar(10) ,課程 nvarchar(10) ,成績 nvarchar(10) ); insert into Score(學號,課程,成績)values('0001','語文', ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...