模块  java.base
软件包  java.util.spi

Class LocaleNameProvider


  • public abstract class LocaleNameProvider
    extends LocaleServiceProvider
    服务提供者的抽象类,为Locale类提供本地化名称。
    从以下版本开始:
    1.6
    • 构造方法详细信息

      • 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进行本地化(例如,提供程序没有克罗地亚语的日语名称),则此方法返回null。
        参数
        languageCode - “a”(U + 0061)和“z”(U + 007A)之间的两到八个小写字母形式的语言代码字符串
        locale - 所需的区域设置
        结果
        指定语言环境的给定语言代码的名称,如果不可用,则返回null。
        异常
        NullPointerException - 如果 languageCodelocale为空
        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 - 如果 scriptCodelocale为空
        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 - 如果 countryCodelocale为空
        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为空
        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 - 如果 keylocale为空
        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 -如果 keytypelocale为null
        IllegalArgumentException - 如果 locale不是从 getAvailableLocales()返回的语言环境 之一
        从以下版本开始:
        10