一、項目基礎架構——以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】。嗯，不夠高大上，另此字元串的部分參數也不夠合適，我們同步修改。此步驟一共需要修改三個文件：

1. EasyFast.Web =>Web.config。——修改資料庫連接字元串。name改為【AppDbContext】，內容改為用戶名+密碼連接方式
2. EasyFast.EntityFramework=>EasyFastDataModule.cs 。——修改為：Configuration.DefaultNameOrConnectionString = "AppDbContext";
3. EasyFast.EntityFramework.EntityFramework=>EasyFastDbContext.cs。——修改為：public EasyFastDbContext() : base("AppDbContext")

web.config修改前：

  <connectionStrings>
    <add name="Default" connectionString="Server=localhost; Database=EasyFast; Trusted_Connection=True;" providerName="System.Data.SqlClient" />
  </connectionStrings>

web.config修改後：

<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>】節點後。

三、本章節所使用的源碼

　　請註意：本源碼僅確保可以正常編譯通過，不敢保證是否有部分命名空間引用錯誤（如view頁即使出錯，也是可以正常編譯的）。如您發現有錯誤的地方，請自行修改。

　　額，抱歉，博客園單個文件最大10M。總文件空間100M。請直接聯繫本人索取。另，求如何擴大文件空間？