MessageFormat

MessageFormat

MessageFormat (String pattern)

构造默认语言环境和指定模式的MessageFormat。 构造函数首先设置区域设置，然后解析模式并为其中包含的格式元素创建子格式列表。 模式及其解释在class description中指定。

MessageFormat

MessageFormat (String pattern, 
                Locale locale)

为指定的语言环境和模式构造MessageFormat。 构造函数首先设置区域设置，然后解析模式并为其中包含的格式元素创建子格式列表。 模式及其解释在class description中指定。

applyPattern

void applyPattern (String pattern)

设置此消息格式使用的模式。 该方法解析模式并为其中包含的格式元素创建一个子格式列表。 模式及其解释在class description中指定。

clone

Object clone ()

创建并返回此对象的副本。

equals

boolean equals (Object obj)

两个消息格式对象之间的平等比较

format

StringBuffer format (Object[] arguments, 
                StringBuffer result, 
                FieldPosition pos)

格式化一个对象数组，并将 MessageFormat的模式（格式化元素替换为格式化对象） StringBuffer到提供的 StringBuffer 。

用于各个格式元素取代的文本被从格式元件的电流子格式和派生arguments元件格式元素的参数索引在由下表的第一匹配线所示。 如果arguments是null或者少于argumentIndex + 1元素，则参数不可用 。

如果 pos非空，并且指向 Field.ARGUMENT ，则返回第一个格式化字符串的位置。

format

StringBuffer format (Object arguments, 
                StringBuffer result, 
                FieldPosition pos)

格式化对象数组，并将MessageFormat的模式（格式化元素替换为格式化对象） StringBuffer到提供的StringBuffer 。 这相当于

format((Object[]) arguments, result, pos)

format

String format (String pattern, 
                Object... arguments)

用给定的模式创建一个MessageFormat并使用它来格式化给定的参数。 这相当于

(new MessageFormat(pattern)).format(arguments, new StringBuffer(), null).toString()

formatToCharacterIterator

AttributedCharacterIterator formatToCharacterIterator (Object arguments)

格式化一组对象并将它们插入到MessageFormat的模式中，产生一个AttributedCharacterIterator 。 您可以使用返回的AttributedCharacterIterator来生成结果字符串，以及确定有关生成的字符串的信息。

返回的 AttributedCharacterIterator的文本与将返回的文本相同

format(arguments, new StringBuffer(), null).toString()

另外， AttributedCharacterIterator至少包含指示arguments数组中的参数生成文本的属性。 这些属性的键类型为MessageFormat.Field ，它们的值为Integer对象，指示生成文本的参数的arguments数组中的索引。

来自MessageFormat使用的底层Format实例的属性/值也将被放置在结果AttributedCharacterIterator 。 这使您不仅可以找到参数在结果字符串中的位置，而且还可以找到它包含的字段。

getFormats

Format[] getFormats ()

获取用于先前设置的模式字符串中格式元素的格式。 返回数组中格式的顺序对应于模式字符串中格式元素的顺序。

由于模式字符串中格式元素的顺序在本地化过程中经常发生变化，因此使用 getFormatsByArgumentIndex方法通常会更好，该方法假定格式顺序与 arguments数组中传递给 format方法或返回结果数组的元素顺序相对应由 parse方法。

getFormatsByArgumentIndex

Format[] getFormatsByArgumentIndex ()

获取用于传递给format方法的值或从parse方法返回的值的格式。 返回数组中元素的索引与先前设置的模式字符串中使用的参数索引相对应。 返回数组中格式的顺序因此对应于传递给format方法的arguments数组中元素的顺序或format方法返回的结果数组的parse 。

如果参数索引用于模式字符串中的多个格式元素，则用于最后一个这样的格式元素的格式将返回到数组中。 如果参数索引不用于模式字符串中的任何格式元素，则返回数组中的null。

getLocale

Locale getLocale ()

获取创建或比较子格式时使用的语言环境。

hashCode

int hashCode ()

为消息格式对象生成哈希码。

parse

Object[] parse (String source)

从给定字符串的开头分析文本以生成对象数组。 该方法可能不会使用给定字符串的整个文本。

