在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;
}
}
}
本方法摘自此文
這樣至少有兩個缺點:
- 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號攝像頭的安裝時間。
4.最後
本來就想寫篇短文,誰知道洋洋灑灑還寫得有點長。本文如果大家讀了有疑惑,請提出來,我會耐心解答;如果知識點上有不妥當不正確或者不同見解的地方,也懇請指出,我同時也很渴望進步。最後祝大家冬至安康,闔家幸福。