java.lang.Object
|
+----java.text.Format
|
+----java.text.MessageFormat
MessageFormat 提供了一种用中性语言方式产生连接信息的方法。 用该类构造显示给最终用户的信息。
MessageFormat 产生一系列对象，格式化它们，然后把格式化的字符串插入模式中恰当的地方。
注意：
MessageFormat 与其它 Format 类不同，用对象的构造子创建一个 MessageFormat 对象 ( 而不是用一个
getInstance 风格的工厂方法 )。 不需要这些工厂方法，因为
MessageFormat 不要求为给定的语言环境进行复杂的设置。
实际上，MessageFormat 根本没有实现任何语言环境特定的行为。 它只需要以句子为基础在句子上建立。
下面是一些用法示例：
Object[] arguments = {
new Integer(7),
new Date(System.currentTimeMillis()),
"a disturbance in the Force"
};
String result = MessageFormat.format(
"At {1,time} on {1,date}, there was {2} on planet {0,number,integer}.",
arguments);
通常，消息的格式来自于资源，且参数将在运行期间动态的设置。
示例 2：
Object[] testArgs = {new Long(3), "MyDisk"};
MessageFormat form = new MessageFormat(
"The disk \"{1}\" contains {0} file(s).");
System.out.println(form.format(testArgs));
// output, with different testArgs
模式的形式是：
messageFormatPattern := string ( "{" messageFormatElement "}" string )*
messageFormatElement := argument { "," elementFormat }
elementFormat := "time" { "," datetimeStyle }
| "date" { "," datetimeStyle }
| "number" { "," numberStyle }
| "choice" { "," choiceStyle }
datetimeStyle := "short"
| "medium"
| "long"
| "full"
| dateFormatPattern
numberStyle := "currency"
| "percent"
| "integer"
| numberFormatPattern
choiceStyle := choiceFormatPattern
如果没有 elementFormat，那么参数必须用一个字符串代替。
如果没有 dateTimeStyle 或 numberStyle，就使用缺省格式 ( 例如，NumberFormat.getInstance、
DateFormat.getTimeInstance 或
DateFormat.getInstance)。
必要的话，在字符串中的单引号可用来引起 "{"( 花括号 )。 一个真正的单引号用 '' 表示。
在 messageFormatElement 中，引号不被删除。 例如，{1,number,$'#',##} 将产生一个含有被引起的磅符号的数字格式，结果是诸如 "$#31,45" 的形式。
如果使用了一个模式，模式中如果有未括起的花括号，它们必须匹配：即 "ab {0} de" 和 "ab '}' de" 是合法的，但是 "ab {0'}' de" and "ab } de" 是非法的。
参数是 0 到 9 之间的数字，它相应与格式化的数组中的参数。
数组中可以含有未用的参数。 但如果缺少参数或参数不是特定格式要求的正确的类的对象，将抛出一个 ParseException。 首先，
format 检验是否用 setFormats 方法为参数指定了一个 Format 对象。 如果指定了，那么
format 使用这个 Format 对象格式化该参数。
否则根据对象的类型格式化参数。 如果参数是一个 Number，那么 format 用 NumberFormat.getInstance 格式化该参数；如果参数是一个 Date，那么
format 用 DateFormat.getDateTimeInstance 格式化该参数。 否则它使用 toString 方法。
对于更复杂的模式，可用 ChoiceFormat 输出，如：
MessageFormat form = new MessageFormat("The disk \"{1}\" contains {0}.");
double[] filelimits = {0,1,2};
String[] filepart = {"no files","one file","{0,number} files"};
ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
form.setFormat(1,fileform); // NOT zero, see below
Object[] testArgs = {new Long(12373), "MyDisk"};
System.out.println(form.format(testArgs));
// output, with different testArgs
output: The disk "MyDisk" contains no files.
output: The disk "MyDisk" contains one file.
output: The disk "MyDisk" contains 1,273 files.
可以象上面示例中那样用程序完成格式化，也可以用一个模式 ( 有关的更多信息请参阅
ChoiceFormat)
，如：
form.applyPattern(
"There {0,choice,0#are no files|1#is one file|1#are {0,number,integer} files}.");
注意： 就象上面看到的那样，由
MessageFormat 中的 ChoiceFormat 产生的字符串将被特别对待；'{' 用于指示子格式并将产生递归。 如果用程序创建了
MessageFormat 和 ChoiceFormat ( 而不是用字符串模式 )，那么注意不要产生一个在自身上递归的格式，这将引起无限循环。
注意： 格式按照字符串中变量的顺序编号。这与参数编号不同。 例如："abc{2}def{3}ghi{0}...",
可以在 applyPattern 之后使用 setLocale
( 可能再调用 setFormat) 以不同的语言环境重新初始化
MessageFormat。
public MessageFormat(String pattern)
public void setLocale(Locale theLocale)
public Locale getLocale()
public void applyPattern(String newPattern)
public String toPattern()
public void setFormats(Format newFormats[])
public void setFormat(int variable,
Format newFormat)
public Format[] getFormats()
public final StringBuffer format(Object source[],
StringBuffer result,
FieldPosition ignore)
public static String format(String pattern,
Object arguments[])
public final StringBuffer format(Object source,
StringBuffer result,
FieldPosition ignore)
public Object[] parse(String source,
ParsePosition status)
警告：在许多环境下分列可能失败。 例如：
public Object[] parse(String source) throws ParseException
public Object parseObject(String text,
ParsePosition status)
public Object clone()
public boolean equals(Object obj)
public int hashCode()