有关消息解析的更多信息，请参阅 parse(String, ParsePosition)方法。

parse

Object[] parse (String source, 
                ParsePosition pos)

分析字符串。

注意事项：在许多情况下，解析可能会失败。 例如：

• If one of the arguments does not occur in the pattern.
• If the format of an argument loses information, such as with a choice format where a large number formats to "many".
• Does not yet handle recursion (where the substituted strings contain {n} references.)
• Will not always find a match (or the correct match) if some part of the parse is ambiguous. For example, if the pattern "{1},{2}" is used with the string arguments {"a,b", "c"}, it will format as "a,b,c". When the result is parsed, it will return {"a", "b,c"}.
• If a single argument is parsed more than once in the string, then the later parse wins.

parseObject

Object parseObject (String source, 
                ParsePosition pos)

分析字符串中的文本以生成对象数组。

该方法尝试解析从pos给出的索引处开始的文本。 如果解析成功，则在使用最后一个字符（解析不一定使用到字符串末尾的所有字符）之后，将索引pos更新为索引，并返回解析的对象数组。 更新的pos可用于指示下一次调用此方法的起点。 如果发生错误，那么索引pos不会更改，错误索引pos将设置为发生错误的字符的索引，并返回null。

有关消息解析的更多信息，请参阅 parse(String, ParsePosition)方法。

setFormat

void setFormat (int formatElementIndex, 
                Format newFormat)

在先前设置的模式字符串中设置格式元素使用的格式，格式元素具有给定的格式元素索引。 格式元素索引是从模式字符串开始计数的格式元素的从零开始的数字。

由于模式字符串中格式元素的顺序在本地化过程中经常发生变化，因此通常使用 setFormatByArgumentIndex方法更好，该方法根据它们指定的参数索引访问格式元素。

setFormatByArgumentIndex

void setFormatByArgumentIndex (int argumentIndex, 
                Format newFormat)

设置用于先前设置的模式字符串中使用给定参数索引的格式元素的格式。 参数索引是格式元素定义的一部分，表示传递给format方法的arguments数组或由parse方法返回的结果数组的parse 。

如果参数索引用于模式字符串中的多个格式元素，则新格式将用于所有此类格式元素。 如果参数索引不用于模式字符串中的任何格式元素，则新格式将被忽略。

setFormats

void setFormats (Format[] newFormats)

设置用于先前设置的模式字符串中格式元素的格式。 格式在newFormats中的顺序对应于模式字符串中格式元素的顺序。

如果提供了比模式字符串所需格式更多的格式，则其余格式将被忽略。 如果提供的格式少于需要的格式，则只替换第一个newFormats.length格式。

由于模式字符串中格式元素的顺序在本地化过程中经常发生变化，因此使用 setFormatsByArgumentIndex方法通常会更好，该方法假定格式顺序与 arguments数组中元素的顺序相对应， arguments传递给 format方法或结果数组由 parse方法返回。

setFormatsByArgumentIndex

void setFormatsByArgumentIndex (Format[] newFormats)

设置用于传递给format方法的值或从parse方法返回的值的格式。 newFormats中元素的newFormats对应于先前设置的模式字符串中使用的参数索引。 newFormats中格式的newFormats因此对应于传递给format方法的arguments数组中元素的顺序或format方法返回的结果数组的parse 。

如果参数索引用于模式字符串中的多个格式元素，则相应的新格式将用于所有此类格式元素。 如果参数索引不用于模式字符串中的任何格式元素，则忽略相应的新格式。 如果提供的格式少于需要的格式， newFormats.length替换参数索引小于newFormats.length的格式。

setLocale

void setLocale (Locale locale)

设置创建或比较子格式时要使用的语言环境。 这会影响后续调用

• to the applyPattern and toPattern methods if format elements specify a format type and therefore have the subformats created in the applyPattern method, as well as
• to the format and formatToCharacterIterator methods if format elements do not specify a format type and therefore have the subformats created in the formatting methods.

toPattern

String toPattern ()

返回表示消息格式当前状态的模式。 该字符串由内部信息构成，因此不一定等于先前应用的模式。