在net Core3.1上基于winform實作依賴注入實體

在net Core3.1上基于winform實作依賴注入實體
1.背景
2.依賴注入
- 2.1依賴注入是什么？
- 2.1依賴注入的目的
- 2.2依賴注入帶來的好處
  - 2.2.1生命周期的控制
    - 2.2.1.1 生命周期測驗舉例
  - 2.2.2 實作了展現層(呼叫者)與服務類之間的解耦
  - 2.2.3 開發者不用再去考慮依賴之間的關系
- 2.3 依賴注入使用的設計模式
  - 2.3.1 代理模式
  - 2.3.2 工廠模式
3.在Net Core 3.1上基于winform實作依賴注入
- 3.1 Net Core 3.1中對winform的支持，
- 3.2 winform依賴注入與net core MVC的不同？
- 3.3 解決3.2的思路
- 3.4代碼實作
  - 3.4.1 在Program.cs中建立服務注冊靜態方法
  - 3.4.2 創建服務容器物件
  - 3.4.3 添加服務注冊
  - 3.4.4 構建ServiceProvider物件
  - 3.4.5 運行MainForm服務
  - 3.4.6建構式法呼叫DI實體
- 3.5演示效果
- 3.6 如何呼叫用依賴注入在母表單中呼叫子表單
  - 3.6.1 注入子表單
  - 3.6.2 設定全域serviceProvider容器服務管理者
  - 3.6.3 MainForm中呼叫Form1
  - 3.6.4 建構式法呼叫DI實體
  - 3.6.5效果
4.最后

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;
 
            }
 
        }
    }

本方法摘自此文

這樣至少有兩個缺點：

Form1中建構式的依賴注入實體呼叫泄露在了他的呼叫層，這不符合6大程式設計原則中的依賴倒置原則；
當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號攝像頭的安裝時間，

3.6 如何呼叫用依賴注入在母表單中呼叫子表單

3.6屬于12/23/13:33新增，為了答復1樓網友編程老油條所問問題，
問題如下：
假設在MainForm中的button1_Click，還需要打開其他視窗，要如何實作？（只能往 MainForm 中傳遞serviceProvider嗎？）

把serviceProvider設計成全域靜態的，可設計成單例模式或直接放在Main的屬性中，供全域任意子表單訪問獲取DI實體即可，當然同時，其他表單也需要注入到容器中，

3.6.1 注入子表單

注入生命周期為瞬時的Form1型別，
services.AddTransient(typeof(Form1));

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

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

            //Presentation 其他的表單也可以注入在此處
            services.AddSingleton(typeof(MainForm));
            services.AddTransient(typeof(Form1));
            
        }

因為Form1是MainForm的子表單，而MainForm設定成了單例模式，所以在MainForm中打開Form1是屬于同一次請求，姑不能用AddSingleton跟AddScope模式，如果使用以上兩種模式，會報如下例外：
比如設定Form1生命周期為單例模式

            services.AddSingleton(typeof(MainForm));
            services.AddSingleton(typeof(Form1));

第一次呼叫正常，

關閉Form1第二次點擊MainForm的button1時，報如下例外：

因為是單例模式，我們關閉了Form1，MainForm還在，再次點擊button1,會找不到生命周期是單例模式的Form1實體，就會報如上例外，
修改成

services.AddTransient(typeof(Form1));

問題得到完美解決，無論關閉多少次Form1，都能通過MainForm的button1呼叫打開Form1，

3.6.2 設定全域serviceProvider容器服務管理者

修改serviceProvider為Program靜態類的公用屬性（全域），以給子表單或其他winform中的組件來容器服務者獲取DI實體
public static IServiceProvider serviceProvider { get; set; }
Program.cs全部代碼如下，

    static class Program
    {
        public static IServiceProvider serviceProvider { get; set; }
        /// <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物件
            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));
            services.AddTransient(typeof(Form1));

        }
    }

3.6.3 MainForm中呼叫Form1

到Program服務管理者屬性手中拿到對應所需型別的設定好生命周期的Form1實體，顯示Form1，

    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();          
        }

        private async void button1_Click(object sender, EventArgs e)
        {
            var child = (Form)Program.serviceProvider.GetService((typeof(Form1)));
            child.Show();
        }
    }

3.6.4 建構式法呼叫DI實體

Form1呼叫camera服務
此處同3.5

    public partial class Form1 : Form
    {

        ICameraDM_Service _cameraDM_Service;
        public Form1(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());
        }
    }

3.6.5效果

4.最后

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

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

標籤：其他

上一篇：openstack 使用官方centos7通用云鏡像創建實體后不能用crt等工具登錄

下一篇：Linux服務器部署.Net Core筆記：目錄