.NET Core開源快速開發框架Colder發布 (NET Core2.1+AdminLTE版)

本文轉載自查看原文 2019-03-11 09:12 14902 快速開發/ AdminLTE/ C# .NET相關/ .NET/ 倉儲/ 框架/ Core

引言

上星期發布的.NET452+AdminLTE版框架得到了大家的大力支持，目前GitHub已獲近100星，鄙人十分高興能夠幫助大家。其中有不少關心.NET Core的支持情況，因為未來的.NET平台是屬於.NET Core的，為此，鄙人花了一星期將代碼移植到.NET Core2.1，不負眾托，在此推出NETCore+AdminLTE版。

簡介

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

本版本框架采后端采用基於.NET Core的ASP.NET
Core2.1，前端從原來的Easyui升級為基於Bootstrap的AdminLTE，支持響應式布局，提高用戶體驗（提高逼格）。

框架主要功能如下表：

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

后台展示如下：

版本參照請看下表：

.NET版本	前端UI	地址
.NET Core2.1	AdminLTE	https://github.com/Coldairarrow/Colder.Fx.Core.AdminLTE
.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：安裝.NET Core2.1及以上

數據庫：SQLServer2008 R2及以上

基礎數據庫構建

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

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

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

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

如下圖所示依次展開05.Coldairarrow.Web=>appsettings.json，配置數據庫連接字符串，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，點擊生成按鈕，即可完成代碼生成。生成后的代碼在項目解決方案中，將代碼文件包括進入項目（.NET
Core項目默認會自動包括新生成的文件,若沒包括請手動包括進項目中）

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

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

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

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

管理員登錄

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

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

密碼為：123456

系統用戶管理

管理系統登錄的用戶

菜單：系統=>用戶管理，如下頁面

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

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

系統角色管理

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

菜單：系統=>角色管理

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

權限管理

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

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

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

權限使用：

權限定義：