- 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)
返回给定 IETF BCP47区域代码(ISO 3166国家代码或UN M.49区域代码)的本地化名称以及适合显示给用户的给定区域设置。abstract String
getDisplayLanguage(String languageCode, Locale locale)
返回给定 IETF BCP47语言代码的本地化名称以及适合显示给用户的给定语言环境。String
getDisplayScript(String scriptCode, Locale locale)
返回给定 IETF BCP47脚本代码的本地化名称以及适合显示给用户的给定语言环境。String
getDisplayUnicodeExtensionKey(String key, Locale locale)
返回给定 Unicode extension键的本地化名称,以及适合显示给用户的给定语言环境。String
getDisplayUnicodeExtensionType(String type, String key, Locale locale)
返回给定 Unicode extension类型的本地化名称,以及适合显示给用户的给定语言环境。abstract String
getDisplayVariant(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
-
-