ABP開發框架前後端開發系列---（14）基於Winform的ABP快速開發框架

前面介紹了很多ABP系列的文章，一步一步的把我們日常開發中涉及到的Web API服務構建、登錄日誌和操作審計日誌、字典管理模塊、省份城市的信息維護、許可權管理模塊中的組織機構、用戶、角色、許可權、菜單等內容，以及配置管理模塊，界面的高級查詢處理等內容，同時我們把整個開發理念結合我們的代碼生成工具Data... ...

前面介紹了很多ABP系列的文章，一步一步的把我們日常開發中涉及到的Web API服務構建、登錄日誌和操作審計日誌、字典管理模塊、省份城市的信息維護、許可權管理模塊中的組織機構、用戶、角色、許可權、菜單等內容，以及配置管理模塊，界面的高級查詢處理等內容，同時我們把整個開發理念結合我們的代碼生成工具Database2Sharp進行快速的開發，快速開發分為兩個部分：一個是Web API部分的ABP框架代碼生成，包括領域實體層、應用服務層、公用DTO和介面層、API調用Caller層等內容的生成，並且整合了我們封裝的基類，以便生成的代碼更加簡潔，但卻具有更加強大、易用的功能函數；另一個快速生成的部分是界面生成，我們根據我們在Winform領域多年的開發，整合了分頁、公用類庫和Winform基礎界面類的基礎上實現了快速的Winform界面生成，並且Winform界面生成可以根據需要配置列表查詢條件、列表顯示內容，編輯界面的欄位顯示等等內容，並且生成的Winform界面自動具有和ABP快速框架整體調用通用規則。

1、ABP框架背景知識介紹

ABP是ASP.NET Boilerplate的簡稱，ABP是一個開源且文檔友好的應用程式框架。ABP不僅僅是一個框架，它還提供了一個最徍實踐的基於領域驅動設計(DDD)的體繫結構模型。學習使用ABP框架也有一段時間了,一直想全面瞭解下這個框架的整個來龍去脈，並把想把它使用歷程整理成一個系列出來，不過一直沒有下筆來寫這篇文章的開篇，就是希望能夠深入瞭解，再深入瞭解一些，希望自己能夠理解透徹一些，不能誤人子弟，也不想和網上千篇一律的翻譯官網的內容，官網的英文介紹也已經很詳細了，於是我覺得還是以實際使用的過程進行一定的整理會更好。

初次瞭解ABP框架，對它還是非常驚艷的，它基本上是.NET 領域架構的集大成者，幾乎囊括了我們.NET領域排的上名的各種技術應用，而且它本身可以支持.net framework和.net core兩種技術流派，對它的介紹也是非常感興趣。

1）ABP框架的特點

我們來大概瞭解下ABP框架涉及到的內容。

依賴註入，這個部分使用 Castle windsor （依賴註入容器）來實現依賴註入，這個也是我們經常使用IOC來處理的方式；
Repository倉儲模式，已實現了Entity Framework、NHibernate、MangoDB、記憶體資料庫等，倉儲模式可以快速實現對數據介面的調用；
身份驗證與授權管理，可以使用聲明特性的方式對用戶是否登錄，或者介面的許可權進行驗證，可以通過一個很細粒度的方式，對各個介面的調用許可權進行設置；
數據有效性驗證，ABP自動對介面的輸入參數對象進行非空判斷，並且可以根據屬性的申請信息對屬性的有效性進行校驗；
審計日誌記錄，也就是記錄我們對每個介面的調用記錄，以及對記錄的創建、修改、刪除人員進行記錄等處理；
Unit Of Work工作單元模式，為應用層和倉儲層的方法自動實現資料庫事務，預設所有應用服務層的介面，都是以工作單元方式運行，即使它們調用了不同的存儲對象處理，都是處於一個事務的邏輯裡面；
異常處理，ABP框架提供了一整套比較完善的流程處理操作，可以很方便的對異常進行進行記錄和傳遞；
日誌記錄，我麽可以利用Log4Net進行常規的日誌記錄，方便我們跟蹤程式處理信息和錯誤信息；
多語言/本地化支持，ABP框架對多語言的處理也是比較友好的，提供了對XML、JSON語言信息的配置處理；
Auto Mapping自動映射，這個是ABP的很重要的對象隔離概念，通過使用AutoMaper來實現域對象和DTO對象的屬性映射，可以隔離兩者的邏輯關係，但是又能輕鬆實現屬性信息的賦值；
動態Web API層，利用這個動態處理，可以把Application Service 直接發佈為Web API層，而不需要在累贅的為每個業務對象手工創建一個Web API的控制器，非常方便；
動態JavaScript的AJax代理處理，可以自動創建Javascript 的代理層來更方便使用Web Api，這個在Web層使用。

除了這些重要特性外，ABP框架還有很多一些特別的功能或者概念。

多租戶支持（每個租戶的數據自動隔離，業務模塊開發者不需要在保存和查詢數據時寫相應代碼；
軟刪除支持（繼承相應的基類或實現相應介面，會自動實現軟刪除）
系統設置存取管理（系統級、租戶級、用戶級，作用範圍自動管理）
EventBus實現領域事件(Domain Events)
模塊以及模塊的依賴關係實現插件化的模塊處理等等

