- java.lang.Object
-
- java.util.spi.LocaleServiceProvider
-
- java.util.spi.LocaleNameProvider
-
public abstract class LocaleNameProvider extends LocaleServiceProvider
服务提供者的抽象类,为Locale类提供本地化名称。- 从以下版本开始:
- 1.6
-
-
构造方法摘要
构造方法 变量 构造器 描述 protectedLocaleNameProvider()唯一的构造函数。
-
方法摘要
所有方法 实例方法 抽象方法 具体的方法 变量和类型 方法 描述 abstract StringgetDisplayCountry(String countryCode, Locale locale)返回给定 IETF BCP47区域代码(ISO 3166国家代码或UN M.49区域代码)的本地化名称以及适合显示给用户的给定区域设置。abstract StringgetDisplayLanguage(String languageCode, Locale locale)返回给定 IETF BCP47语言代码的本地化名称以及适合显示给用户的给定语言环境。StringgetDisplayScript(String scriptCode, Locale locale)返回给定 IETF BCP47脚本代码的本地化名称以及适合显示给用户的给定语言环境。StringgetDisplayUnicodeExtensionKey(String key, Locale locale)返回给定 Unicode extension键的本地化名称,以及适合显示给用户的给定语言环境。StringgetDisplayUnicodeExtensionType(String type, String key, Locale locale)返回给定 Unicode extension类型的本地化名称,以及适合显示给用户的给定语言环境。abstract StringgetDisplayVariant(String variant, Locale locale)返回给定变体代码的本地化名称以及适合显示给用户的给定语言环境。-
声明方法的类 java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
-
-
-
-
方法详细信息
-
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进行本地化(例如,提供程序没有克罗地亚语的日语名称),则此方法返回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进行本地化(例如,提供程序没有Cyrillic的日语名称),则此方法返回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进行本地化(例如,提供程序没有克罗地亚的日语名称),则此方法返回null。- 参数
-
countryCode- 国家(地区)代码字符串,形式为“A”(U + 0041)和“Z”(U + 005A)之间的两个大写字母或三位数形式的UN 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进行本地化,则此方法返回null。- 参数
-
variant- 变体字符串 -
locale- 所需的区域设置 - 结果
- 指定语言环境的给定变量字符串的名称,如果不可用,则为null。
- 异常
-
NullPointerException- 如果variant或locale为空 -
IllegalArgumentException- 如果locale不是从getAvailableLocales()返回的语言环境 之一 。 - 另请参见:
-
Locale.getDisplayVariant(java.util.Locale)
-
getDisplayUnicodeExtensionKey
public String getDisplayUnicodeExtensionKey(String key, Locale locale)
返回给定Unicode extension键的本地化名称,以及适合显示给用户的给定语言环境。 如果返回的名称无法根据locale进行本地化,则此方法返回null。- 实现要求:
-
默认实现返回
null。 - 参数
-
key- Unicode扩展密钥,不为null。 -
locale- 所需的区域设置,不为null。 - 结果
- 指定语言环境的给定键字符串的名称,如果不可用,则为null。
- 异常
-
NullPointerException- 如果key或locale为空 -
IllegalArgumentException- 如果locale不是从getAvailableLocales()返回的语言环境 之一 。 - 从以下版本开始:
- 10
-
getDisplayUnicodeExtensionType
public String getDisplayUnicodeExtensionType(String type, String key, Locale locale)
返回给定Unicode extension类型的本地化名称,以及适合显示给用户的给定语言环境。 如果返回的名称无法根据locale进行本地化,则此方法返回null。- 实现要求:
-
默认实现返回
null。 - 参数
-
type- Unicode扩展类型,不为null。 -
key- 此type的Unicode扩展密钥,不为null。 -
locale- 所需的区域设置,不为空。 - 结果
- 指定语言环境的给定类型字符串的名称,如果不可用,则为null。
- 异常
-
NullPointerException-如果key,type或locale为null -
IllegalArgumentException- 如果locale不是从getAvailableLocales()返回的语言环境 之一 。 - 从以下版本开始:
- 10
-
-