ABP 初探 之 多語言

     最近幾天空閑時間比較多，就研究Abp的多語言，Abp是基於接口的依賴注入，有很多思想與方法都很好，需自己深入體會與應用，轉化成自己的思想應用於實踐。

　　本篇介紹基於 開源Demo ModuleZeroSampleProject，多語言分為兩部分，基於后台的CS代碼和前台的JS。

　　資源文件定義分為Web端和嵌入DLL層

　　基於Dll層的資源文件需設置文件屬性為嵌入，否則發布后找不到資源文件。

　　基於Web端的初始化方法

//Add/remove localization sources here
            Configuration.Localization.Sources.Add(
                new XmlLocalizationSource(
                    ModuleZeroSampleProjectConsts.LocalizationSourceName,
                    HttpContext.Current.Server.MapPath("~/Localization/ModuleZeroSampleProject")
                    )
                );

嵌入Dll的初始化方法 abp是命名空間，Localization.Sources.AbpXmlSource是文件路徑。

Configuration.Localization.Sources.Add(
                new DictionaryBasedLocalizationSource(
                    AbpConsts.LocalizationSourceName,
                    new XmlEmbeddedFileLocalizationDictionaryProvider(
                        Assembly.GetExecutingAssembly(), "Abp.Localization.Sources.AbpXmlSource"
                        )));

　　后台CS 分為三部分，分別對應Controller、Application、Core

　　多語言的使用第一步是初始化，只能指定了資源文件名稱才能正常解析與使用，

      Cotroller 初始化方法，創建Cotroller基類 ModuleZeroSampleProjectControllerBase，在構造函數添加 資源路徑

public abstract class ModuleZeroSampleProjectControllerBase : AbpController
    {
        protected ModuleZeroSampleProjectControllerBase()
        {
            LocalizationSourceName = ModuleZeroSampleProjectConsts.LocalizationSourceName;
        }
    }

　　Application、Core 初始化方法，創建Service基類，所有的方法都繼承該基類，資源文件屬性都要設置 嵌入

public class MarketApplicationServiceBase : ApplicationService
    {

        protected MarketApplicationServiceBase()
        {
            LocalizationSourceName = MarketCoreConsts.LocalizationSourceName;
        }
    }

前端JS部分初始化，一空要引用abp.js 在abp.js里定義了資源初始化的相關方法

 abp.localization = abp.localization || {};

    abp.localization.localize = function (key, sourceName) {
        sourceName = sourceName || abp.localization.defaultSourceName;

        var source = abp.localization.values[sourceName];

        if (!source) {
            abp.log.warn('Could not find localization source: ' + sourceName);
            return key;
        }

        var value = source[key];
        if (value == undefined) {
            return key;
        }

        var copiedArguments = Array.prototype.slice.call(arguments, 0);
        copiedArguments.splice(1, 1);
        copiedArguments[0] = value;

        return abp.utils.formatString.apply(this, copiedArguments);
    };

    abp.localization.getSource = function (sourceName) {
        return function (key) {
            var copiedArguments = Array.prototype.slice.call(arguments, 0);
            copiedArguments.splice(1, 0, sourceName);
            return abp.localization.localize.apply(this, copiedArguments);
        };
    };

    abp.localization.isCurrentCulture = function (name) {
        return abp.localization.currentCulture
            && abp.localization.currentCulture.name
            && abp.localization.currentCulture.name.indexOf(name) == 0;
    };

    abp.localization.defaultSourceName = undefined;
    abp.localization.abpWeb = abp.localization.getSource('AbpWeb');

通過如何方法可以讀取資源文件

<script>
            $(function () {
                var appLocalizationSource = abp.localization.getSource('Market');  //xml文件名
                function localize() {
                    return appLocalizationSource.apply(this, arguments);
                };
                alert(localize('Role_IsDefault')) // xml當中定義的字段
            })
        </script>

前端加載的資源文件都來源於JS 動態生成  <script src="~/AbpScripts/GetScripts?v=@(Abp.Timing.Clock.Now.Ticks)" type="text/javascript"></script>

引用上面的Js文件會生成如下 內容

Views 界面也可以通過如下方法顯示多語言，L 方法位於如下命名空間 Abp.Web.Mvc.Views.AbpWebViewPage