11.2 I18n与Res

I18n对象可通过资源文件的baseName与locale参数获取到与之相对应的Res对象,Res对象提供了API用来获取国际化数据。

以下给出具体使用步骤:

  • 创建i18n_en_US.properties、i18n_zh_CN.properties资源文件,i18n即为资源文件的baseName,可以是任意名称,在此示例中使用”i18n”作为baseName

  • i18n_en_US.properties文件中添加如下内容

msg=Hello {0}, today is{1}.

  • i18n_zh_CN.properties文件中添加如下内容

msg=你好{0}, 今天是{1}.

  • 在YourJFinalConfig中使用me.setI18nDefaultBaseName("i18n")配置资源文件默认baseName

  • 特别注意,java国际化规范要求properties文件的编辑需要使用专用的编辑器,否则会出乱码,常用的有Properties Editor,在此可以下载:http://www.oschina.net/p/properties+editor

以下是基于以上步骤以后的代码示例:

  1. // 通过locale参数en_US得到对应的Res对象
  2. Res resEn = I18n.use("en_US");
  3. // 直接获取数据
  4. String msgEn = resEn.get("msg");
  5. // 获取数据并使用参数格式化
  6. String msgEnFormat = resEn.format("msg", "james", new Date());
  7.  
  8. // 通过locale参数zh_CN得到对应的Res对象
  9. Res resZh = I18n.use("zh_CN");
  10. // 直接获取数据
  11. String msgZh = resZh.get("msg");
  12. // 获取数据并使用参数格式化
  13. String msgZhFormat = resZh.format("msg", "詹波", new Date());
  14.  
  15. // 另外,I18n还可以加载未使用me.setI18nDefaultBaseName()配置过的资源文件,唯一的不同是
  16. // 需要指定baseName参数,下面例子需要先创建otherRes_en_US.properties文件
  17. Res otherRes = I18n.use("otherRes", "en_US");
  18. otherRes.get("msg");

以下是在 jfinal template engine 中的使用示例:

  1. #(_res.get("msg"))

注意,上面的用法需要添加 I18nInterceptor,将在后面一小节进行介绍。