【開源.NET】 分享一個先後端分離的輕量級內容管理框架

開發框架要考慮的面太多了：安全、穩定、性能、效率、擴展、整潔，還要經得起實踐的考驗，從零開發一個可用的框架，是很耗時費神的工做。網上不少開源的框架，爲什麼還要本身開發？我是基於如下兩點：

1. 沒找到合適的：安全、穩定、簡單、易用、高效、免費；
2. 想成爲架構師；

因而就本身動手，參考網上開源的項目和借鑑網友的設計思路（特別是蕭秦系列博文），結合本身的實踐，開發了一個簡單、易用、高效的的框架，雖然不完善，但也能解決現實中的問題。不過隨着見識增廣，發現沒負責過千萬級別的項目難以成爲架構師，也不可能開發出一個完美的框架。那就先開源出來，後面慢慢維護和完善。

【開源.NET】 輕量級內容管理框架Grissom.CMS（第一篇分享一個先後端分離框架）
【開源.NET】 輕量級內容管理框架Grissom.CMS（第二篇先後端交互數據結構分析）
【開源.NET】 輕量級內容管理框架Grissom.CMS（第三篇解析配置文件和數據以轉換成 sql）

1、框架結構圖

2、分層

從框架圖看出，按代碼結構業務來分爲 5 層：

1. Web: 展現層
2. WebApi: Http 接收與響應
3. Service: 業務邏輯和數據處理
4. EasyCore: 半ORM（Easy.DataProxy, Easy.Office, Easy.SqlConfiguration）
5. Model: 實體

對應解決方案的項目結構:

按功能角度分爲 3 層：

1. 淺藍色的： 展現層
2. 深藍色的： Http接收與響應層
3. 淺橙色的： 業務邏輯和數據處理層

按業務分爲 2 層：

1. 淺藍色的： 展現層
2. 淺橙色的： 業務邏輯和數據處理層

也就是經典的 3 層架構， 我只是把後面的業務邏輯層和數據處理層合拼爲 1 層。理論上把業務邏輯和數據處理分離是很合理的，但現實是數據處理每每就是寫 Sql, 而 Sql 不僅是簡單獲取數據，不少時候會耦合有大量的業務邏輯在裏面, 致使程序員去處理業務時，把一個業務需求拆分到 2 層去處理，這樣不能享受分層的好處，反而帶來如下反作用：

1. 破壞單一業務的內聚性；
2. 分散程序員的注意力：一條很合理的線性思路，分離到 2 個項目去實現；
3. 增長程序複雜度：看懂一個業務代碼的實現，要同時看兩個層的代碼；

固然把業務和數據處理分層對規範化多人協做的大型項目是很好的方式，幫助解耦、下降複雜度，不過對沒有嚴格規範分層代碼的三少項目（錢少、人少、時間少），這就不是好事了；分層是一種技術工具而不是規則，要根據實際狀況找到適合當前項目和團隊的分層方式。對於中小型、注重寫sql的項目，更適合把業務和數據處理放到同一層。

3、技術棧

前端用 mvvm 模式把頁面呈現和js業務代碼分離：

引用庫：

1. Easyui 1.4.0： 展現UI, 有作微小修改以適應框架；
2. knockoutjs: 實現mvvm;
3. profoundgrid: 頁面佈局；

工具：

1. sass: 好爽的 css 語言；
2. grunt: 前端構建工具, 結合compass 動態編譯 sass 到 css, 合併以及壓縮 css, js;

後端實現 RESTful Api：

引用庫：

1. Asp.net WebApi:　實現RESTful api;
2. autofac: 依賴注入；
3. JWT: 實現Oauth2, 用 token 受權，實現跨域；
4. fluentData: 支持多數據庫的數據持久，有改動以適應框架；
5. log4net: 日誌組件；

工具：

1. .net4.5;
2. vs2015;
3. mariadb: mysql 數據庫的一個分支；
4. T4模板：代碼生成器；

4、項目說明

後端

