java.util.spi
类 LocaleNameProvider

java.lang.Object
  java.util.spi.LocaleServiceProvider
      java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
     

      extends 
      LocaleServiceProvider
     

为 Locale 类提供本地化名称的服务提供者的一个抽象类。

从以下版本开始：

1.6

LocaleNameProvider

protected LocaleNameProvider()

唯一的构造方法。（由子类构造方法调用，通常是隐式的）。

getDisplayLanguage

public abstract String getDisplayLanguage(String languageCode,
                                          Locale locale)

返回适合向用户显示的给定 ISO 639 语言代码和给定语言环境的本地化名称。例如，如果 languageCode 是 "fr" 并且 locale 是 en_US，则 getDisplayLanguage() 将返回 "French"；如果 languageCode 是 "en" 并且 locale 是 fr_FR，则 getDisplayLanguage() 将返回 "anglais"。如果无法根据 locale 对返回的名称进行本地化（比方说提供者没有 Croatian 的日本名称），则此方法返回 null。

参数：

languageCode - ISO 639 语言代码字符串，用 'a' (U+0061) 和 'z' (U+007A) 之间的两个小写字母表示

locale - 所需的语言环境

返回：

指定语言环境的给定语言代码的名称；如果该名称不可用，则返回 null。

抛出：

NullPointerException - 如果 languageCode 或 locale 为 null

IllegalArgumentException - 如果 languageCode 不是以两个小写字母的形式表示，或者 locale 不是从 getAvailableLocales() 返回的语言环境之一。

另请参见：

Locale.getDisplayLanguage(java.util.Locale)

getDisplayCountry

public abstract String getDisplayCountry(String countryCode,
                                         Locale locale)

返回适合向用户显示的给定 ISO 3166 国家代码和给定语言环境的本地化名称。例如，如果 countryCode 是 "FR" 并且 locale 是 en_US，则 getDisplayCountry() 将返回 "France"；如果 countryCode 是 "US" 并且 locale 是 fr_FR，则 getDisplayCountry() 将返回 "Etats-Unis"。如果无法根据 locale 对返回的名称进行本地化（比方说提供者没有 Croatia 的日本名称），则此方法返回 null。

参数：

countryCode - ISO 3166 国家代码字符串，用 'A' (U+0041) 和 'Z' (U+005A) 之间的两个大写字母表示

locale - 所需的语言环境

返回：

指定语言环境的给定国家代码的名称；如果该名称不可用，则返回 null。

抛出：

NullPointerException - 如果 countryCode 或 locale 为 null

IllegalArgumentException - 如果 countryCode 不是以两个大写字母的形式表示，或者 locale 不是从 getAvailableLocales() 返回的语言环境之一。

另请参见：

Locale.getDisplayCountry(java.util.Locale)

getDisplayVariant

public abstract String getDisplayVariant(String variant,
                                         Locale locale)

返回适合向用户显示的给定变量代码和给定语言环境的本地化名称。如果无法根据 locale 对返回的名称进行本地化，则此方法返回 null。

参数：

variant - 变量字符串

locale - 所需的语言环境

返回：

指定语言环境的给定变量字符串的名称，如果该名称不可用，则返回 null。

抛出：

NullPointerException - 如果 variant 或 locale 为 null

IllegalArgumentException - 如果 locale 不是从 getAvailableLocales() 返回的语言环境之一。

另请参见：

Locale.getDisplayVariant(java.util.Locale)