JHRS

一個(gè)新學(xué)WPF的IT老鳥，肝了2個(gè)月做了這么一個(gè)WPF企業(yè)級(jí)開發(fā)框架，站長clone學(xué)習(xí)，覺得甚是不錯(cuò)。這是一個(gè)使用了Prism搭建的插件式框架，封裝了DataGrid的使用，使整個(gè)框架子模塊簡單易學(xué)、易擴(kuò)展，特別是作者還寫了一個(gè)系列博客教程，值得點(diǎn)贊。

---

下面是作者博文系列首篇：WPF企業(yè)級(jí)開發(fā)框架搭建指南（啟示錄），2020從入門到放棄

---

這個(gè)系列的文章旨在記錄工作中使用WPF開發(fā)新的醫(yī)療項(xiàng)目中，有感于必須統(tǒng)一掉一些規(guī)范上的事情，并且提高團(tuán)隊(duì)開發(fā)效率，遂折騰了這么一個(gè)半吊子的框架，這個(gè)標(biāo)題WPF企業(yè)級(jí)開發(fā)框架搭建指南，2020從入門到放棄可能會(huì)唬住一些人，但看到這些零碎文字的朋友就湊和著看吧，如果能幫助到你，那也榮幸了。

WPF技術(shù)是一個(gè)很不錯(cuò)的技術(shù)，但一直沒有上手過正式的項(xiàng)目，趁在做這個(gè)醫(yī)療項(xiàng)目時(shí)，遂搭建一個(gè)WPF開發(fā)框架，目的是為了統(tǒng)一WPF開發(fā)并提高開發(fā)效率；我對(duì)WPF技術(shù)算是零基礎(chǔ)，現(xiàn)學(xué)現(xiàn)賣，用這些不成體系的文字予以記錄一些想法和實(shí)踐。

WPF企業(yè)級(jí)開發(fā)框架搭建系列文章導(dǎo)航

---

WPF企業(yè)級(jí)開發(fā)框架搭建指南（啟示錄）

JHRS開發(fā)框架之基礎(chǔ)類庫

JHRS開發(fā)框架之第三方框架選型

JHRS開發(fā)框架之WPF調(diào)用Web API封裝

JHRS開發(fā)框架之客戶端入口項(xiàng)目

JHRS開發(fā)框架之各子系統(tǒng)如何整合

JHRS開發(fā)框架之怎樣設(shè)計(jì)合理的ViewModel基類

JHRS開發(fā)框架之公用組件用戶控件的封裝

JHRS開發(fā)框架之建議遵循的一些建目錄文件原則

JHRS開發(fā)框架之WPF數(shù)據(jù)驗(yàn)證

JHRS開發(fā)框架之ViewModel相互傳參和彈框回傳參的解決辦法

JHRS開發(fā)框架之踩坑記（終章）

WPF管理系統(tǒng)開發(fā)框架設(shè)計(jì)圖

---

在正式開始WPF開發(fā)框架搭建之前，做了一些技術(shù)選型和在群里面咨詢了下對(duì)WPF技術(shù)比較了解的群友，當(dāng)中就屬dotnet9.com的站長經(jīng)常被筆者叨擾。先來說說我期望中的開發(fā)框架要實(shí)現(xiàn)哪些功能。

在開始搭建之前呢，還是晾一下最終的架構(gòu)圖吧。

WPF基于WEB API開發(fā)管理系統(tǒng)框架

上圖就是折騰出來的一個(gè)框架，圖不美觀的話，大伙也就湊合著看吧。下圖是解決方案：

框架解決方案

• 開源地址：https://github.com/jhrscom/jhrs

• 官方博客：https://jhrs.com

• 用到插件：https://marketplace.visualstudio.com/items?itemName=PeterSpa.XamlBinding

開發(fā)環(huán)境

---

