java.util.spi

java.lang.Object
  继承者 java.util.spi.LocaleServiceProvider
      继承者 java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
     
extends LocaleServiceProvider

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

从以下版本开始:
1.6

构造方法摘要
protected LocaleNameProvider()
          唯一的构造方法。
 
方法摘要
abstract  String getDisplayCountry(String countryCode, Locale locale)
          返回适合向用户显示的给定 ISO 3166 国家代码和给定语言环境的本地化名称。
abstract  String getDisplayLanguage(String languageCode, Locale locale)
          返回适合向用户显示的给定 ISO 639 语言代码和给定语言环境的本地化名称。
abstract  String getDisplayVariant(String variant, Locale locale)
          返回适合向用户显示的给定变量代码和给定语言环境的本地化名称。
 
从类 java.util.spi.LocaleServiceProvider 继承的方法
getAvailableLocales
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

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 - 如果 languageCodelocale 为 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 - 如果 countryCodelocale 为 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 - 如果 variantlocale 为 null
IllegalArgumentException - 如果 locale 不是从 getAvailableLocales() 返回的语言环境之一。
另请参见:
Locale.getDisplayVariant(java.util.Locale)