以ABP为基础架构的一个中等规模的OA开发日志
前言:
最近園子里ABP炒的火熱。看了幾篇對于ABP的介紹后,深感其設計精巧,實現優雅。個人感覺,ABP或ABP衍生品的架構設計,未來會成為中型Net項目的首選架構模式。如果您還不了解ABP是什么,有什么特色,請移步:《ABP集合帖》——http://www.cnblogs.com/kebinet/p/5341663.html
?項目背景介紹:
作者自參加工作以來,一直在法律圈打轉。09-12年間,作者曾帶團隊用WebForm+N層架構實現了一個律師事務所的OA系統。時過境遷,現在在維護此系統時,發現了當初很多設計不合理的地方。所以本項目延續原OA系統的設計思路,以ABP為基礎架構,進行徹底重構。
注意:本系列文章定位為開發筆記,不代表ABP的最佳實踐。
?一、ABP是什么,ABP.Zero又是什么?從哪里下載ABP項目模板?
ABP全稱為:“ASP.NET Boilerplate Project (ASP.NET樣板項目)”。顧名思義,ABP實質上是一個.Net開發的分層示例+各種開發輔助類庫。ABP是一個以DDD設計模式為原則的Net項目分層示例+一大堆作者寫的輔助類庫。
ABP.Zero則是ABP的作者配合ABP框架寫的一套用戶模塊。其本質是對ASP.NET Identity的二次封裝。
ABP.Zero是一個獨立模塊。可用可不用。如果您的程序中,用戶模塊非常獨特,建議您不要使用ABP.Zero模塊,而是獨立實現一套用戶系統。在我們的示例項目中,用戶模塊也是非常獨特的,作者會盡可能嘗試用ABP.Zero去解決,如果實在無法適用,那么我們將做一套獨立的用戶模塊去替代。
?ABP作者官網:http://www.aspnetboilerplate.com/
GitHub地址: ?https://github.com/aspnetboilerplate/
?
(請默默感謝這兩位主要維護人員。如此優秀的開源項目,值得32個贊)
?
?
?如圖所示,登錄官網首頁后,即可以下載ABP項目模板。這里,我們選擇了使用.net framework4.5.2+mvc5的多頁面實現。ORM我們選擇了EntityFramework,并且選擇使用ABP.Zero模塊。(此處也可不選,日后需要時再安裝)。注意最底部的【EasyFast】,此處是你的解決方案名稱。下載并解壓后,我們得到了如下文件:
我們將解決方案名稱換成了中文【易迅律師事務所OA系統】。(作者手里有多份OA實現,為了防止歧義,才換了中文名稱,此處改不改不會對項目本身造成任何影響)
?
?
二、ABP使用前的基本設置
2.1、程序包的還原與更新(必須)
? 我們下載回來的ABP不包含對應packages(例如Newtonsoft.Json、EntityFramework、Log4net等等)。所以在使用前,請先在解決方案上右鍵,然后選【還原NuGet包】,等全部包下載完成后,再在解決方案上右鍵,選擇【管理解決方案的NuGet程序包】,看看是否有更新,如果有,請同步更新。
請注意:上圖所示的包無法更新,會提示有沖突,請忽略,不用更新此包。
?
?
2.2、修改數據庫連接字符串(非必須)
解決完包的問題后,我們來修改下數據庫連接字符串ABP默認的數據庫連接字符串名字叫【Default】。嗯,不夠高大上,另此字符串的部分參數也不夠合適,我們同步修改。此步驟一共需要修改三個文件:
EasyFast.Web =>Web.config。——修改數據庫連接字符串。name改為【AppDbContext】,內容改為用戶名+密碼連接方式
EasyFast.EntityFramework=>EasyFastDataModule.cs 。——修改為:Configuration.DefaultNameOrConnectionString?=?"AppDbContext";
EasyFast.EntityFramework.EntityFramework=>EasyFastDbContext.cs。——修改為:public?EasyFastDbContext()?:?base("AppDbContext")
web.config修改前:
| 1 2 3 | < connectionStrings > ?? < add? name="Default" connectionString="Server=localhost; Database=EasyFast; Trusted_Connection=True;" providerName="System.Data.SqlClient" /> </ connectionStrings > |
web.config修改后:
| 1 2 3 4 5 6 7 8 | <connectionStrings> ???? <add name= "AppDbContext"? connectionString="data source=(local); ????????? initial catalog=oa.easyfast.cn; ????????? user id=sa; ????????? password=info@123; ????????? MultipleActiveResultSets=True; ????????? App=EntityFramework " providerName=" System.Data.SqlClient" /> ?? </connectionStrings> |
小知識——MultipleActiveResultSets=True &?Trusted_Connection=True
當在數據庫連接字符串中指定MultipleActiveResultSets=True時。可以在一個連接上執行多次查詢。這樣可大大減輕數據庫壓力,提高程序負載能力。強烈推薦開啟。
當在數據庫連接字符串中指定Trusted_Connection=True時,意味著這是一個可信連接。不需要輸入用戶名密碼就可以登錄數據庫。在正式的生產服務器上,不推薦這么做。(啟用該屬性,實質上是使用windows賬戶進行數據庫連接。在生產服務器上,windows賬戶和SQLServer賬戶應該設置為不同的賬戶以降低安全風險)
?
?
2.3、修改程序命名空間(非必須)
ABP默認使用了簡化的命名空間。對于本項目來說,EasyFast.Application、EasyFast.Core、Easyfast.EntityFramework三個層統一使用了EasyFast作為命名空間。EasyFast.WebApi則使用了EasyFast.Api作為命名空間。對于Application、Core、EntityFramework三個層來說,隨著項目越來越大,使用相同的命名空間容易引起歧義。所以我們做如下修改:
EasyFast.Application——命名空間修改為EasyFast.Application
EasyFast.Core——命名空間修改為EasyFast.Core
Easyfast.EntityFramework——命名空間修改為Easyfast.EntityFramework
EasyFast.Api——暫時保持不變
圖示:在Application、Core、EntityFramework三個項目上右鍵,選擇屬性,將對應的默認命名空間分別修改為EasyFast.Application、EasyFast.Core、EasyFast.EntityFramework
注意:修改命名空間后,需同步修改相應的代碼引用。否則程序無法編譯通過。請慎重考慮此處是否修改。?
2.4、修改啟動項目(必須)
ABP的默認啟動項目是Core層,這樣每次調試時非常麻煩,我們將啟動項目修改為【當前選定項】,這樣我們在編輯完view頁面時,直接按Ctrl+F5就可以直接查看效果。而不用每次都在頁面上選擇【使用瀏覽器查看】。修改方法:在解決方案上右鍵,選擇屬性,在新打開的窗口中將通用屬性中的啟動項目選項修改為【當前選定內容】
?
2.5、初始化數據庫(必須)
ABP項目模板中,默認保留了大量model修改記錄。在SQL2014環境下,初始化數據庫可能會失敗。解決辦法:刪除所有的model修改記錄,重新初始化。請刪除下圖中數字開頭的類文件。然后載程序包管理控制臺執行【Add-Migration Init】、【Update-DataBase】。注意,在程序包管理控制臺中,默認項目需選中EasyFast.EntityFramework。且在執行命令前,鼠標需先選中EasyFast.Web項目。
在執行Add和Update兩個命令時,程序需先連接至數據庫以確定到底需要更新什么(需要建立、更新、刪除哪些表)。但是,在EasyFast.EntityFramework項目中,沒有數據庫連接字符串。所以程序會卡死一段時間。
解決辦法1:在執行命令前,在【解決方案資源管理器】選中web項目(此項前提是上一步中,在解決方案屬性中,將啟動項目修改為【當前選中項目】)。如此操作,可以讓VS知道通過web項目中web.config中的數據庫連接字符串去連接數據庫。
解決辦法2:EasyFast.EntityFramework層中,修改App.config文件,將Web項目中web.config中的連接字符串復制到【<configuration>】節點后。
?
三、本章節所使用的源碼
項目已開源,GitHub地址:https://github.com/easyfast/LawfirmOA
原文地址:http://www.cnblogs.com/brucelee/p/6009879.html
.NET社區新聞,深度好文,微信中搜索dotNET跨平臺或掃描二維碼關注
總結
以上是生活随笔為你收集整理的以ABP为基础架构的一个中等规模的OA开发日志的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: ASP.NET Core loves J
- 下一篇: [公测]微信小程序设计指南文档