NopCommerce架构分析之(八)多语言支持

所属分类: 网络编程 / ASP.NET 阅读数: 959
收藏 0 赞 0 分享

系统支持的语言是有类:Language表示;

多语言资源对应的类为:LocalizedProperty;

当先选择某种语言存储在类中:GenericAttribute;

多语言可以导出为XML文件,当然也支持导出。

IWorkContext及其实体类WebWorkContext为当前运行上下文;用户的登录信息以及一些上下文环境设置都保存在此类中。

具体包括:当前用户信息:CurrentCustomer;当前用户Cookie;货币;语言;税的类型;供应商等;

展现多语言资源的方式有几种:

一、在自定义类WebViewPage<TModel>中放置了方法:T(),通过此方法,网页在展现时获取对应语言的文字。

其实T只是一个代理,代理的定义为:

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

此代理返回值类型为LocalizedString,此类继承接口IHtmlString,以保证能正确显示本地化的文字资源。

IHtmlString的定义为:

// 摘要: 
//   表示不应再次进行编码的 HTML 编码的字符串。 
public interface IHtmlString 
{ 
  // 摘要: 
  //   返回 HTML 编码的字符串。 
  // 
  // 返回结果: 
  //   HTML 编码的字符串。 
  string ToHtmlString(); 
} 

二、通过扩展HtmlHelper

类HtmlExtensions扩展了HtmlHelper类,

主要是对一些控件的封装,并支持多语言。

方法 LocalizedEditor<T, TLocalizedModelLocal>是对Telerik的TabStrip控件的封装(也就是多页签控件---Tab控件),的。系统同时支持有多种语言时,多为每种语言显示一个页签,当然仅当需要时才这么做。这里面用到了接口ILocalizedModel和接口ILocalizedModelLocal。接口ILocalizedModel用来标示某Model类支持这种多语言显示,其中里面包括多种语言数据列表Locales,实现接口ILocalizedModelLocal的类就是特定一种语言的数据。LocalizedEditor方法就是根据这些接口的配合实现了支持多种语言页签了。Admin项目使用此方法,Web项目没有使用。

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); 
    } 
  }); 
}

扩展方法NopLabelFor<TModel, TValue>是另外一种多语言实现方式。

此方法主要是根据特性DisplayNameAttribute的子类NopResourceDisplayName实现对属性名称的描述。此特性是对Model属性的修饰,以指定属性的名称。

例如类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的扩展方法NopLabelFor的实现如下:

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()); 
}

更多精彩内容其他人还在看

.NET Core源码解析配置文件及依赖注入

这篇文章我们设计了一些复杂的概念,因为要对ASP.NET Core的启动及运行原理、配置文件的加载过程进行分析,依赖注入,控制反转等概念的讲解等
收藏 0 赞 0 分享

.NET Corek中Git的常用命令及实战演练

这篇文章将通过故事的形式从Git的历史谈起,并讲述Git的强大之处。然后通过实战演练教你如何在Github以及码云上托管我们的代码并进行代码的版本控制
收藏 0 赞 0 分享

Asp.Net Core WebAPI使用Swagger时API隐藏和分组详解

这篇文章主要给大家介绍了关于Asp.Net Core WebAPI使用Swagger时API隐藏和分组的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Asp.Net Core具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
收藏 0 赞 0 分享

如何利用FluentMigrator实现数据库迁移

这篇文章主要给大家介绍了关于如何利用FluentMigrator实现数据库迁移的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
收藏 0 赞 0 分享

ASP.NET Core利用Jaeger实现分布式追踪详解

这篇文章主要给大家介绍了关于ASP.NET Core利用Jaeger实现分布式追踪的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用ASP.NET Core具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
收藏 0 赞 0 分享

浅谈从ASP.NET Core2.2到3.0你可能会遇到这些问题

这篇文章主要介绍了ASP.NET Core2.2到3.0可能会遇到的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
收藏 0 赞 0 分享

详解.net core webapi 前后端开发分离后的配置和部署

这篇文章主要介绍了.net core webapi 前后端开发分离后的配置和部署,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
收藏 0 赞 0 分享

详解ASP.Net Core 中如何借助CSRedis实现一个安全高效的分布式锁

这篇文章主要介绍了ASP.Net Core 中如何借助CSRedis实现一个安全高效的分布式锁,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
收藏 0 赞 0 分享

.net 4.5部署到docker容器的完整步骤

这篇文章主要给大家介绍了关于.net 4.5部署到docker容器的完整步骤,文中通过示例代码介绍的非常详细,对大家学习或者使用.net4.5具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
收藏 0 赞 0 分享

.net core并发下线程安全问题详解

这篇文章主要给大家介绍了关于.net core并发下线程安全问题的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用.net core具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
收藏 0 赞 0 分享
查看更多