ABP模組系統 

說了這麼久,還沒有詳細說到abp框架,abp其實基於DDD(領域驅動設計)原則的細看分層如下:

再看我們專案解決方案如下:

JCmsErp.Application,應用層:進行展現層與領域層之間的協調，協調業務物件來執行特定的應用程式的任務。它不包含業務邏輯,主要包含一些模型,abp重要的資料傳輸DTO,包括資料庫對映實體,前端檢視模型轉實體(Entity)物件,一個應用服務方法通常被認為是一個工作單元（Unit of Work）,使用一種像AutoMapper這樣的工具來進行實體與DTO之間的對映,前端引數傳入有限性驗證等等

JCmsErp.Core:領域層:領域層就是業務層，是一個專案的核心，所有業務規則都應該在領域層實現。包括業務物件和業務規則，這是應用程式的核心層。 

實體（Entity）:實體代表業務領域的資料和操作，在實踐中，通過用來對映成資料庫表。

倉儲（Repository）:倉儲用來操作資料庫進行資料存取。倉儲介面在領域層定義，而倉儲的實現類應該寫在基礎設施層。

領域服務（Domain service）:當處理的業務規則跨越兩個（及以上）實體時，應該寫在領域服務方法裡面。

領域事件（Domain Event）:　在領域層某些特定情況發生時可以觸發領域事件，並且在相應地方捕獲並處理它們。　

工作單元（Unit of Work）：工作單元是一種設計模式，用於維護一個由已經被修改(如增加、刪除和更新等)的業務物件組成的列表。它負責協調這些業務物件的持久化工作及併發問題。

JCmsErp.EntityFramework:基礎設施層:提供通用技術來支援更高的層。例如基礎設施層的倉儲(Repository)可通過ORM來實現資料庫互動。當在領域層中為定義了倉儲介面，應該在基礎設施層中實現這些介面。可以使用ORM工具，例如EntityFramework或NHibernate。ABP的基類已經提供了對這兩種ORM工具的支援。還有資料遷移等。

JCmsErp.Web:展現層:提供試圖用於與使用者實現互動操作.

JCmsErp.WebApi:這裡在abp中主要是提供介面,可以是解決方案內部使用介面,可以是與移動端等其他埠連線的介面.

二，實體（Entity）

實體是DDD（領域驅動設計）的核心概念之一。Eirc Evans是這樣描述的實體的：“它根本上不是通過屬性定義的，而是通過一系列連續性和標識定義的”。因此，實體都有Id屬性並且都儲存到資料庫中。一個實體一般會對映到資料庫的一張表

abp中實體是派生於Entity類，先看一下我們在Core層新建的Users類

Users實體類，有人說這個實體為什麼沒有id,因為Users繼承自Entity類，Entity類已經定義id，

它是該Entity類的 主鍵。因此，所有實體的主鍵名都是相同的，都是Id。

Id（主鍵）的型別是可以改變的，預設是int(int32)的。如果你想將Id定義為其他型別，可以在<>內寫,比如Guid,long也是可以的。

Entity類重寫了等號運算子（==），可以輕鬆地檢查兩個實體是否相同了（實體的Id相同則認為它們相同）。它也定義了IsTransient方法來檢測它是否有Id。

審計：

IHasCreationTime使得使用一個通用的屬性來描述一個實體的“建立時間”資訊成為可能。當實現了該介面的實體類插入到資料庫中時，ABP會自動地將當前的時間設定給CreationTime。

ICreationAudited增加了CreatorUserId擴充套件了IHasCreationTime，當用戶儲存一個新的實體的時候，會自動把當前的id設定為CreatorUserId，還有類似的LastModificationTime也是一樣。

當更新實體時，abp會自動為你設定這些屬性。

軟刪除

軟刪除是將一個實體標記為已刪除的通常使用的模式，而不是直接從資料庫中刪除。比如，你可能不想從資料庫中硬刪除一個User，因為它可能關聯其他的表

ABP實現了開箱即用的軟刪除模式。當一個軟刪除實體被刪除後，ABP檢測到之後，會阻止刪除，將IsDeleted設定為true並更新資料庫中的實體。而且，它會自動地過濾資料庫中軟刪除的實體，不會檢索（select）它們。

如果使用了軟刪除，那麼你可能想儲存一些資訊，比如何時刪除以及誰刪除了一個實體等等

在JCmsErp.Application建立一個Users資料夾,然後建立UserinfoDto,DTO是用於Core和 Web間的資料傳輸物件.有了實體了為什麼還要DTO呢

1,DTO保證了層與層的分離,web層改變不影響core層,core做改變也不影響web.

