Module  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 - 如果 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进行本地化（例如，提供程序没有西里尔文的日文名称），则此方法返回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（）将返回“法国”; 如果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)