因?yàn)轫?xiàng)目是使用WPF來開發(fā)的，自然基于【MVVM】的理念搭建了這么一個(gè)快速開發(fā)框架，適用于開發(fā)【傳統(tǒng)類型的管理系統(tǒng)】，并通過調(diào)用web api的方式來完成所有的業(yè)務(wù)操作，在WPF的Page，窗體（Window），用戶控件的后置代碼，幾乎不會(huì)有任何的業(yè)務(wù)代碼，除了一些控制界面行為的功能。

在搭建這個(gè)框架時(shí)，是基于最新的?【 .net 5】用的技術(shù)版本是比較新的，演示代碼中，wpf也是使用 .net 5。

采用.NET 5開發(fā)

使用技術(shù)說明

• 技術(shù)平臺(tái)：.Net 5.0

• 技術(shù)框架：WPF + Prism+ AspectInjector + Refit

• IoC組件：Prism自帶Prism.Unity

• 數(shù)據(jù)序列化：Newtonsoft.Json，可替換

• 日志記錄：系統(tǒng)自帶

解決方案詳解

---

解決方案從上到下依次為：

JHRS.Core（客戶端業(yè)務(wù)核心）

客戶端業(yè)務(wù)核心

在JHRS.Core這個(gè)庫里面，各個(gè)目錄功能說明如下：

Aop：實(shí)現(xiàn)了一個(gè)點(diǎn)擊按鈕顯示轉(zhuǎn)圈圈效果的類，一般用于加載數(shù)據(jù)，點(diǎn)擊按鈕從服務(wù)器獲取數(shù)據(jù)讓用戶等侯片刻。

Apis：保存著代碼生成工具【JHRS.GenerateAPI】自動(dòng)生成的接口，該工具可以在線解析swagger生成供調(diào)用的接口，參見這里（使用該工具需要設(shè)置swagger地址，另外有bug的話，自己修改下就可以了）。

Controls：定義了WPF界面使用的公用控件（保存在Controls目錄），如通用表格（DataGrid），下拉框等，凡公用的控件，都可以保存在此目錄。

Enums：公用的枚舉，各個(gè)模塊可以引用。

Events：事件類，Prism自帶事件總線，相應(yīng)的事件類在這個(gè)目錄創(chuàng)建，具體應(yīng)用參見這里。

Extensions：擴(kuò)展類

Identity：身份認(rèn)證，即登錄系統(tǒng)后，從服務(wù)器端獲取到的身份認(rèn)證會(huì)話信息（用戶，token等）。

Models：各個(gè)模塊的DTO對(duì)象，一般是根據(jù)swagger解析出各個(gè)接口的實(shí)體對(duì)象（輸入，輸出DTO）。

Modules：模塊的輔助類。

ViewModels：這個(gè)目錄里面定義了ViewModel的基類，處理各個(gè)功能Page業(yè)務(wù)的ViewModel類，需要從這里繼承對(duì)應(yīng)的類，如管理頁面繼承BaseManagePageViewModel，而新增編輯頁面繼承BaseDialogPageViewModel類等。并且在基類里面定義了公共方法，如消息提示框，消息彈框，打開模態(tài)窗口等，效果見下方所示。

JHRS.Shell（WPF客戶端入口程序）

WPF客戶端入口程序

JHRS.Shell是WPF客戶端項(xiàng)目的入口程序，并且定義了整個(gè)系統(tǒng)公用的消息提示框，模態(tài)窗口風(fēng)格，主窗口等；登錄的入口也是在這里定義的，登錄系統(tǒng)后，可以自行實(shí)現(xiàn)權(quán)限功能加只加載對(duì)應(yīng)的子模塊（子系統(tǒng)）；在程序啟動(dòng)時(shí)，會(huì)自動(dòng)做一些初始化操作，掃描程序集自動(dòng)注入相關(guān)功能，具體實(shí)現(xiàn)參見這里。

消息提示框

消息提示框

消息彈框

消息彈框

確認(rèn)消息框

確認(rèn)消息框

模態(tài)窗口

