1. 程式人生 > >【轉載】.NET開源快速開發框架Colder(NET452+AdminLTE版)

【轉載】.NET開源快速開發框架Colder(NET452+AdminLTE版)

庫類 module 用戶管理 The 和數 iss str 基於用戶 倉儲

.NET開源快速開發框架Colder(NET452+AdminLTE版)

簡介

本框架旨在為.NET開發人員提供一個Web後臺快速開發框架,采用本框架,能夠極大的提高項目開發效率。

本版本框架采後端采用基於.NET4.52的ASP.NETMVC,前端從原來的Easyui升級為基於Bootstrap的AdminLTE,支持響應式布局,提高用戶體驗(提高逼格)。

框架主要功能如下表:

功能詳細描述支持情況
用戶登錄、密碼修改 用戶登錄、密碼修改 ?
系統用戶管理 系統用戶管理 ?
角色管理 角色管理 ?
權限管理 基於用戶的權限、基於角色的權限、菜單權限、操作權限(按鈕權限)、接口權限、數據權限 ?
系統日誌 支持使用ElasticSearch記錄日誌 ?
快速開發 通過數據庫直接生成實體層、業務邏輯層、視圖層代碼,無需編碼即可實現CURD ?
數據庫操作封裝 使用基於EF的倉儲模式、封裝常用的CURD,支持單庫事物和分布式事物 ?
多數據庫支持 使用基於EF的倉儲模式,支持各大主流關系型數據庫(SQLServer、MySQL、Oracle、PostgreSQL) ?
緩存支持 支持系統自帶緩存和Redis緩存、封裝操作接口、簡單易用 ?
分布式Session支持 禁用自帶Session,使用自定義Session,一鍵開啟分布式Session ?
頁面響應式 基於Bootstrap,支持響應式布局,移動端能夠輕松訪問 ?
其它各種幫助類庫及插件 其它各種幫助類庫及插件 ?

後臺展示如下:

技術分享圖片

源碼地址:https://github.com/Coldairarrow/Colder.Fx.Net.AdminLTE

各版本請看下表:

.NET版本前端UI地址
.NET4.52 AdminLTE https://github.com/Coldairarrow/Colder.Fx.Net.AdminLTE
.NET4.52 Easyui https://github.com/Coldairarrow/Coldairarrow.Fx.Net.Easyui.GitHub
.NET Core2.1 Easyui https://github.com/Coldairarrow/Coldairarrow.Fx.Core.Easyui.GitHub
.NET4.0 Easyui https://github.com/Coldairarrow/Coldairarrow.Fx.Net40.Easyui.GitHub

基礎準備

開發環境要求

操作系統:Windows 10

開發工具:Visual Studio 2017

SDK:安裝.NET4.52及以上

數據庫:SQLServer2008 R2及以上

基礎數據庫構建

使用本框架需要構建基礎數據庫,具體步驟如下:

創建基礎數據庫的Sql腳本文件在:/docs/初始化文件/db.sql,在數據庫中運行db.sql腳本即可創建數據庫:
Colder.Fx.Net.AdminLTE

若Sql運行出錯,請直接使用同目錄下的db.bak還原數據庫

打開src目錄下Colder.Fx.Net.AdminLTE的解決方案,如下圖

技術分享圖片

如下圖所示依次展開05.Coldairarrow.Web=>Config=>database.config,配置數據庫連接字符串,name不用修改,connectionString改為上述創建的數據庫(若不清楚數據庫連接字符串請自行百度搜索教程)

技術分享圖片

自此基礎數據庫配置完成。

數據庫設計規範

由於本框架支持自動生成代碼的核心功能,此功能是根據數據庫的表結構來生成代碼的

因此規定每張表都有一個主鍵,列名為Id,類型為字符串,實際添加數據時默認使用GUID的字符串形式,表中的每個列都需要有描述信息(建議這樣操作,若不按照這個標準則需要一些額外的改動才能夠成功運行)。

技術分享圖片

運行

請先還原Nuget包

然後將05.Coldairarrow.Web設為啟動項目,成功運行即可進入以下頁面

技術分享圖片

詳細教程

代碼架構

項目代碼分層,詳情見源碼中的說明書,博客園放會被判為重復文章,敬請諒解。

功能架構

全局配置

在01.Coldairarrow.Util中的GlobalSwitch類中,設置了各個參數,其中RunModel需要重點關註一下,若RunModel==RunModel.LocalTest,則系統會直接跳過登錄,默認使用Admin超級管理員登錄,其它參數請看註釋。

快速開發

使用此功能請確保GlobalSwitch.RunModel= RunModel.LocalTest

此功能為本框架的核心功能,能夠自動生產完整的可運行代碼,具體使用如下:

首選需要有數據庫源,因為代碼生成是根據數據庫表來生成的。

菜單:開發=>數據庫連接管理

技術分享圖片

若列表中沒有目標數據源,則添加數據庫連接

技術分享圖片

數據連接名、連接字符串、數據庫類型即可。添加完成後即可看到連接字符串信息。

有了數據庫連接之後,即可進行代碼生成。

菜單:開發=>代碼生成

技術分享圖片

