如果一个字符串文本中包含了多个与国际化相关的数据,可以使用MessageFormat类对这些数据进行批量处理。
例如:
在2016年1月9日的时候,一场台风导致了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:
String pattern = "在{0}的时候,一场台风导致了{1}间房屋的摧毁和{2}元人民币的损失。";
Object[] params = {new Date(),500,1000000};
MessageFormat mf = new MessageFormat(pattern);
String content = mf.format(params);
System.out.println(content);
上述代码等同于:
String pattern = "在{0}的时候,一场台风导致了{1}间房屋的摧毁和{2}元人民币的损失。";
Object[] params = {new Date(),500,1000000};
String content = MessageFormat.format(pattern, params);
System.out.println(content);
输出:
结果就是:在16-1-9 下午7:56的时候,一场台风导致了500间房屋的摧毁和1,000,000元人民币的损失。
可以看到在对应的占位符上,我们用对象数组中的内容替代了占位符。但是似乎和最开始我们规定的字符串文本有点不同?
最开始我们规定的文本:
在2016年1月9日的时候,一场台风导致了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:
String pattern = "在{0,date,long}的时候,一场台风导致了{1}间房屋的摧毁和{2,number,currency}元人民币的损失。";
Object[] params = {new Date(),500,1000000}; String content = MessageFormat.format(pattern, params);
System.out.println(content);
输出:
结果就是:在2016年1月9日的时候,一场台风导致了500间房屋的摧毁和¥1,000,000.00元人民币的损失。
可以看到这就跟我们的最开始定义的字符串文本相同了。
占位符在框架中是经常被使用到的,当然占位符一般不会在程序代码中被使用,而是在资源文件properties被使用,这是想Struts2这样的框架经常被使用到的,结合前两篇的《国际化之ResourceBundle》,如果模式字符串在properties中使用,那么我们需要通过ResourceBundle通过资源文件的基名获取对象,并使用getString方法获取模式字符串,最后只要使用MessageFormat像上面一样处理就行了。
例3:
在工程中用一个包来封装一组资源包,该组资源包中默认的资源配置文件基名为“MessageResource”,同时配有中文和英文两个资源配置文件,如下图所示:
在默认的资源文件“MessageResource.properties”中定义的内容如下:
在中文资源文件“MessageResource_zh.properties”中定义的内容如下:
英文资源文件和默认资源文件中的内容是一样的,这里就不再贴出。
因为我们将资源文件放在包中,所以基名应该包括包名,这一点在博文《《国际化之ResourceBundle》中已经说明。
在程序中代码如下:
ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.CHINA);
String pattern = bundle.getString("message"); //获取模式字符串
Object[] params = {new Date(),500,10000000}; String content = MessageFormat.format(pattern, params);
System.out.println(content);
输出:在16-1-9 下午8:59的时候,一场台风导致了500间房屋的摧毁和10,000,000元人民币的损失。
注意:⑴ 这里占位符对应的地方格式并不友好,这是因为占位符没有使用特定的格式,参见例2。
⑵ 在ResourceBundle获取对象中使用到了Locale是以中国的形式,因此最后输出的是中文,如果想以美国作为Locale,那么将会输出英文:
修改代码为:
ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.US);
String pattern = bundle.getString("message"); //获取模式字符串
Object[] params = {new Date(),500,10000000}; String content = MessageFormat.format(pattern, params);
System.out.println(content);
输出:On 16-1-9 下午9:03, a typhoon destory 500 houses and caused 10,000,000 of damage.
看上去似乎很正确,但是在这些英文中出现了中文,而且是在占位符对应的地方,说明我们还未将MessageFormat对象的代表的语言国家环境修改,最终代码如下:
ResourceBundle bundle = ResourceBundle.getBundle("com.fjdingsd.resource.MessageResource",Locale.US);
String pattern = bundle.getString("message"); //获取模式字符串
Object[] params = {new Date(),500,10000000}; MessageFormat mf = new MessageFormat(pattern, Locale.US);
String content = mf.format(params);
System.out.println(content);
输出:On 1/9/16 9:07 PM, a typhoon destory 500 houses and caused 10,000,000 of damage.