模態(tài)窗口

遮罩層效果（蒙層效果或Loading效果）

遮罩層效果一般用于點(diǎn)擊按鈕，加載數(shù)據(jù)時(shí)使用，即調(diào)用接口到數(shù)據(jù)呈現(xiàn)中間有一個(gè)等待的過程，就可以顯示出來，因此在框架中通過AOP方式封裝了這么一個(gè)效果，調(diào)用時(shí)在相關(guān)的地方標(biāo)記一個(gè)特性即可。先來看看效果。

遮罩層效果

該效果是直接從CSDN摳過來的，然后整到到代碼里面去的，純演示目的。

參考鏈接：https://blog.csdn.net/lhx527099095/article/details/8005095

modules解決方案文件夾

modules解決方案文件夾

在modules這個(gè)解決方案文件夾里面的是各個(gè)子模塊，也就是各個(gè)子系統(tǒng)，例如【JHRS.OutpatientSystem】是WPF項(xiàng)目的子系統(tǒng)之一（門診模塊）；在各子系統(tǒng)中，最外層擁有一個(gè)Module的類（OutpatientSystemModule），需要實(shí)現(xiàn)IModule接口供Prism自動(dòng)掃描注冊(cè)到容器里面。

在子模塊中，目錄的組織原則如下。

目錄組織原則

|----- JHRS.OutpatientSystem 命名規(guī)則：【JHRS】點(diǎn)【模塊名稱】 |----- Controls 表示當(dāng)前模塊的控件庫存放目錄 | |------- Manager 子目錄 | |------- SysManager 子目錄 | |--------其它子目錄 |------ Extensions 當(dāng)前模塊擴(kuò)展類 |------ Model 當(dāng)前模塊實(shí)體，如查詢條件實(shí)體 |------ ViewModels 【固定命名，不能改動(dòng)】 | |------ScheduManager 各管理功能目錄 | |--------XXXXViewModel.cs 每個(gè)功能頁面的ViewModel類 | |--------其它ViewModel.cs 其它頁面的ViewModel |-------Views 【W(wǎng)PF頁面，固定命名】 | |------ ScheduManager 功能目錄 | |------XXXXXXX.xaml WPF頁面 | |------XXXXXXX.xaml WPF頁面 | |-------SysManager 功能目錄 |------- OutpatientSystemModule 命名：模塊名稱+Module

在每一個(gè)子系統(tǒng)中，最外層的一個(gè)模塊類，名稱規(guī)則為：【模塊名稱+Module】，編寫這個(gè)類是為了使用Prism加載這個(gè)模塊。

JHRS（基礎(chǔ)類庫）

JHRS（基礎(chǔ)類庫）

基礎(chǔ)類庫，可以任意擴(kuò)展，該庫可以供其它所有庫引用。

JHRS.GenerateAPI（代碼生成工具）

該工具是在線解析swagger生成供Refit調(diào)用的接口，生成的接口如下：

接口

調(diào)用接口的示例代碼如下：

var response = await RestService.For<ILoginApi>(baseUrl).Login(CurrentUser);if (!response.Succeeded){ Alert(response.Message); return;}

最后

---

對(duì)于WPF開發(fā)來說，我并不是很熟悉，這段時(shí)間以來一直網(wǎng)上學(xué)習(xí)和借鑒一些開源的框架，再結(jié)合實(shí)際項(xiàng)目而整出來的這個(gè)開發(fā)框架；可能對(duì)于從事WPF開發(fā)的朋友來說有一定的借鑒意義。

完整的項(xiàng)目代碼已經(jīng)開源到github上面。在這個(gè)項(xiàng)目中，并不包含web api的項(xiàng)目。

• 開源地址：https://github.com/jhrscom/jhrs

• 官方博客：https://jhrs.com

總結(jié)

以上是生活随笔為你收集整理的推荐一个IT老鸟肝了2月有余的免费开源WPF企业级开发框架的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。