快捷導(dǎo)航

NopCommerce架構(gòu)分析之(八)多語(yǔ)言支持

更新時(shí)間：2016年04月08日 10:27:48 作者：WalsonTung

NopCommerce支持多國(guó)語(yǔ)言，很好的做到了國(guó)際化，我們可以很輕松的下載中文或任意國(guó)家的語(yǔ)言包，上傳進(jìn)行切換，下面就讓我們看看NopCommerce是如何實(shí)現(xiàn)對(duì)多語(yǔ)言的支持的吧。

系統(tǒng)支持的語(yǔ)言是有類(lèi)：Language表示；

多語(yǔ)言資源對(duì)應(yīng)的類(lèi)為：LocalizedProperty；

當(dāng)先選擇某種語(yǔ)言存儲(chǔ)在類(lèi)中：GenericAttribute；

多語(yǔ)言可以導(dǎo)出為XML文件，當(dāng)然也支持導(dǎo)出。

IWorkContext及其實(shí)體類(lèi)WebWorkContext為當(dāng)前運(yùn)行上下文；用戶(hù)的登錄信息以及一些上下文環(huán)境設(shè)置都保存在此類(lèi)中。

具體包括：當(dāng)前用戶(hù)信息：CurrentCustomer；當(dāng)前用戶(hù)Cookie；貨幣；語(yǔ)言；稅的類(lèi)型；供應(yīng)商等；

展現(xiàn)多語(yǔ)言資源的方式有幾種：

一、在自定義類(lèi)WebViewPage<TModel>中放置了方法：T()，通過(guò)此方法，網(wǎng)頁(yè)在展現(xiàn)時(shí)獲取對(duì)應(yīng)語(yǔ)言的文字。

其實(shí)T只是一個(gè)代理，代理的定義為：

namespace Nop.Web.Framework.Localization 
{ 
  public delegate LocalizedString Localizer(string text, params object[] args); 
}

此代理返回值類(lèi)型為L(zhǎng)ocalizedString，此類(lèi)繼承接口IHtmlString，以保證能正確顯示本地化的文字資源。

IHtmlString的定義為：

// 摘要: 
//   表示不應(yīng)再次進(jìn)行編碼的 HTML 編碼的字符串。 
public interface IHtmlString 
{ 
  // 摘要: 
  //   返回 HTML 編碼的字符串。 
  // 
  // 返回結(jié)果: 
  //   HTML 編碼的字符串。 
  string ToHtmlString(); 
}

二、通過(guò)擴(kuò)展HtmlHelper

類(lèi)HtmlExtensions擴(kuò)展了HtmlHelper類(lèi)，

主要是對(duì)一些控件的封裝，并支持多語(yǔ)言。

方法 LocalizedEditor<T, TLocalizedModelLocal>是對(duì)Telerik的TabStrip控件的封裝（也就是多頁(yè)簽控件---Tab控件），的。系統(tǒng)同時(shí)支持有多種語(yǔ)言時(shí)，多為每種語(yǔ)言顯示一個(gè)頁(yè)簽，當(dāng)然僅當(dāng)需要時(shí)才這么做。這里面用到了接口ILocalizedModel和接口ILocalizedModelLocal。接口ILocalizedModel用來(lái)標(biāo)示某Model類(lèi)支持這種多語(yǔ)言顯示，其中里面包括多種語(yǔ)言數(shù)據(jù)列表Locales，實(shí)現(xiàn)接口ILocalizedModelLocal的類(lèi)就是特定一種語(yǔ)言的數(shù)據(jù)。LocalizedEditor方法就是根據(jù)這些接口的配合實(shí)現(xiàn)了支持多種語(yǔ)言頁(yè)簽了。Admin項(xiàng)目使用此方法，Web項(xiàng)目沒(méi)有使用。

public static HelperResult LocalizedEditor<T, TLocalizedModelLocal>(this HtmlHelper<T> helper, string name, 
  Func<int, HelperResult> localizedTemplate, 
  Func<T, HelperResult> standardTemplate) 
  where T : ILocalizedModel<TLocalizedModelLocal> 
  where TLocalizedModelLocal : ILocalizedModelLocal 
{ 
  return new HelperResult(writer => 
  { 
    if (helper.ViewData.Model.Locales.Count > 1) 
    { 
      var tabStrip = helper.Telerik().TabStrip().Name(name).Items(x => 
      { 
        x.Add().Text("Standard").Content(standardTemplate(helper.ViewData.Model).ToHtmlString()).Selected(true); 
        for (int i = 0; i < helper.ViewData.Model.Locales.Count; i++) 
        { 
          var locale = helper.ViewData.Model.Locales[i]; 
          var language = EngineContext.Current.Resolve<ILanguageService>().GetLanguageById(locale.LanguageId); 
          x.Add().Text(language.Name) 
            .Content(localizedTemplate 
              (i). 
              ToHtmlString 
              ()) 
            .ImageUrl("~/Content/images/flags/" + language.FlagImageFileName); 
        } 
      }).ToHtmlString(); 
      writer.Write(tabStrip); 
    } 
    else 
    { 
      standardTemplate(helper.ViewData.Model).WriteTo(writer); 
    } 
  }); 
}

擴(kuò)展方法NopLabelFor<TModel, TValue>是另外一種多語(yǔ)言實(shí)現(xiàn)方式。

此方法主要是根據(jù)特性DisplayNameAttribute的子類(lèi)NopResourceDisplayName實(shí)現(xiàn)對(duì)屬性名稱(chēng)的描述。此特性是對(duì)Model屬性的修飾，以指定屬性的名稱(chēng)。

例如類(lèi)AddNewsCommentModel的屬性用NopResourceDisplayName特性指定：

namespace Nop.Web.Models.News 
{ 
  public partial class AddNewsCommentModel : BaseNopModel 
  { 
    [NopResourceDisplayName("News.Comments.CommentTitle")] 
    [AllowHtml] 
    public string CommentTitle { get; set; } 
 
    [NopResourceDisplayName("News.Comments.CommentText")] 
    [AllowHtml] 
    public string CommentText { get; set; } 
 
    public bool DisplayCaptcha { get; set; } 
  } 
}

HtmlHelper的擴(kuò)展方法NopLabelFor的實(shí)現(xiàn)如下：

public static MvcHtmlString NopLabelFor<TModel, TValue>(this HtmlHelper<TModel> helper, Expression<Func<TModel, TValue>> expression, bool displayHint = true) 
{ 
  var result = new StringBuilder(); 
  var metadata = ModelMetadata.FromLambdaExpression(expression, helper.ViewData); 
  var hintResource = string.Empty; 
  object value = null; 
  if (metadata.AdditionalValues.TryGetValue("NopResourceDisplayName", out value)) 
  { 
    var resourceDisplayName = value as NopResourceDisplayName; 
    if (resourceDisplayName != null && displayHint) 
    { 
      var langId = EngineContext.Current.Resolve<IWorkContext>().WorkingLanguage.Id; 
      hintResource = 
        EngineContext.Current.Resolve<ILocalizationService>() 
        .GetResource(resourceDisplayName.ResourceKey + ".Hint", langId); 

      result.Append(helper.Hint(hintResource).ToHtmlString()); 
    } 
  } 
  result.Append(helper.LabelFor(expression, new { title = hintResource })); 
  return MvcHtmlString.Create(result.ToString()); 
}

您可能感興趣的文章: