compact1, compact2, compact3

java.util.spi

Class LocaleNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
extends LocaleServiceProvider

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

从以下版本开始：

1.6

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	LocaleNameProvider() 唯一的构造函数。

方法摘要

Modifier and Type	Method and Description
abstract String	getDisplayCountry(String countryCode, Locale locale) 返回给定的 IETF BCP47区域代码（ISO 3166国家代码或UN M.49区域代码）的本地化名称以及适合向用户显示的给定区域。
abstract String	getDisplayLanguage(String languageCode, Locale locale) 返回给定的 IETF BCP47语言代码的本地化名称以及适合向用户显示的给定语言环境。
String	getDisplayScript(String scriptCode, Locale locale) 返回给定的 IETF BCP47脚本代码和适用于向用户显示的给定语言环境的本地化名称。
abstract String	getDisplayVariant(String variant, Locale locale) 返回适用于向用户显示的给定变体代码和给定语言环境的本地化名称。

Methods inherited from class java.util.spi.LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Methods inherited from class 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)

返回给定的IETF BCP47语言代码和适用于向用户显示的给定语言环境的本地化名称。 例如，如果languageCode是“fr”，而locale是en_US，getDisplayLanguage（）将返回“French”; 如果languageCode是“en”，而locale是fr_FR，getDisplayLanguage（）将返回“anglais”。 如果返回的名称不能根据locale进行locale （例如，提供者没有克罗地亚语的日语名称），则此方法返回null。

参数

languageCode - 'a'（U + 0061）和'z'（U + 007A）之间的二至八个小写字母形式的语言代码字符串

locale - 所需的语言环境

结果

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

异常

NullPointerException - 如果 languageCode或 locale为空

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

另请参见：

Locale.getDisplayLanguage(java.util.Locale)

getDisplayScript

public String getDisplayScript(String scriptCode,
                               Locale locale)

返回给定的IETF BCP47脚本代码和适用于向用户显示的给定语言环境的本地化名称。 例如，如果scriptCode是“Latn”，而locale是en_US，getDisplayScript（）将返回“Latin”; 如果scriptCode是“Cyrl”，而locale是fr_FR，getDisplayScript（）将返回“cyrillique”。 如果返回的名称不能根据locale进行locale （例如，提供程序没有西里尔文的日文名称），则此方法返回null。 默认实现返回null。

参数

scriptCode - 标题字母形式的四字母脚本代码字符串（第一个字母是'A'（U + 0041）和'Z'（U + 005A）之间的大写字符，后跟三个小写字母在'a'（U + 0061）和'z'（U + 007A）之间）。

locale - 所需的语言环境

结果

指定语言环境的给定脚本代码的名称，如果不可用，则为null。

异常

NullPointerException - 如果 scriptCode或 locale为空

IllegalArgumentException - 如果 scriptCode不是以四个标题字母的形式，或 locale不是从 getAvailableLocales()返回的语言环境之一。

从以下版本开始：

1.7

另请参见：

Locale.getDisplayScript(java.util.Locale)

getDisplayCountry

public abstract String getDisplayCountry(String countryCode,
                                         Locale locale)

返回给定的IETF BCP47区域代码（ISO 3166国家代码或UN M.49区域代码）的本地化名称以及适合向用户显示的给定区域设置。 例如，如果countryCode是“FR”，而locale是en_US，getDisplayCountry（）将返回“France”; 如果countryCode是“US”，而locale是fr_FR，getDisplayCountry（）将返回“Etats-Unis”。 如果返回的名称不能根据locale进行locale （例如，提供者没有克罗地亚的日语名称），则此方法返回null。

参数

countryCode - 国家（地区）代码字符串，以“A”（U + 0041）和“Z”（U + 005A）之间的两个大写字母或联合国M.49区号以三位数字形式出现'0'（U + 0030）和'9'之间的字母（U + 0039）。

locale - 所需的语言环境

结果

指定区域设置的给定国家代码的名称，如果不可用，则为null。

异常

NullPointerException - 如果 countryCode或 locale为空

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

另请参见：

Locale.getDisplayCountry(java.util.Locale)

getDisplayVariant

public abstract String getDisplayVariant(String variant,
                                         Locale locale)

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

参数

variant - 变体字符串

locale - 所需的语言环境

结果

指定区域设置的给定变体字符串的名称，如果不可用，则为null。

异常

NullPointerException - 如果 variant或 locale为空

IllegalArgumentException - 如果 locale不是从 getAvailableLocales()返回的区域设置之一。

另请参见：

Locale.getDisplayVariant(java.util.Locale)