MessageFormat用法

MessageFormat本身与语言环境无关,而与用户提供给MessageFormat的模式和用于已插入参数的子格式模式有关,以生成适用于不同语言环境的消息。

1. MessageFormat模式(主要部分):

FormatElement:
         { ArgumentIndex }:是从0开始的入参位置索引。
         { ArgumentIndex , FormatType }
         { ArgumentIndex , FormatType , FormatStyle }
 
 FormatType: :指定使用不同的Format子类对入参进行格式化处理。值范围如下:
         number:调用NumberFormat进行格式化
         date:调用DateFormat进行格式化
         time:调用DateFormat进行格式化
         choice:调用ChoiceFormat进行格式化
 
 FormatStyle::设置FormatType中使用的格式化样式。值范围如下:
         short
         medium
         long
         full
         integer
         currency
         percent
         SubformatPattern (子格式模式,形如#.##)

 

1.1 以str为例,在这个字符串中:

  1、{0}和{1,number,short}和{2,number,#.#};都属于FormatElement,0,1,2是ArgumentIndex。
  2、{1,number,short}里面的number属于FormatType,short则属于FormatStyle。
  3、{1,number,#.#}里面的#.#就属于子格式模式。
  指定FormatType和FormatStyle是为了生成日期格式的值、不同精度的数字、百分比类型等等。
 

2. 例子

2.1 ArgumentIndex必须是非负整数,它的个数不只限于0到9这10个,它可以用0到9的数字组成,因此可以有好多个

String msg = "{0}{1}{2}{3}{4}{5}{6}{7}{8}{9}{10}{11}{12}";
Object[] arrys = new Object[]{"A","B","C","D","E","F","G","H","J","K","L","M","N"};
String value = MessageFormat.format(msg, arrys);
System.out.println(value);
// ABCDEFGHJKLMN

2.2 格式化字符串时,两个单引号才表示一个单引号,单个单引号会被省略,除非中文单引号不会被省略

String value1 = MessageFormat.format("oh, {0} is 'a' handsome guy", "ZhangSan");
System.out.println(value1);
// oh, ZhangSan is a handsome guy
给字母a加上单引号
String value2 = MessageFormat.format("oh, {0} is ''a'' handsome guy", "ZhangSan");
System.out.println(value2);
// oh, ZhangSan is 'a' handsome guy
如果需要显示双引号要进行转移,比如:String msg = "oh, {0} is \"a\" handsome guy"
String value3 = MessageFormat.format("oh, {0} is \"a\" handsome guy", "ZhangSan");
System.out.println(value3);
// oh, ZhangSan is "a" handsome guy

 

2.3 单引号会使其后面的占位符均失效,导致直接输出占位符

String value4 = MessageFormat.format("{0}{1}", 1, 2);
System.out.println(value4);
// 12

String value5 = MessageFormat.format("'{0}{1}", 1, 2);
System.out.println(value5);
// {0}{1}

String value6 = MessageFormat.format("'{0}'-{1}", 1, 2);
System.out.println(value6);
// {0}-2

 

2.4 使用子格式模式

String value7 = MessageFormat.format("oh, {0,number,#.##} is good num", Double.valueOf("3.1415"));
System.out.println(value7);
// oh, 3.14 is good num
无论是有引号字符串还是无引号字符串,左花括号都是不支持的
String value8 = MessageFormat.format("oh, } is good num", Double.valueOf("3.1415"));
System.out.println(value8);
// oh, } is good num
如果使用左花括号会出现异常
String value9 = MessageFormat.format("oh, { is good num", Double.valueOf("3.1415"));
System.out.println(value9);

// 报错异常
// java.lang.IllegalArgumentException: Unmatched braces in the pattern.

 

2.5 要使用到左花括号需要使用单引号配合使用

String value10 = MessageFormat.format("'{'{0}}", "X-rapido");
System.out.println(value10);
// {X-rapido}

3. 关于MessageFormat.format方法

每调用一次MessageFormat.format方法,都会新创建MessageFormat的一个实例,相当于MessageFormat只使用了一次。MessageFormat类的format方法如下:
public static String format(String pattern, Object ... arguments) {
    MessageFormat temp = new MessageFormat(pattern);
    return temp.format(arguments);
}
因此若要多次格式同一个模式的字符串,那么创建一个MessageFormat实例在执行格式化操作比较好些
如下:
String message = "oh, {0} is a handsome guy";  
MessageFormat messageFormat = new MessageFormat(message);  
Object[] array = new Object[]{"ZhangSan"};  
String value = messageFormat.format(array);  

System.out.println(value); 

 

posted @ 2022-05-07 15:32  xiexie0812  阅读(115)  评论(0编辑  收藏  举报