欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2023-12-19 21:37:04
系统支持的语言是有类:language表示; 多语言资源对应的类为:localizedproperty; 当先选择某种语言存储在类中:genericattribute;...

系统支持的语言是有类: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()); 
}

上一篇:

下一篇: