ABP（ASP.NET Boilerplate Project），現下比較流行的一種web框架，因為公司新專案準備使用這種框架，所以寫下這篇文章記錄下自己一步一步搭建的過程，就當做是對學習的一個總結與分享。

第一步：通過boilerplate模版建立解決方案
ABP框架官網：http://www.aspnetboilerplate.com/ .
可供選擇的體系結構有兩種:
1.Single Page Web Application :單頁面應用程式
2.Muli Pate Web Application:多頁面應用程式

在另外一篇部落格中看到說可以選擇的ORM框架有兩種：EF和Nhibernate.但是官網上只看到EF.所以暫時選擇EF框架。
模板使用多頁面應用程式，所以選擇第二個。單頁面應用程式需要學習Angular.js.
下面有一個勾選框，勾選之後ABP框架模板會自動生成使用者、角色、許可權等方面的管理。輸入解決方案名稱，點選【Create My Project】生成解決方案，然後會提示下載解決方案的壓縮包。

第二步：建立實體(Entity)

開啟下載下來的模板 —>【還原Nuget包】，解決方案總共包含5個專案，大致可以分為4層。關於這幾層具體的劃分，用得多了，自然也就清楚了。

應用服務層(application):提供應用服務方法給表現層呼叫。
領域層(core)：包括業務物件和業務規則，這是應用程式的核心層
基礎設施層(EntityFramework)：實現領域層中定義的倉儲，資料庫遷移以及資料互動等。
表現層(web，webApi)：與使用者打交道的一層。

在Core這一層建立兩個實體,Teacher和Student繼承自ABP的entity。ABP的entity自帶一個Id(int)屬性，預設作為主鍵。我們自己可以根據需要設定主鍵型別。
ABP基於模組程式設計，建議每個模組建立一個資料夾，相關的檔案放在一起。所以在Core下面建立Teacher和Student資料夾，然後在對應的資料夾下建立實體。

public class Student:Entity<long>
    {
        public  virtual  string Code { get; set; }
        public  virtual string Name { get; set; }
    }

public class Teacher : Entity
    {
        public virtual string Code { get; set; }
        public virtual string Name { get; set; }
    }

第三步：資料遷移

一般框架都採用DBFrist的模式，即先建立資料庫，然後使用程式碼生成工具（如：動軟, CodeSmith..）生成對應的Model.
ABP框架則採用CodeFirst的模式，即先建立對應的model，然後使用資料遷移功能，建立DB。當然有一個不太好的地方就是，以後不能手動修改資料庫，否則會導致資料遷移出錯。

接下來通過我自己做的demo來說明資料遷移的準備工作(資料庫：postgresql):

1.建立資料庫連線字串，既然要做資料遷移這個當然是必須的。開啟web中的TestProject.Web中的web.config。找到connectionStrings節點，節點下面有一個預設的連線，修改連線的字串。這個name的是可以修改的，但是需要注意的是必須和DBContext中使用的name保持一致。開啟TestProject.EntityFramework下的TestProjectDBContext，即可看到使用連結的name

<connectionStrings><add name="Default" connectionString="Server=192.168.XXX.XXX;Port=XXX;User Id=***;Password=***$;Database=**;" providerName="Npgsql" /></connectionStrings>

2.配置EntityFramework，在web.config中找到entityFramework節點，從ABP下載下來的模板中提供了預設的SqlServer的provider，根據需要配置自己所對應的provider，我的demo使用的postgresql，postgresql還需要在新增節點system.data，否則會出現錯誤.

<entityFramework>
    <!--<defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework" />
    <providers>
      <provider invariantName="System.Data.SqlClient" type="System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer" />
    </providers>-->
    <defaultConnectionFactory type="Npgsql.NpgsqlConnectionFactory, EntityFramework6.Npgsql" />
    <providers>
      <provider invariantName="Npgsql" type="Npgsql.NpgsqlServices, EntityFramework6.Npgsql" />
    </providers>
  </entityFramework>

<system.data>
    <DbProviderFactories>
      <remove invariant="Npgsql" />
      <add invariant="Npgsql" name="Npgsql Data Provider" support="FF" description=".Net Framework Data Provider for Postgresql" type="Npgsql.NpgsqlFactory, Npgsql" />
    </DbProviderFactories>

有可能出現的錯誤：未解析成員“Npgsql.PostgresException,Npgsql, Version=3.1.2.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7”的型別，

3.配置完畢，就可以開始資料遷移了。開啟解決方案的【程式包管理控制檯】，把預設專案切換到TestProject.EntityFramework。否則命令不能執行

4.執行add-migration命令，這個命令後面需要新增一個引數，引數需要符合C#的命名規範，所以輸入add-migration entity回車執行。
第一次執行這個命令的時候，可能會出現錯誤：Unable to generate an explicit migration because the following explicit migrations are pending: [201701271145151_AbpZero_Initial]. Apply the pending explicit migrations before attempting to generate a new explicit migration.
把EntityFramework下面這個檔案刪除就可以了。然後重新執行。生成成功之後會看到EntityFramework會新增一個cs檔案

開啟這個檔案，就可以看到對應的遷移的語句了。這個操作只會生成對應的檔案，並不會修改資料庫結構。

5.執行update-database更新資料庫結構，完成資料遷移。

一些可能出現的錯誤和需要注意的地方：

1.An error occurred accessing the database.連線資料庫錯誤，這個就可能是第三步中連線字串配置出現了錯誤。

2.未解析成員“Npgsql.PostgresException,Npgsql, Version=3.1.2.0, Culture=neutral, PublicKeyToken=5d8b90d52f46fda7”的型別
—有一種可能就是NpgSql和EntityFramework6.Npgsql的暗轉順序不對，重新解除安裝安裝就可以了。
但還有一種比較隱蔽的錯誤就是資料遷移時生成的檔案中資料型別的長度超出資料庫型別所允許的長度：JobArgs = c.String(nullable: false, maxLength: 10485760)

3.資料遷移完成之後，資料庫會對應生成建立的實體以及資料遷移歷史記錄表__MigrationHistory。這一張表是用來對比兩次資料遷移時實體的變化，以便生成對應的資料遷移實體。每一次資料遷移的時候，都會與__MigrationHistory中最後一條記錄做對比，以便生成相應的實體。也就是說這張表中的最新一條資料時不能夠被刪除的。

這篇文章大致就簡單記錄一下ABP的搭建，在以後的學習中再陸續新增對這個框架的理解以及記錄一些可能遇到的問題和解決方案。