2,資料保護,不然敏感或者不需要的資料暴露於web層,不被別人窺見如密碼,銀行賬號,身份證等敏感資訊

3,序列化,序列化集合,但是子集不序列化,當首次用到子集的時候才序列化.

4,惰性載入

5,DTO資料驗證

6,abp還有一些擴充套件的介面,擴充套件性好,降低耦合度,使表現層和邏輯層之間耦合度降低.

這裡Serializable就是支援序列化的標籤,   [AutoMapFrom(typeof(Users))]是指和Users之間雙向自動轉化的標籤,並不需要每個欄位都去手動匹配.ABP提供了若干特性和擴充套件方法來定義對映。首先，要將Abp.AutoMapper nuget包新增到專案中。然後，AutoMap特性是雙向對映方式， AutoMapFrom和 AutoMapTo是單向對映方式。最後，使用MapTo擴充套件方法將一個物件對映到另一個物件

ABP模組系統簡介

ABP框架提供了建立和組裝模組的基礎，一個模組能夠依賴於另一個模組。在通常情況下，一個程式集就可以看成是一個模組。在ABP框架中，一個模組通過一個類來定義，而這個類要繼承自AbpModule。

模組系統當前專注於服務端而不是客戶端。

如果學習過Orchard的朋友，應該知道module模組的強大了。模組的本質就是可重用性，你可以在任意的地方去呼叫，而且通過實現模組，你寫的模組也可以給別人用。.net可以通過反射獲取一個程式集中的類以及方法。

1.3.2 定義模組

Assembly程式集：Assembly是一個用來包含程式的名稱，版本號，自我描述，檔案關聯關係和檔案位置等資訊的一個集合。最簡單的理解就是：一個你自己寫的類庫生成的dll就可以看做是一個程式集，這個程式集可以包括很多類，類又包括很多方法等。

一個派生自 AbpModule 的類就是模組的定義。我們正在開發一個部落格模組，該模組可以被使用在不同的應用程式中。最簡單的模組定義示例如下：

public class MyBlogApplicationModule : AbpModule //定義
{
    public override void Initialize() //初始化
    {
        IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
        //這行程式碼的寫法基本上是不變的。它的作用是把當前程式集的特定類或介面註冊到依賴注入容器中。
    }
}

如果需要的話，模組類負責類的依賴注入(通常可以像上面一樣做)。我們能配置應用程式和其它模組，新增新的功能到應用程式等等。

1.3.3 方法的生命週期

在一個應用中，ABP框架呼叫了Module模組的一些指定的方法來進行啟動和關閉模組的操作。我們可以過載這些方法來完成我們自己的任務。

ABP框架通過依賴關係的順序來呼叫這些方法，假如：模組A依賴於模組B,那麼模組B要在模組A之前初始化，模組啟動的方法順序如下：

1. PreInitialize-B

• PreInitialize-A
• Initialize-B
• Initialize-A
• PostInitialize-B
• PostInitialize-A

下面是具體方法的說明：

PreInitialize

預初始化：當應用啟動後，第一次執行會先呼叫這個方法。在初始化(Initialize)方法呼叫之前，該方法通常是用來配置框架以及其它模組。

在依賴注入註冊之前，你可以在這個方法中指定你需要注入的自定義啟動類。例如：加入你建立了某個符合約定的註冊類，你應該使用 IocManager.AddConventionalRegisterer 方法在這裡註冊它。

Initialize

初始化：在這個方法中一般是來進行依賴注入的註冊，一般我們通過IocManager.RegisterAssemblyByConvention這個方法來實現。如果你想實現自定義的依賴注入，那麼請參考依賴注入的相關文件。

PostInitialize

提交初始化：最後一個方法，這個方法用來解析依賴關係。

Shutdown

關閉：當應用關閉以後，這個方法被呼叫。

1.3.4 模組依賴

Abp框架會自動解析模組之間的依賴關係，但是我們還是建議你通過過載GetDependencies方法來明確的宣告依賴關係。

[DependsOn(typeof(MyBlogCoreModule))]//通過註解來定義依賴關係
public class MyBlogApplicationModule : AbpModule
{
    public override void Initialize()
    {
        IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
    }
}

例如上面的程式碼，我們就聲明瞭MyBlogApplicationModule和MyBlogCoreModule的依賴關係，MyBlogApplicationModule這個應用模組依賴於MyBlogCoreModule核心模組，並且，MyBlogCoreModule核心模組會在MyBlogApplicationModule模組之前進行初始化。

