我們來大概了解下ABP框架涉及到的內容。
除了這些重要特性外,ABP框架還有很多一些特別的功能或者概念。
ABP框架主要還是基于領域驅動的理念來構建整個架構的,其中領域驅動包含的概念有 域對象Entities、倉儲對象Repositories、域服務接口層Domain Services、域事件Domain Events、應用服務接口Application Services、數據傳輸對象DTOs等。
基于ABP框架基礎上,我們整理完善了整個權限體系,以及基于這個基礎上進行的業務系統快速開發,我們整理后的ABP快速開發框架的架構圖示,如下圖所示(以字典模塊為例說明)
針對Web API接口調用的封裝,為了適應客戶端快速調用的目的,這個封裝作為一個獨立的封裝層,以方便各個模塊之間進行共同調用。
1)登陸界面
2)主體框架界面
主體框架界面采用的是基于菜單的動態生成,以及多文檔的界面布局,具有非常好的美觀性和易用性。
左側的功能樹列表和頂部的菜單模塊,可以根據角色擁有的權限進行動態構建,不同的角色具有不同的菜單功能點,如下是測試用戶登錄后具有的界面。
3)用戶管理界面
用戶列表包括分頁查詢、導入、導出用戶數據,以及可以利用右鍵菜單進行新增、編輯用戶記錄,或者對指定用戶進行重置密碼操作。
用戶編輯界面如下所示。
當然可以查看這個用戶本身擁有的權限功能點,如下界面所示。
用戶數據導入 ,可以根據指定模板的格式進行填寫后,然后導入指定的文件內容,如下所示。
導出文件則是把列表中現有的數據進行導入,導出后提示是否打開Excel文件進行查看。
4)組織機構管理
組織機構主要就是一個層級的對象關系,一般包含但不限于公司、部門、工作組等的定義,其中組織機構包含用戶成員和角色成員的關系,如下界面所示。
組織機構的樹形列表可以進行拖動實現不同層級的變化
或者通過右鍵菜單進行編輯修改操作
組織機構可以修改機構名稱和對應的父類節點,如下界面所示。
組織機構包含的成員可以添加多個人員記錄,添加界面如下所示。
添加角色界面如下所示。
5)角色管理
角色信息沒有層級關系,可以通過列表展示。
其中角色包含權限分配、角色成員和擁有菜單的維護,如下是角色編輯界面,包含角色基本信息、擁有權限、包含成員、擁有菜單的管理等。菜單對于角色來說,應該是一種界面資源,可以通過配置進行管理對應角色用戶的菜單。
菜單編輯界面如下所示。
角色的權限包含系統可以用的權限,并可以勾選為角色設置所需的功能點,如下界面所示。
用戶成員則和機構的用戶管理一樣,可以指定多個用戶,這里不再贅述。
而菜單對于角色來說,應該是一種界面資源,可以通過配置進行管理對應角色用戶的菜單,如下界面所示。
通過配置好的菜單,用戶登錄系統后,系統根據當前用戶具有的菜單項目,動態構建顯示對應的列表菜單和工具欄菜單。
6)功能管理
嚴格來說,ABP框架并沒有統一管理好權限功能點的,它沒有任何表來存儲這個功能集合,而是通過派生AuthorizationProvider的子類來定義權限功能點
我在這個基礎上引入了一個權限功能的表用來存儲功能點的,然后提供管理界面來動態維護這些功能點。如下界面所示。
我們剛才在角色里面看到可以分配的權限內容,就是基于這個權限表的信息展示。
這樣我們可以動態添加或者批量添加所需要的功能點,并且和整個權限管理模塊串聯起來,形成一個完整的控制體系。
另外我們還可以通過左側樹列表的右鍵菜單管理列表,如下所示可以級聯刪除對應的節點及其下面所有子節點。
系統登錄后,客戶端自動獲取對應用戶的角色功能點,然后我們每次打開一個新的業務窗體,客戶端會進行界面的權限邏輯控制,如果沒有權限的,那么不可以訪問操作,如下是禁止了產品信息的導入、導出、新增、編輯等操作功能,如下界面所示產品界面被動態取消相關權限后,界面禁止了某些操作功能。
7)菜單管理
Winform主界面的開發,基本上都是標準的界面,在頂部放置工具欄,中間區域則放置多文檔的內容,但是在頂部菜單比較多的時候,就需要把菜單分為幾級處理,如可以在頂部菜單放置一二級菜單,這種方式在一般功能點不算太多的情況下,呈現的界面效果較為直觀、也較為美觀。不過隨著一些系統功能的增多,這種方式可能就會顯得工具欄比較擁擠,那么我們是否可以在左側放置一個樹形列表,這樣通過樹形列表的收縮折疊,就可以放置非常多的菜單功能了。
在ABP快速開發框架里面,我們依舊采用Winform開發框架里面用到的菜單維護方式,在權限模塊系統中維護菜單內容,并在用戶登錄系統后,動態加載菜單展示,并通過菜單的配置信息,可以動態展示不同的窗體信息。
菜單資源管理的列表界面界面如下所示
左側列表依舊可以通過右鍵菜單進行維護管理。
雙擊樹列表或者右側的列表,都可以對已有的菜單進行編輯,菜單編輯界面如下所示。
我們可以通過選擇圖標按鈕進行菜單圖標的選擇,如下是選擇菜單圖片的界面。
這樣我們可以采用DevExpress內置漂亮的系統圖標,也可選擇系統文件里面的圖標文件。
如果用戶登錄系統后,覺得自己管理的菜單有些多,那么可以通過菜單配置的方式,選擇性的呈現某些菜單,把其他部分的菜單隱藏起來,這個就是自定義應用菜單界面,界面如下所示。
8)系統登錄日志
登錄日志,這個就是用戶嘗試登錄的時候,留下的記錄信息,其中包括用戶的登錄用戶名,ID,IP地址、登錄時間,以及登錄是否成功的狀態等信息。
這個登錄日志,就是在系統登錄嘗試的時候,留下的記錄,可供管理員進行跟蹤了解某個賬戶的使用情況,也可以根據這些登錄信息進行一個統計報表的分析。
9)系統審計日志
審計日志,設置我們在訪問或者調用某個應用服務層接口的時候,橫切面流下的一系列操作記錄,其中記錄我們訪問的服務接口,參數,客戶端IP地址,訪問時間,以及異常等信息,這些操作都是在ABP系統自動記錄的,如果我們需要屏蔽某些服務類或者接口,則這些就不會記錄在里面,否則默認是記錄的。
審計日志的明細展示界面如下所示。
10)字典管理
字典管理界面,左側列出字典類型,并對字典類型下的字典數據進行分頁展示,右側則利用分頁展示對應字典類型的字典數據,字典管理界面如下所示。
新增或者編輯窗體界面如下
批量添加字典內容的界面如下所示。
省份城市行政區的模塊管理,也主要是為了提供一個三級聯動的字典列表給界面使用,因此這里對這些統計局的數據進行一個維護和展示出來,如下界面所示。
11)參數配置模塊
一般來說,一個系統或多或少都會涉及到一些系統參數或者用戶信息的配置,而ABP框架也提供了一套配置信息的管理模塊,ABP框架的配置信息,必須提前定義好配置的各項內容,然后才能在系統中初始化或者通過接口查詢來使用,本ABP快速開發框架引入了另外一種配置信息的定義,實現更加簡化的處理。
參數配置管理模塊界面如下所示。
配置模塊使用主要特點是以鍵為操作對象,然后內容是JSON序列化后的內容,可以存儲用戶自定義的類的序列號字符串,通過整合了SettingsProvider.net組件,使得我們操作配置內容更加方便和動態化。
12) 附件管理模塊
該模塊其實是很通用的一個模塊,例如我們的一些日常記錄,可能會伴隨著有圖片、文檔等的附件管理,如果為每個業務對象都做一個附件管理,或者每次開發系統都重新做,那么效率肯定沒有直接采用通用的附件管理那么方便快捷了。
其實這個模塊是基于我的Winform開發框架開發的,同樣現在的ABP快速開發框架的Winform端依舊可以使用這些模塊的界面和大概的處理規則,我們把它利用ABP框架的獲取數據方式調整一下即可。
首先我們創建一個獨立的控件,用于放到編輯數據記錄窗口里面,如下所示。
這樣在項目中集成(如數據編輯窗口),直接拖動這個控件到界面中,運行就可以看到下面的效果了。
由于一般創建記錄的時候,給他指定一個GUID的附件組ID,這樣我們在數據記錄保存前,我們就可以上傳附件了,如下所示。
而且在這個過程中,可以隨時查看自己在該記錄中已經上傳的附件。如果附件不夠,可以隨時啟動上傳操作,附件支持多選文件,然后一次性,啟動后臺線程操作方式,把文件上傳及附件記錄保存到數據庫。
由于是附件管理,因此有可能上傳各種文件,包括Word文檔、Excel文檔、壓縮文件,以及各種類型的圖片,因此為了方便對圖片的查看,這個控件集成了圖片查看控件,可以非常方便直接讀取圖片附件的數據流作為對象展示,該圖片控件支持對圖片的滾動放大縮小、左右翻轉、選擇放大、圖片移動、保存圖片等功能,不需要查看,直接使用ESC退出即可。
附件管理在很多信息化管理系統中很普遍使用,例如我在病人管理系統界面里面,可以在一個界面里面分門別類管理很多影像學的圖片資料,通過查看附件,可以看到其中一些圖片附件的縮略圖,需要進一步查看,可以雙擊圖片即可實現預覽效果。
通用附件管理模塊,就是基于這些特點,實現圖片、Excel文檔、Word文檔和PDF等文檔的在線預覽和管理操作,界面截圖如下所示。
以上就是框架里面主要的模塊內容展示,當然我們可以結合代碼生成工具來快速開發自己的業務管理模塊,而這些主要就是設計好數據庫后,對框架代碼和界面代碼的統一生成后進行整合到主體框架里面即可,可以獲得高效、統一、快速的開發體驗。
詳細的代碼生成工具開發過程,可以了解隨筆《利用代碼生成工具生成基于ABP框架的代碼 》、《ABP開發框架前后端開發系列---(8)ABP框架之Winform界面的開發過程》
ABP框架代碼生成
最終根據根據選擇數據庫表信息,一鍵生成相關ABP架構分層代碼,文件結構如下所示。
ABP框架的Winform界面開發
設置好后直接生成,代碼工具就可以依照模板來生成所需要的WInform列表界面和編輯界面的內容了,如下是生成的界面代碼。
放到VS項目里面,就看到對應的窗體界面效果了。
生成界面后,進行一定的布局調整就可以實際用于生產環境了,省卻了很多時間。