基於DDD的現代ASP.NET開發框架--ABP系列之5、ABP啟動配置

ABP是“ASP.NET Boilerplate Project (ASP.NET樣板專案)”的簡稱。

 
本文由 東莞-天道 提供翻譯

譯者注：在看這一節的內容之前，建議大家先下載module-zero這個例子程式碼，這個例子就是一個使用者和角色的模組，並且使用的例項。配置在每一個應用中都可能會有，比如你有一個網站，你要獲取網站的一些自定義基本引數，比如logo位置，網站名稱，上傳檔案大小等等。模組化的配置方式和我們之前的做法肯定是不同的，大家要注意。之前無非就是一個方法getconfig從對應的表取資料，然後使用。

在應用啟動之前，abp框架提供了模組基本的配置和方法，大家參照下面這個例子就可以了。 

配置ABP

配置是通過在自己模組的PreInitialize方法中來實現的（對於module的PreInitialize方法，在上一篇中已經向大家做了簡單的說明）

程式碼示例如下：

public class SimpleTaskSystemModule : AbpModule
{
    public override void PreInitialize()
    {
        //在你的應用中新增語言包，這個是英語和作者的土耳其語。
        Configuration.Localization.Languages.Add(new
 
 LanguageInfo("en", "English", "famfamfam-flag-england", true));
        Configuration.Localization.Languages.Add(new LanguageInfo("tr", "Türkçe", "famfamfam-flag-tr"));

        Configuration.Localization.Sources.Add(
            new XmlLocalizationSource(
                "SimpleTaskSystem",
                HttpContext.Current.Server.MapPath(
 
"~/Localization/SimpleTaskSystem")
                )
            );

        //配置導航和選單
        Configuration.Navigation.Providers.Add<SimpleTaskSystemNavigationProvider>();
    }

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

和orchard類似，abp框架一開始就被設計成模組化的，不同的模組可以通過abp框架來進行配置。舉個例子吧，不同的模組都可以新增導航，通過導航新增選單項到自己定義的主選單，具體的細節大家可以參照：

配置模組

和.net框架原生的啟動配置相比較，abp有哪些不一樣呢？abp框架的模組可以通過IAbpModuleConfigurations介面進行個性化的擴充套件，這樣的話，模組配置更加簡單、方便。
示例程式碼如下：

...
using Abp.Web.Configuration;
...
public override void PreInitialize() 
{
    Configuration.Modules.AbpWeb().SendAllExceptionsToClients = true;
}
...

在上面這個例子中，我們通過配置AbpWeb模組，傳送異常到客戶端。當然了，不是每一個模組都需要這種配置，通常情況下我們需要，是當一個模組需要在多個不同的應用中重複使用，我們才進行這樣的配置。

為一個模組建立配置

如下程式碼，假如我們有一個命名為MyModule的模組，並且這各模組有一些自己的配置。那麼我們首先要建立一些類，這些類定義為屬性（譯者注：屬性有自動的get和set訪問器。），代表了不同的配置。

public class MyModuleConfig
{
    public bool SampleConfig1 { get; set; }

    public string SampleConfig2 { get; set; }
}

接下來，我們通過依賴注入，註冊這個類。

IocManager.Register<MyModuleConfig>(); //譯者注：在IocManager中註冊了一個類，換句話說，我們通過IocManager可以得到這個類MyModuleConfig的例項。至於IOC的原理這裡就不在詳細說了，總之，就是可以得到一個類的例項。

最後，我們通過建立一個擴充套件的方法IModuleConfigurations來得到配置的引用。如下程式碼:

譯者注：模組配置是一個靜態類，因為我們需要重複使用它。靜態方法Mymodule返回的是一個配置介面，引數是ImoduleConfigurations介面。

現在，在其他模組中也可以配置我們自定義的這個MyModule模組了。

Configuration.Modules.MyModule().SampleConfig1 = false;
Configuration.Modules.MyModule().SampleConfig2 = "test";

在某種意義上，MyModule需要這些配置，你能注射MyModuleConfig並且可以使用這些值。

public class MyService : ITransientDependency
{
    private readonly MyModuleConfig _configuration;

    public MyService(MyModuleConfig configuration)
    {
        _configuration = configuration;
    }

    
    public void DoIt()
    {
        if (_configuration.SampleConfig2 == "test")
        {
            //...
        }
    }
}

這意味著，在abp框架的系統中，所有的模組都可以集中配置。

希望更多國內的架構師能關注到ABP這個專案，也許這其中有能幫助到您的地方，也許有您的參與，這個專案可以發展得更好。

歡迎加ABP架構設計交流QQ群：134710707