│Grissom.CMS │ ├─1-Model -- 實體類 │ ├─generation -- T4模板生成 │ ├─2-Services -- 業務邏輯和數據處理層 │ │ │ ├─custom -- 業務代碼寫在這裏 │ │ │ ├─generation -- T4模板生成 │ ├─3-WebAPI -- │ │ │ ├─AOP -- 橫向切入：異常日誌記錄 │ │ │ ├─APIs -- 公開的 API 寫這裏 │ │ │ ├─App_Data │ │ inital.sql -- 數據庫腳本 │ │ │ ├─Auth -- 實現跨域和Token受權 │ │ │ ├─Log -- 日誌 │ └─SqlConfigs -- 配置增刪改查的 sql xml │ SysRole.xml │ SysUser.xml │ VideoMain.xml │ ├─Core -- EasyCore 自動化增刪改查 │ ├─Easy.DataProxy -- sql配置 解析器 │ │ │ ├─Easy.Office -- 導入導出 excel │ │ │ ├─Easy.SqlConfig -- sql配置模型 │ │ ├─Libs -- dll 庫 │ 

其中，Model, Service 都用 T4 模板實現代碼自動生成， 前面說了 Service 就是業務和數據處理的核心項目。

前端

├─1-content -- js, css 系統通用文件 │ │ comData.js -- 公用庫： 配置 api 服務器 │ │ config.rb -- compass 配置文件 │ │ Gruntfile.js -- grunt 配置文件 │ │ package.json -- nodejs 初始化配置文件 │ │ │ ├─asset -- 資源 │ │ ├─css │ │ │ │ │ └─js │ │ │ │ │ └──core │ │ │ ├─icons -- easyui icons │ │ │ ├─images -- 圖片 │ │ │ └─node_modules -- nodejs 引用庫 ├─home -- 主頁 │ index.html │ index.js │ ├─sys -- 系統模塊 │ ├─role -- 角色管理 │ │ │ edit.html -- 編輯頁面 │ │ │ index.html -- 列表頁面 │ │ │ │ │ └─viewModel -- 模型 │ │ edit.js │ │ index.js │ │ │ └─user -- 用戶管理 │ └─video -- 視頻模塊

home 是容器，sys, video 是對應系統的業務模塊，role, user 對應系統表：SysRole, SysUser。前端核心庫是 1-content/asset/js/core 下面的js, 其實就實現的通用的數據綁定和也後臺數據交互功能。
1-content 中只需修改 comData.js 的 api 服務器配置 com.apiDomain = "http://localhost:2717"; 其它都是通用的，因此我用grunt 把通用的庫和css 分別合併成 all.js,all.css。固然要作修改，可安裝 nodejs, grunt, 參考grunt。

5、簡單應用：

具體實現參考底部的 demo, 流程以下：

1) 修改數據庫服務器： 有 4 個地方要改的, 其中 3 個是 T4 模板， 1-Model/generation/ModelTemplate.tt， 2-Services/generation/ModelTemplate.tt， 2-Services/custom/ModelTemplate.tt，3-WebAPI/web.config;
2) 從新執行 T4 代碼生成器：修改或添加新表後，打開T4模板文件，而後保存一遍，就會自動生成了，有 3 個 T4 模板文件： 1-Model/generation/ModelTemplate.tt， 2-Services/generation/ModelTemplate.tt， 2-Services/custom/ModelTemplate.tt；

3) 添加API: 在 3-WebAPI 項目下添加對應的 api controller;
4) 添加sql 配置： 在 3-WebAPI 項目下的 SqlConfigs 文件夾添加對應表名的 sql xml 文件;

5) 轉到前端： 在根目錄下添加模塊文件夾和對應的表文件夾，並添加 index.html 列表頁面 和 edit.html 編輯頁面， viewModel 文件夾添加模型js文件；

6) 運行 WebApi, 再瀏覽頁面；

6、預覽：

7、總結：

該框架有 3 個核心點，之後單獨 blog 來詳細展開描述，否則你看不到框架的強悍所在：

1. 後端　EasyCore(Easy.SqlConfiguration, Easy.DataProxy, Easy.Office): 直接經過一個簡潔的 xml 文件配出對錶進行增刪改查功能；
2. 前端　viewModel.common, viewModel.search,viewMode.edit：結合 knockoutjs 和 jeasyui 實現 mvvm;
3. 先後端交互的數據結構： {master:{inserted:[{data:{},children:{c1:{inserted:[],updated:[],deleted:[]}}}]}}, 該結構能標識出單表、多表、主從表的混合批量新增、修改、刪除狀態， 後臺分析該json格式的數據結構，結合 sql 配置，就能實現自動化數據庫操做；

框架並不完善，也不必定適用於你，但歡迎提意見，後續完善。PS: 該框架已經用到生產環境了。

8、源碼 https://github.com/grissomlau/Grissom.CMS

初始化登陸名：admin, 密碼： 123