選擇數據庫,然後勾選需要生成代碼的數據庫表,點擊生成代碼會彈出生成選項(這裏暫時只能勾選Dev_Project,其余表全是系統基礎表,不要勾選,否則會被覆蓋,導致異常,請勾選自己的業務表進行生成):

技術分享圖片

生成選項中可以選擇需要生成的類型,可以默認生成實體層、業務邏輯層、控制器和視圖。

生成區域對應MVC中的Areas,請按需填入(必填)

技術分享圖片

這裏示例填寫ProjectManage,點擊生成按鈕,即可完成代碼生成。生成後的代碼在項目解決方案中,將代碼文件包括進入項目

技術分享圖片

默認生成後的文件是隱藏的,需要點擊顯示所有文件按鈕,即可看到生成後的新文件

技術分享圖片

技術分享圖片

右鍵新的文件夾,包括在項目中

由於是新生成的代碼,所以才配置新的菜單

技術分享圖片

如上圖,在Web項目中的Config/SystemMenu.config中配置菜單,模仿原有菜單即可,其中url是指頁面的路徑,Permission是指若需要訪問此菜單需要的權限(對應權限配置),若沒有此權限,則菜單也中不會顯示此菜單,修改完成後重新編譯生成(權限相關模塊進行了緩存,重新生成會清緩存),重新運行即可看到新的項目菜單如下:

技術分享圖片

技術分享圖片

整個代碼生成過程,無需編寫代碼即可完成一張表的CRUD,當然需要根據具體業務中進行相應的修改,本次示例中字段比較少,但是當一張表的字段很多時,那麽此功能能夠將開發效率提高幾個檔次。

管理員登錄

若要使用登錄功能,請將GlobalSwitch中的RunModel改為RunModel.Publish

技術分享圖片

技術分享圖片

默認超級管理員賬號為:Admin

密碼為:123456

系統用戶管理

管理系統登錄的用戶

菜單:系統=>用戶管理,如下頁面

技術分享圖片

點擊右側設置權限,可以設置用戶權限,詳情見<權限管理>模塊

技術分享圖片

具體權限相關配置見權限管理模塊

系統角色管理

管理系統角色,角色是權限的載體,合理分配角色有利於權限管理

菜單:系統=>角色管理

技術分享圖片

操作中可以設置角色的權限,詳情見<權限管理>模塊

權限管理

一般情況下,後臺管理系統多少會涉及權限管理,因此本框架提供了一個靈活、高效、簡潔的權限管理系統。

首先,權限分為兩種,即操作權限和數據權限,其中操作權限報貨系統用戶權限和AppId權限,系統用戶權限就是指操作用戶具備哪些權限,而當對外提供Api接口時,為了保證接口的安全性(若不在意可忽略),通常會提供接口簽名算法,其中AppId和AppSecret是必備的,通過對AppId設置權限,即可控制接口的權限。數據權限比較復雜,若采用純SQL方式,那麽會更加復雜,本框架全程采用EF作為ORM框架,通過對IQueryable<T>進行過濾,即可完成數據權限控制。

用戶權限:若對每個用戶都設置對應的權限,那麽工作量無疑是十分巨大的,因此引入了角色的概念,角色是權限的集合載體,那麽屬於此角色的用戶就繼承了角色的權限,當然某些特殊用戶需要擁有自己的不屬於角色的特殊權限,因此最終用戶擁有的權限就是自己的權限和所屬角色權限的並集。

權限使用:

權限定義:

技術分享圖片

如上圖,在Permission.config中定義了各個權限

權限配置:

在系統用戶管理和系統角色管理中可以設置用戶和角色的權限,把需要的權限勾選即可。

權限使用:

技術分享圖片

技術分享圖片

技術分享圖片

如上圖所示,在需要控制權限的頁面中,調用方法:PermissionManage.OperatorHasPermissionValue("sysuser.manage")

這個方法是判斷操作者用戶是否含有sysuser.manage權限值,其中sysuser是指Permission.config中定義的module的value屬性,manage是指permission中的value屬性,用.連接即是最終權限值。

更詳細的使用方式,請參考源代碼。

接口秘鑰管理

菜單:系統=>接口秘鑰管理

技術分享圖片

系統日誌

菜單:系統=>系統日誌

技術分享圖片

常見疑問

如何進行聯表查詢?

框架使用EF+LINQ進行聯表操作,核心在於對IQueryable<T>的使用,另可網上搜EF+LINQ的相關教程。

示例如下圖:

技術分享圖片

技術分享圖片

如何切換數據庫?

在01.Coldairarrow.Util項目中的GlobalSwitch,將DatabaseType改為需要的即可,對應的數據庫連接字符串當然也要改為對應數據庫的

技術分享圖片

如何使用別的數據庫(即非默認的系統數據庫)

在具體的Business類中重寫父類BaseBusiness的構造函數即可,按照自己的需求重寫對應的構造函數,同時需要確保數據庫連接字符串已添加

技術分享圖片

技術分享圖片

結語

歡迎使用本框架,若覺得不錯,請比心

Github:https://github.com/Coldairarrow,請Statrt

轉自博客園:https://www.cnblogs.com/coldairarrow/p/10486184.html

---------------------學習永無止境,技術永無上限,代碼就是藝術-----------------------

【轉載】.NET開源快速開發框架Colder(NET452+AdminLTE版)