|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.text
类 MessageFormat
java.lang.Object java.text.Format java.text.MessageFormat
- 所有已实现的接口:
- Serializable, Cloneable
-
public class MessageFormat
- extends Format
MessageFormat
提供了以与语言无关方式生成连接消息的方式。使用此方法构造向终端用户显示的消息。
MessageFormat
获取一组对象,格式化这些对象,然后将格式化后的字符串插入到模式中的适当位置。
注:MessageFormat
不同于其他 Format
类,因为 MessageFormat
对象是用其构造方法之一创建的(而不是使用 getInstance
样式的工厂方法创建的)。工厂方法不是必需的,因为 MessageFormat
本身不实现特定于语言环境的行为。特定于语言环境的行为是由所提供的模式和用于已插入参数的子格式来定义的。
模式及其解释
MessageFormat
使用以下形式的模式:
MessageFormatPattern: String MessageFormatPattern FormatElement String FormatElement: { ArgumentIndex } { ArgumentIndex , FormatType } { ArgumentIndex , FormatType , FormatStyle } FormatType: one of number date time choice FormatStyle: short medium long full integer currency percent SubformatPattern String: StringPartopt String StringPart StringPart: '' ' QuotedString ' UnquotedString SubformatPattern: SubformatPatternPartopt SubformatPattern SubformatPatternPart SubFormatPatternPart: ' QuotedPattern ' UnquotedPattern
在 String 中,"''"
表示单引号。QuotedString 可以包含除单引号之外的任意字符;围绕的单引号被移除。UnquotedString 可以包含除单引号和左花括号之外的任意字符。因此,格式化后消息字符串为 "'{0}'" 的字符串可以写作 "'''{'0}''"
或 "'''{0}'''"
。
在 SubformatPattern 中,应用了不同的规则。QuotedPattern 可包含除单引号之外的任意字符,但不移除围绕的单引号,因此它们可以由子格式解释。例如,"{1,number,$'#',##}"
将产生一个带井号的数字格式,结果如:"$#31,45"。 UnquotedPattern 可以包含除单引号之外的任意字符,但其中的花括号必须成对出现。例如,"ab {0} de"
和 "ab '}' de"
是有效的子格式模式,而 "ab {0'}' de"
和 "ab } de"
则是无效的。
- 警告:
- 不过,在消息格式模式中使用引号的规则在一定程度上显示混乱。尤其是,本地化程序并不总是清楚单引号是否需要成对。要确保通知本地化程序关于规则的信息,并告诉它们(例如,通过使用资源包源文件中的注释)MessageFormat 将处理哪些字符串。注意,本地化程序在转换后的字符串中必须使用单引号,其中原始版本不包含单引号。
ArgumentIndex 值是使用数字 '0' 到 '9' 表示的非负整数,它表示传递给 format
方法的 arguments
数组的一个索引,或者表示由 parse
方法返回的结果数组的一个索引。
FormatType 和 FormatStyle 值用来创建格式元素的 Format
实例。下表显示了值如何映射到 Format 实例。表中没有显示的组合是非法的。SubformatPattern 必须是所使用的 Format 子类的一个有效的模式字符串。
格式类型 | 格式样式 | 创建的子格式 |
---|---|---|
无 | 无 | null |
number |
无 | NumberFormat.getInstance(getLocale()) |
integer |
NumberFormat.getIntegerInstance(getLocale()) |
|
currency |
NumberFormat.getCurrencyInstance(getLocale()) |
|
percent |
NumberFormat.getPercentInstance(getLocale()) |
|
SubformatPattern | new DecimalFormat(subformatPattern, new DecimalFormatSymbols(getLocale())) |
|
date |
无 | DateFormat.getDateInstance(DateFormat.DEFAULT, getLocale()) |
short |
DateFormat.getDateInstance(DateFormat.SHORT, getLocale()) |
|
medium |
DateFormat.getDateInstance(DateFormat.DEFAULT, getLocale()) |
|
long |
DateFormat.getDateInstance(DateFormat.LONG, getLocale()) |
|
full |
DateFormat.getDateInstance(DateFormat.FULL, getLocale()) |
|
SubformatPattern | new SimpleDateFormat(subformatPattern, getLocale()) |
|
time |
无 | DateFormat.getTimeInstance(DateFormat.DEFAULT, getLocale()) |
short |
DateFormat.getTimeInstance(DateFormat.SHORT, getLocale()) |
|
medium |
DateFormat.getTimeInstance(DateFormat.DEFAULT, getLocale()) |
|
long |
DateFormat.getTimeInstance(DateFormat.LONG, getLocale()) |
|
full |
DateFormat.getTimeInstance(DateFormat.FULL, getLocale()) |
|
SubformatPattern | new SimpleDateFormat(subformatPattern, getLocale()) |
|
choice |
SubformatPattern | new ChoiceFormat(subformatPattern) |
用法信息
下面给出一些用法例子。当然,在实际的国际化程序中,消息格式模式和其他静态字符串将从资源包中获取。其他参数在运行时动态确定。
第一个例子使用静态的方法 MessageFormat.format
,它在内部创建一个只使用一次的 MessageFormat
:
输出为:int planet = 7; String event = "a disturbance in the Force"; String result = MessageFormat.format( "At {1,time} on {1,date}, there was {2} on planet {0,number,integer}.", planet, new Date(), event);
At 12:30 PM on Jul 3, 2053, there was a disturbance in the Force on planet 7.
下面的例子创建了一个可以重复使用的 MessageFormat
实例:
不同int fileCount = 1273; String diskName = "MyDisk"; Object[] testArgs = {new Long(fileCount), diskName}; MessageFormat form = new MessageFormat( "The disk \"{1}\" contains {0} file(s)."); System.out.println(form.format(testArgs));
fileCount
值的输出:
The disk "MyDisk" contains 0 file(s). The disk "MyDisk" contains 1 file(s). The disk "MyDisk" contains 1,273 file(s).
对于更复杂的模式,可以使用 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.setFormatByArgumentIndex(0, fileform); int fileCount = 1273; String diskName = "MyDisk"; Object[] testArgs = {new Long(fileCount), diskName}; System.out.println(form.format(testArgs));
fileCount
值的输出:
The disk "MyDisk" contains no files. The disk "MyDisk" contains one file. The disk "MyDisk" contains 1,273 files.
如上例所示,可以以编程方式来创建 ChoiceFormat
,或使用模式创建。有关更多信息,请参阅 ChoiceFormat
。
form.applyPattern( "There {0,choice,0#are no files|1#is one file|1<are {0,number,integer} files}.");
注:从上面的例子可以看到,由 MessageFormat
中的 ChoiceFormat
所生成的字符串要进行特殊处理;'{' 的出现用来指示子格式,并导致递归。如果 MessageFormat
和 ChoiceFormat
都是以编程方式创建的(而不是使用字符串模式),那么要注意不要生成对其自身进行递归的格式,这将导致无限循环。
当一个参数在字符串中被多次分析时,最后的匹配将是分析的最终结果。例如,
MessageFormat mf = new MessageFormat("{0,number,#.##}, {0,number,#.#}"); Object[] objs = {new Double(3.1415)}; String result = mf.format( objs ); // result now equals "3.14, 3.1" objs = null; objs = mf.parse(result, new ParsePosition(0)); // objs now equals {new Double(3.1)}
同样,使用包含同一参数多个匹配项的模式对 MessageFormat 对象进行分析时将返回最后的匹配。例如,
MessageFormat mf = new MessageFormat("{0}, {0}, {0}"); String forParsing = "x, y, z"; Object[] objs = mf.parse(forParsing, new ParsePosition(0)); // result now equals {new String("z")}
同步
消息格式不是同步的。建议为每个线程创建独立的格式实例。如果多个线程同时访问一个格式,则它必须是外部同步的。
- 另请参见:
-
Locale
,Format
,NumberFormat
,DecimalFormat
,ChoiceFormat
, 序列化表格
嵌套类摘要 | |
---|---|
static class |
MessageFormat.Field 在从 MessageFormat.formatToCharacterIterator 返回的 AttributedCharacterIterator 中定义用作属性键的常量。 |
构造方法摘要 | |
---|---|
MessageFormat(String pattern) 构造默认语言环境和指定模式的 MessageFormat。 |
|
MessageFormat(String pattern, Locale locale) 构造指定语言环境和模式的 MessageFormat。 |
方法摘要 | |
---|---|
void |
applyPattern(String pattern) 设置此消息格式所使用的模式。 |
Object |
clone() 创建并返回此对象的一个副本。 |
boolean |
equals(Object obj) 两个消息格式对象之间的相等性比较 |
StringBuffer |
format(Object[] arguments, StringBuffer result, FieldPosition pos) 格式化一个对象数组,并将 MessageFormat 的模式追加到所提供的 StringBuffer ,用格式化后的对象替换格式元素。 |
StringBuffer |
format(Object arguments, StringBuffer result, FieldPosition pos) 格式化一个对象数组,并将 MessageFormat 的模式追加到所提供的 StringBuffer ,用格式化后的对象替换格式元素。 |
static String |
format(String pattern, Object... arguments) 创建具有给定模式的 MessageFormat,并用它来格式化给定的参数。 |
AttributedCharacterIterator |
formatToCharacterIterator(Object arguments) 格式化一个对象数组,并将它们插入 MessageFormat 的模式中,生成一个 AttributedCharacterIterator 。 |
Format[] |
getFormats() 获取用于以前所设置的模式字符串中格式元素的格式。 |
Format[] |
getFormatsByArgumentIndex() 获取传递给 format 方法或从 parse 方法返回的值的格式。 |
Locale |
getLocale() 获取创建或比较子格式时所使用的语言环境。 |
int |
hashCode() 生成此消息格式对象的哈希码。 |
Object[] |
parse(String source) 从给定字符串的开始位置分析文本,以生成一个对象数组。 |
Object[] |
parse(String source, ParsePosition pos) 分析字符串。 |
Object |
parseObject(String source, ParsePosition pos) 分析字符串文本,生成一个对象数组。 |
void |
setFormat(int formatElementIndex, Format newFormat) 使用在以前设置的模式字符串中给定的格式元素索引来设置格式元素使用的格式。 |
void |
setFormatByArgumentIndex(int argumentIndex, Format newFormat) 设置用于以前所设置的模式字符串中格式元素的格式,其中以前的模式字符串是用给定的参数索引设置的。 |
void |
setFormats(Format[] newFormats) 设置用于以前所设置的模式字符串中格式元素的格式。 |
void |
setFormatsByArgumentIndex(Format[] newFormats) 设置传递给 format 方法或从 parse 方法返回的值使用的格式。 |
void |
setLocale(Locale locale) 设置创建或比较子格式时要使用的语言环境。 |
String |
toPattern() 返回表示消息格式当前状态的模式。 |
从类 java.text.Format 继承的方法 |
---|
format, parseObject |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
MessageFormat
public MessageFormat(String pattern)
-
构造默认语言环境和指定模式的 MessageFormat。构造方法首先设置语言环境,然后分析模式,并为其包含的格式元素创建子格式列表。在类描述中指定了模式及其解释。
- 参数:
-
pattern
- 此消息格式的模式 - 抛出:
-
IllegalArgumentException
- 如果模式无效
MessageFormat
public MessageFormat(String pattern, Locale locale)
-
构造指定语言环境和模式的 MessageFormat。构造方法首先设置语言环境,然后分析模式,并为其包含的格式元素创建子格式列表。在类描述中指定了模式及其解释。
- 参数:
-
pattern
- 此消息格式的模式 -
locale
- 此消息格式的语言环境 - 抛出:
-
IllegalArgumentException
- 如果模式无效 - 从以下版本开始:
- 1.4
方法详细信息 |
---|
setLocale
public void setLocale(Locale locale)
-
设置创建或比较子格式时要使用的语言环境。这将影响对
applyPattern
和toPattern
方法以及format
和formatToCharacterIterator
方法的后续调用。 -
- 参数:
-
locale
- 创建或比较子格式时所使用的语言环境
getLocale
public Locale getLocale()
- 获取创建或比较子格式时所使用的语言环境。
-
- 返回:
- 创建或比较子格式时所使用的语言环境
applyPattern
public void applyPattern(String pattern)
- 设置此消息格式所使用的模式。此方法对模式进行分析,并为其所包含的格式元素创建子格式列表。在类描述中指定了模式及其解释。
-
- 参数:
-
pattern
- 此消息格式的模式 - 抛出:
-
IllegalArgumentException
- 如果模式无效
toPattern
public String toPattern()
- 返回表示消息格式当前状态的模式。字符串是从内部信息创建的,因此不需要与以前应用的模式相等。
-
- 返回:
- 表示消息格式当前状态的模式
setFormatsByArgumentIndex
public void setFormatsByArgumentIndex(Format[] newFormats)
-
设置传递给
format
方法或从parse
方法返回的值使用的格式。newFormats
中元素的索引对应于以前设置的模式字符串中使用的参数索引。因此,newFormats
中的格式顺序对应于传递给format
方法的arguments
数组或从parse
方法返回的 结果数组中的元素顺序。如果一个参数索引用于模式字符串中的多个格式元素,那么对应的新的格式将用于所有这样的格式元素。如果参数索引不用于模式字符串的任何一个格式元素,那么对应的新的格式将被忽略。如果提供的格式少于所需的格式,那么只替换其参数索引小于
newFormats.length
的格式。 -
- 参数:
-
newFormats
- 要使用的新格式 - 抛出:
-
NullPointerException
- 如果newFormats
为 null - 从以下版本开始:
- 1.4
setFormats
public void setFormats(Format[] newFormats)
-
设置用于以前所设置的模式字符串中格式元素的格式。
newFormats
中的格式顺序对应于模式字符串中的格式元素的顺序。如果提供的格式多于模式字符串所需的格式,那么剩余的格式将被忽略。如果提供的格式少于所需的格式,那么只替换前
newFormats.length
个格式。由于在本地化期间,模式字符串中的格式元素顺序经常发生变化,因此最好使用
setFormatsByArgumentIndex
方法,此方法假定格式顺序对应于传递给format
方法或从parse
返回的arguments
数组中的元素顺序。 -
- 参数:
-
newFormats
- 要使用的新格式 - 抛出:
-
NullPointerException
- 如果newFormats
为 null