• 国际化之MessageFormat与占位符


      如果一个字符串文本中包含了多个与国际化相关的数据,可以使用MessageFormat类对这些数据进行批量处理。

      例如:

      在201619的时候,一场台风导致了500间房屋的摧毁和1000000元人民币的损失。

      在上面这句话中,包含了时间、数字和货币等多个与国家化相关的数据,已经用下划线标出,而我们可以使用MessageFormat对这句话中多个数据进行批量处理。

      要想使用MessageFormat进行批量处理,就要使用到占位符,用占位符替换上面的数据(不需要写死的数据或者与国际化相关的数据)。占位符由花括号{}和在花括号中的数字组成,数字代表这是第几个占位符,现在我们对上面的那个示例使用占位符:

      在{0}的时候,一场台风导致了{1}间房屋的摧毁和{2}元人民币的损失。

       经过占位符修改的字符串文本也称为模式字符串,如上面这句话,有了模式字符串后,我们需要一个对象数组来指定每个占位符对应的数据,在数组中的位置就对应着其相同位置的占位符。现在拥有了模式字符串和对象数组后,我们就可以使用MessageFormat对象的format方法,将数组中的数据一一对应到占位符上了。

      占位符由三种书写格式:

      ① {index}:index为0~9之间的数字,对应对象数组中的位置。

      ② {index,formatType}:index为0~9之间的数字,formatType为参数的格式化类型

      ③  {index,formatType,formatStyle}:formatStyle为参数的格式化样式。

    有关占位符的使用稍后说明。

             注:在创建MessageFormat对象时可以直接将模式字符串以参数传入构造器,也可以直接使用MessageFormat的静态方法format(String pattern , Object …params)只执行一次。

    例1:

    1     String pattern = "在{0}的时候,一场台风导致了{1}间房屋的摧毁和{2}元人民币的损失。";
    2     Object[] params = {new Date(),500,1000000};
    3     MessageFormat mf = new MessageFormat(pattern);
    4     String content = mf.format(params);
    5     System.out.println(content);
    View Code

    上述代码等同于:

    1     String pattern = "在{0}的时候,一场台风导致了{1}间房屋的摧毁和{2}元人民币的损失。";
    2     Object[] params = {new Date(),500,1000000};
    3     String content = MessageFormat.format(pattern, params);
    4     System.out.println(content);
    View Code

    输出:

      

    结果就是:在16-1-9 下午7:56的时候,一场台风导致了500间房屋的摧毁和1,000,000元人民币的损失。

      可以看到在对应的占位符上,我们用对象数组中的内容替代了占位符。但是似乎和最开始我们规定的字符串文本有点不同?

     最开始我们规定的文本:

      在201619的时候,一场台风导致了500间房屋的摧毁和1,000,000元人民币的损失。

    例1占位符被替代后的文本:

      在16-1-9 下午7:56的时候,一场台风导致了500间房屋的摧毁和1,000,000元人民币的损失。

      可以看到日期格式和货币格式跟我们规定的不同,而这一点可以想到前一篇博客我们学到的DateFormat和NumberFormat中可以指定日期/时间或货币的输出格式。而这里我们要先了解下占位符:

      占位符有三种书写格式:

      ① {index}:index为0~9之间的数字,对应对象数组中的位置。

      ② {index,formatType}:index为0~9之间的数字,formatType为参数的格式化类型

      ③ {index,formatType,formatStyle}:formatStyle为参数的格式化样式,该样式必须是格式化类型相匹配的合法模式,或表示合法模式的字符串。

      在Java的API关于MessageFormat中,已经定义了formatType和formatStyle能使用的参数有哪些:

      

      通过上图我们就明白了formatType和formatStyle到底能使用哪些值,比如formatType如果我选了“date”,就代表该占位符是一个日期,那么可以指定formatStyle(使用占位符第三种书写方式),也就是DateFormat的日期显示格式;当然也可以不指定(使用占位符第二种书写方式),那么该DateFormat就采用默认(MEDIUM)的日期显示格式。如果formatType选择为“number”也是一样的道理。如果对DateFormat和NumberFormat不熟悉的可以看上一篇博客《国际化之DateFormat、NumberFormat》 。

    总结:

      formatType如果使用“date”,那么就是采用DateFormat类的getDateInstance方法获取只关于日期的DateFormat类实例对象,根据formatStyle来获取日期输出格式。

      formatType如果使用“time”,那么就是采用DateFormat类的getTimeInstance方法获取只关于时间的DateFormat类实例对象,根据formatStyle来获取时间输出格式。

      formatType如果使用“number”,如果也指定了formatStyle为“currency”,那么就是调用了NumberFormat的getCurrencyInstance方法获取有关于货币格式的NumberFormat类对象。

      当然通过上图还可以获得很多对象,还有其他类型的格式转换器类,比如SimpleDateFormat等等,具体根据上图和实际情况满足需求即可。

    例2:

    1     String pattern = "在{0,date,long}的时候,一场台风导致了{1}间房屋的摧毁和{2,number,currency}元人民币的损失。";
    2     Object[] params = {new Date(),500,1000000};
    3         
    4     String content = MessageFormat.format(pattern, params);
    5     System.out.println(content);
    View Code

    输出:

      

    结果就是:在2016年1月9日的时候,一场台风导致了500间房屋的摧毁和¥1,000,000.00元人民币的损失。

      可以看到这就跟我们的最开始定义的字符串文本相同了。

      占位符在框架中是经常被使用到的,当然占位符一般不会在程序代码中被使用,而是在资源文件properties被使用,这是想Struts2这样的框架经常被使用到的,结合前两篇的《国际化之ResourceBundle》,如果模式字符串在properties中使用,那么我们需要通过ResourceBundle通过资源文件的基名获取对象,并使用getString方法获取模式字符串,最后只要使用MessageFormat像上面一样处理就行了。

    例3:

      在工程中用一个包来封装一组资源包,该组资源包中默认的资源配置文件基名为“MessageResource”,同时配有中文和英文两个资源配置文件,如下图所示:

      

    在默认的资源文件“MessageResource.properties”中定义的内容如下:

      

    在中文资源文件“MessageResource_zh.properties”中定义的内容如下:

      

      英文资源文件和默认资源文件中的内容是一样的,这里就不再贴出。

      因为我们将资源文件放在包中,所以基名应该包括包名,这一点在博文《《国际化之ResourceBundle》中已经说明。

    在程序中代码如下:

    1     ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.CHINA);
    2     String pattern = bundle.getString("message");  //获取模式字符串
    3     Object[] params = {new Date(),500,10000000};
    4         
    5     String content = MessageFormat.format(pattern, params);
    6     System.out.println(content);
    View Code

    输出:在16-1-9 下午8:59的时候,一场台风导致了500间房屋的摧毁和10,000,000元人民币的损失。

    注意:⑴ 这里占位符对应的地方格式并不友好,这是因为占位符没有使用特定的格式,参见例2。

       ⑵ 在ResourceBundle获取对象中使用到了Locale是以中国的形式,因此最后输出的是中文,如果想以美国作为Locale,那么将会输出英文:

    修改代码为:

    1     ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.US);
    2     String pattern = bundle.getString("message"); //获取模式字符串
    3     Object[] params = {new Date(),500,10000000};
    4         
    5     String content = MessageFormat.format(pattern, params);
    6     System.out.println(content);
    View Code

    输出:On 16-1-9 下午9:03, a typhoon destory 500 houses and caused 10,000,000 of damage.

      看上去似乎很正确,但是在这些英文中出现了中文,而且是在占位符对应的地方,说明我们还未将MessageFormat对象的代表的语言国家环境修改,最终代码如下:

    1     ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.US);
    2     String pattern = bundle.getString("message");  //获取模式字符串
    3     Object[] params = {new Date(),500,10000000};
    4         
    5     MessageFormat mf = new MessageFormat(pattern, Locale.US);
    6     String content = mf.format(params);
    7     System.out.println(content);
    View Code

    输出:On 1/9/16 9:07 PM, a typhoon destory 500 houses and caused 10,000,000 of damage.

           

  • 相关阅读:
    Sql中联合查询中的”子查询返回的值不止一个“的问题
    关于.NET,.NET Framework 和ASP.NET的总结
    JavaScript中fn()和return fn()
    js连等赋值
    JS的Object漫想:从现象到“本质”
    javascript中的Function和Object
    javascript关于立即函数
    nodejs模块中exports和module.exports的区别
    nodejs处理url工具
    Spring学习记录(十四)---JDBC基本操作
  • 原文地址:https://www.cnblogs.com/fjdingsd/p/5143625.html
Copyright © 2020-2023  润新知