模块 java.base
包 java.util.spi

类 LocaleNameProvider

java.lang.Object
java.util.spi.LocaleServiceProvider
java.util.spi.LocaleNameProvider
public abstract class LocaleNameProvider extends LocaleServiceProvider
为 Locale 类提供本地化名称的服务提供商的抽象类。
自从：
1.6

  • 构造方法详细信息

    • LocaleNameProvider

      protected LocaleNameProvider()
      唯一的构造方法。 （对于子类构造方法的调用，通常是隐式的。）

  • 方法详情

    • getDisplayLanguage

      public abstract String  getDisplayLanguage(String  languageCode, Locale  locale)
      返回给定 IETF BCP47 语言代码和适合向用户显示的给定locale的本地化名称。例如，如果 languageCode 是“fr”，locale 是 en_US，getDisplayLanguage() 将返回“French”；如果 languageCode 为“en”且 locale 为 fr_FR，则 getDisplayLanguage() 将返回“anglais”。如果返回的名称无法根据 locale 进行本地化（例如，提供者没有克罗地亚语的日语名称），则此方法返回 null。
      参数：
      languageCode - 'a' (U+0061) 和 'z' (U+007A) 之间的二到八个小写字母形式的语言代码字符串
      locale - 所需的locale
      返回：
      指定locale的给定语言代码的名称，如果不可用，则为 null。
      抛出：
      NullPointerException - 如果 languageCode 或 locale 为空
      IllegalArgumentException - 如果 languageCode 不是两个或三个小写字母的形式，或者 locale 不是从 getAvailableLocales() 返回的locale之一。
      参见：

    • getDisplayScript

      public String  getDisplayScript(String  scriptCode, Locale  locale)
      返回给定 IETF BCP47 脚本代码和适合向用户显示的给定locale的本地化名称。例如，如果 scriptCode 是“Latn”并且 locale 是 en_US，getDisplayScript() 将返回“Latin”；如果 scriptCode 是“Cyrl”且 locale 是 fr_FR，则 getDisplayScript() 将返回“cyrlique”。如果返回的名称无法根据 locale 进行本地化（例如，提供者没有西里尔文的日文名称），则此方法返回 null。默认实现返回 null。
      参数：
      scriptCode - 标题字母形式的四字母脚本代码字符串（第一个字母是'A'（U+0041）和'Z'（U+005A）之间的大写字符，后跟三个小写字符在“a”（U+0061）和“z”（U+007A）之间）。
      locale - 所需的locale
      返回：
      指定区域设置的给定脚本代码的名称，如果不可用则为 null。
      抛出：
      NullPointerException - 如果 scriptCode 或 locale 为空
      IllegalArgumentException - 如果 scriptCode 不是四个首字母大写字母的形式，或者 locale 不是从 getAvailableLocales() 返回的locale之一。
      自从：
      1.7
      参见：

    • getDisplayCountry

      public abstract String  getDisplayCountry(String  countryCode, Locale  locale)
      返回给定 IETF BCP47 区域代码（ISO 3166 国家代码或 UN M.49 区域代码）和适合向用户显示的给定locale的本地化名称。例如，如果 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 - 所需的locale
      返回：
      指定区域设置的给定国家/地区代码的名称，如果不可用，则为 null。
      抛出：
      NullPointerException - 如果 countryCode 或 locale 为空
      IllegalArgumentException - 如果 countryCode 不是两个大写字母或三个数字字母的形式，或者 locale 不是从 getAvailableLocales() 返回的locale之一。
      参见：

    • getDisplayVariant

      public abstract String  getDisplayVariant(String  variant, Locale  locale)
      返回给定变体代码的本地化名称和适合向用户显示的给定locale。如果返回的名称无法根据 locale 进行本地化，则此方法返回 null。
      参数：
      variant - 变体字符串
      locale - 所需的locale
      返回：
      指定locale的给定变体字符串的名称，如果不可用则为 null。
      抛出：
      NullPointerException - 如果 variant 或 locale 为空
      IllegalArgumentException - 如果 locale 不是从 getAvailableLocales() 返回的locale之一。
      参见：

    • getDisplayUnicodeExtensionKey

      public String  getDisplayUnicodeExtensionKey(String  key, Locale  locale)
      返回给定 Unicode 扩展 键的本地化名称，以及适合向用户显示的给定locale。如果返回的名称无法根据 locale 进行本地化，则此方法返回 null。
      实现要求：
      默认实现返回 null 。
      参数：
      key - Unicode 扩展密钥，不为空。
      locale - 所需的locale，不为空。
      返回：
      指定区域设置的给定键字符串的名称，如果不可用则为 null。
      抛出：
      NullPointerException - 如果 key 或 locale 为空
      IllegalArgumentException - 如果 locale 不是从 getAvailableLocales() 返回的locale之一。
      自从：
      10

    • getDisplayUnicodeExtensionType

      public String  getDisplayUnicodeExtensionType(String  type, String  key, Locale  locale)
      返回给定 Unicode 扩展 类型的本地化名称，以及适合向用户显示的给定locale。如果返回的名称无法根据 locale 进行本地化，则此方法返回 null。
      实现要求：
      默认实现返回 null 。
      参数：
      type - Unicode 扩展类型，不为空。
      key - 此 type 的 Unicode 扩展密钥，不为空。
      locale - 所需的locale，不为空。
      返回：
      指定locale的给定类型字符串的名称，如果不可用则返回 null。
      抛出：
      NullPointerException - 如果 key 、 type 或 locale 为空
      IllegalArgumentException - 如果 locale 不是从 getAvailableLocales() 返回的locale之一。
      自从：
      10