ABP框架主要還是基於領域驅動的理念來構建整個架構的，其中領域驅動包含的概念有域對象Entities、倉儲對象Repositories、域服務介面層Domain Services、域事件Domain Events、應用服務介面Application Services、數據傳輸對象DTOs等。

ABP官方網站：http://www.aspnetboilerplate.com，從裡面可以查看很詳細的案例和文檔說明，可以根據需要下載不同類型的基礎框架。

ABP GitHub源碼地址：https://github.com/aspnetboilerplate，可以下載整個基礎的框架內容，以及相關的樣板案例代碼。

基於ABP框架基礎上，我們整理完善了整個許可權體系，以及基於這個基礎上進行的業務系統快速開發，我們整理後的ABP快速開發框架的架構圖示，如下圖所示（以字典模塊為例說明）

針對Web API介面調用的封裝，為了適應客戶端快速調用的目的，這個封裝作為一個獨立的封裝層，以方便各個模塊之間進行共同調用。

2、基於Winform的ABP快速開發框架功能介紹

1）登陸界面

2）主體框架界面

主體框架界面採用的是基於菜單的動態生成，以及多文檔的界面佈局，具有非常好的美觀性和易用性。

左側的功能樹列表和頂部的菜單模塊，可以根據角色擁有的許可權進行動態構建，不同的角色具有不同的菜單功能點，如下是測試用戶登錄後具有的界面。

3）用戶管理界面

用戶列表包括分頁查詢、導入、導出用戶數據，以及可以利用右鍵菜單進行新增、編輯用戶記錄，或者對指定用戶進行重置密碼操作。

用戶編輯界面如下所示。

當然可以查看這個用戶本身擁有的許可權功能點，如下界面所示。

用戶數據導入，可以根據指定模板的格式進行填寫後，然後導入指定的文件內容，如下所示。

導出文件則是把列表中現有的數據進行導入，導出後提示是否打開Excel文件進行查看。

4）組織機構管理

組織機構主要就是一個層級的對象關係，一般包含但不限於公司、部門、工作組等的定義，其中組織機構包含用戶成員和角色成員的關係，如下界面所示。

組織機構的樹形列表可以進行拖動實現不同層級的變化

或者通過右鍵菜單進行編輯修改操作

組織機構可以修改機構名稱和對應的父類節點，如下界面所示。

組織機構包含的成員可以添加多個人員記錄，添加界面如下所示。

添加角色界面如下所示。

5）角色管理

角色信息沒有層級關係，可以通過列表展示。

其中角色包含許可權分配、角色成員和擁有菜單的維護，如下是角色編輯界面，包含角色基本信息、擁有許可權、包含成員、擁有菜單的管理等。菜單對於角色來說，應該是一種界面資源，可以通過配置進行管理對應角色用戶的菜單。

菜單編輯界面如下所示。

角色的許可權包含系統可以用的許可權，並可以勾選為角色設置所需的功能點，如下界面所示。

用戶成員則和機構的用戶管理一樣，可以指定多個用戶，這裡不再贅述。

而菜單對於角色來說，應該是一種界面資源，可以通過配置進行管理對應角色用戶的菜單，如下界面所示。

通過配置好的菜單，用戶登錄系統後，系統根據當前用戶具有的菜單項目，動態構建顯示對應的列表菜單和工具欄菜單。

6）功能管理

嚴格來說，ABP框架並沒有統一管理好許可權功能點的，它沒有任何表來存儲這個功能集合，而是通過派生AuthorizationProvider的子類來定義許可權功能點

我在這個基礎上引入了一個許可權功能的表用來存儲功能點的，然後提供管理界面來動態維護這些功能點。如下界面所示。

我們剛纔在角色裡面看到可以分配的許可權內容，就是基於這個許可權表的信息展示。

這樣我們可以動態添加或者批量添加所需要的功能點，並且和整個許可權管理模塊串聯起來，形成一個完整的控制體系。

另外我們還可以通過左側樹列表的右鍵菜單管理列表，如下所示可以級聯刪除對應的節點及其下麵所有子節點。

系統登錄後，客戶端自動獲取對應用戶的角色功能點，然後我們每次打開一個新的業務窗體，客戶端會進行界面的許可權邏輯控制，如果沒有許可權的，那麼不可以訪問操作，如下是禁止了產品信息的導入、導出、新增、編輯等操作功能，如下界面所示產品界面被動態取消相關許可權後，界面禁止了某些操作功能。

7）菜單管理

Winform主界面的開發，基本上都是標準的界面，在頂部放置工具欄，中間區域則放置多文檔的內容，但是在頂部菜單比較多的時候，就需要把菜單分為幾級處理，如可以在頂部菜單放置一二級菜單，這種方式在一般功能點不算太多的情況下，呈現的界面效果較為直觀、也較為美觀。不過隨著一些系統功能的增多，這種方式可能就會顯得工具欄比較擁擠，那麼我們是否可以在左側放置一個樹形列表，這樣通過樹形列表的收縮摺疊，就可以放置非常多的菜單功能了。

在ABP快速開發框架裡面，我們依舊採用Winform開發框架裡面用到的菜單維護方式，在許可權模塊系統中維護菜單內容，併在用戶登錄系統後，動態載入菜單展示，並通過菜單的配置信息，可以動態展示不同的窗體信息。

菜單資源管理的列表界面界面如下所示