ABP可以從 startup module 遞迴的解析依賴關係，並按需初始化它們。最後初始化的模組是啟動模組(startup module)。

1.3.5 外掛模組

當模組從啟動模組以及其依賴關係進行調查發現的時候，ABP也能夠動態的載入其它指定模組。AbpBootstrapper 類定義了 PlugInSources 屬性，我們能用該屬性新增需要動態載入的模組。外掛源可以是任何實現了 IPlugInSource 介面的類。FolderPlugInSource 類實現了該介面，它可以被用來載入指定資料夾下的程式集。

ASP.NET Core

ABP的ASP.NET Core模組也可以動態載入模組，你只需要在 Startup 類中使用已定義的擴充套件方法 AddAbp，如下所示：

services.AddAbp<MyStartupModule>(options =>
{
    options.PlugInSources.Add(new FolderPlugInSource(@"C:\MyPlugIns"));
});

我們可以使用擴充套件方法 AddFolder 更方便的實現上述功能：

services.AddAbp<MyStartupModule>(options =>
{
    options.PlugInSources.AddFolder(@"C:\MyPlugIns");
});

瞭解更多關於Startup類的資訊，請檢視 ASP.NET 文件

ASP.NET MVC，Web API

對於經典的ASP.NET MVC應用，我們可以在 global.asax 重寫 Application_Start 方法來新增外掛資料夾，如下所示：

public class MvcApplication : AbpWebApplication<MyStartupModule>
{
    protected override void Application_Start(object sender, EventArgs e)
    {
        AbpBootstrapper.PlugInSources.AddFolder(@"C:\MyPlugIns");
        //...
        base.Application_Start(sender, e);
    }
}

外掛中的控制器

如果你的模組包括了MVC或者Web API控制器，ASP.NET不能發現這些控制器。為了克服這個問題，你可以在 global.asax 中新增程式碼來實現，如下所示：

using System.Web;
using Abp.PlugIns;
using Abp.Web;
using MyDemoApp.Web;

[assembly: PreApplicationStartMethod(typeof(PreStarter), "Start")]

namespace MyDemoApp.Web
{
    public class MvcApplication : AbpWebApplication<MyStartupModule>
    {
    }

    public static class PreStarter
    {
        public static void Start()
        {
            //...
            MvcApplication.AbpBootstrapper.PlugInSources.AddFolder(@"C:\MyPlugIns\");
            MvcApplication.AbpBootstrapper.PlugInSources.AddToBuildManager();
        }
    }
}

Additional Assemblies

對於IAssemblyFinder和ITypeFinder的預設實現(這兩個介面的實現被ABP用來在應用程式中發現指定的類)僅僅只用來查詢模組程式集以及在這些程式集中所使用的型別。我們可以在我們的模組中重寫 GetAdditionalAssemblies 方法來包含附加程式集。

1.3.6 自定義的模組方法

我們自己定義的模組中可能有方法被其他依賴於當前模組的模組呼叫，下面的例子，假設模組2依賴於模組1，並且想在預初始化的時候呼叫模組1的方法。這樣，就把模組1注入到了模組2，因此，模組2就能呼叫模組1的方法了。

譯者注：
ABP的模組系統與Orchard的模組有類似之處，但還是有比較大的差別。Orchard的框架修改了ASP.NET程式集的預設載入方式（模組的DLL沒有放在Bin資料夾下，是放在WEB專案根資料夾下面的Modules資料夾下），實現了功能模組的熱插拔，而ABP的模組程式集還是放在Bin資料夾下的，沒有實現熱插拔。

public class MyModule1 : AbpModule
{
    public override void Initialize() //初始化模組
    {
        IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());//這裡，進行依賴注入的註冊。
    }

    public void MyModuleMethod1()
    {
        //這裡寫自定義的方法。
    }
}

[DependsOn(typeof(MyModule1))]
public class MyModule2 : AbpModule
{
    private readonly MyModule1 _myModule1;

    public MyModule2(MyModule1 myModule1)
    {
        _myModule1 = myModule1;
    }

    public override void PreInitialize()
    {
        _myModule1.MyModuleMethod1(); //呼叫MyModuleMethod1的方法。
    }

    public override void Initialize()
    {
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
     }
}

在這裡，我們通過建構函式注入MyModule1到MyModule2，所以MyModule2能夠呼叫MyModule1的自定義方法。當且僅當MyModule2依賴於MyModule1才是可能的。

1.3.7 模組配置

雖然自定義模組可以被用來配置模組，但是，作者建議使用啟動配置來定義和配置模組。

1.3.8 模組生命週期

所有的模組類都被自動的註冊為單例模式。