Класс LocaleNameProvider

java.lang.Object
- java.util.spi.LocaleServiceProvider
- - java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
extends LocaleServiceProvider

Абстрактный класс для поставщиков сервисов, предоставляющих локализованные имена для класса Locale.

Since:: 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

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструкторы

LocaleNameProvider

protected LocaleNameProvider()

Единственный конструктор. (Для вызова подклассами, как правило, неявный).

Методы

getDisplayLanguage

public abstract String getDisplayLanguage(String languageCode,
                                          Locale locale)

Возвращает локализованное имя для данного кода языка IETF BCP47 и данного региона, подходящее для отображения пользователю. Например, если languageCode — "fr", а locale — en_US, getDisplayLanguage() вернёт "Французский"; если languageCode — "en", а locale — fr_FR, getDisplayLanguage() вернёт "английский". Если возвращаемое имя не может быть локализовано в соответствии с locale, (например, у поставщика нет японского названия для хорватского языка), этот метод возвращает null.

Параметры:: languageCode - строка кода языка в виде двух-восьми строчных букв от 'a' (U+0061) до 'z' (U+007A); locale - желаемый регион
Возвращает:: название данного кода языка для указанного региона, или null, если оно недоступно.
Исключение:: NullPointerException - если languageCode или locale равно null; 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() вернёт "Латинский"; если scriptCode — "Cyrl", а locale — fr_FR, getDisplayScript() вернёт "кириллический". Если возвращаемое имя не может быть локализовано в соответствии с locale, (например, у поставщика нет японского названия для кириллицы), этот метод возвращает null. По умолчанию возвращает null.

Параметры:: scriptCode - строка кода письма в 4-х заглавных буквах (первая буква — заглавная, от 'A' (U+0041) до 'Z' (U+005A), следующие три — строчные, от 'a' (U+0061) до 'z' (U+007A)).; locale - желаемый регион
Возвращает:: название данного кода письма для указанного региона, или null, если оно недоступно.
Исключение:: NullPointerException - если scriptCode или locale равно null; IllegalArgumentException - если scriptCode не имеет формы четырёх заглавных букв, или locale не является одним из регионов, возвращенных из getAvailableLocales().
С тех пор как:: 1.7
См. также:: Locale.getDisplayScript(java.util.Locale)

getDisplayCountry

public abstract String getDisplayCountry(String countryCode,
                                         Locale locale)

Возвращает локализованное имя для данного кода региона IETF BCP47 (код страны ISO 3166 или код области ООН М.49) и данного региона, подходящее для отображения пользователю. Например, если countryCode — "FR", а locale — en_US, getDisplayCountry() вернёт "Франция"; если countryCode — "US", а locale — fr_FR, getDisplayCountry() вернёт "Соединённые Штаты". Если возвращаемое имя не может быть локализовано в соответствии с locale, (например, у поставщика нет японского названия для Хорватии), этот метод возвращает null.

Параметры:: countryCode - строка кода страны (региона) в виде двух заглавных букв от 'A' (U+0041) до 'Z' (U+005A) или кода области ООН М.49 в виде трёх цифр от '0' (U+0030) до '9' (U+0039).; locale - желаемый регион
Возвращает:: название данного кода страны для указанного региона, или null, если оно недоступно.
Исключение:: NullPointerException - если countryCode или locale равно null; 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 равно null; IllegalArgumentException - если locale не является одним из регионов, возвращенных из getAvailableLocales().
См. также:: Locale.getDisplayVariant(java.util.Locale)

getDisplayUnicodeExtensionKey

public String getDisplayUnicodeExtensionKey(String key,
                                            Locale locale)

Возвращает локализованное имя для данного ключа расширения Юникода и данного региона, подходящее для отображения пользователю. Если возвращаемое имя не может быть локализовано в соответствии с locale, этот метод возвращает null.

Требования к реализации:: по умолчанию возвращает null.
Параметры:: key - ключ расширения Юникода, не null.; locale - желаемый регион, не null.
Возвращает:: название данного ключа для указанного региона, или null, если оно недоступно.
Исключение:: NullPointerException - если key или locale равно null; IllegalArgumentException - если locale не является одним из регионов, возвращенных из getAvailableLocales().
С тех пор как:: 10

getDisplayUnicodeExtensionType

public String getDisplayUnicodeExtensionType(String type,
                                             String key,
                                             Locale locale)

Возвращает локализованное имя для данного типа расширения Юникода и данного региона, подходящее для отображения пользователю. Если возвращаемое имя не может быть локализовано в соответствии с locale, этот метод возвращает null.

Требования к реализации:: по умолчанию возвращает null.
Параметры:: type - тип расширения Юникода, не null.; key - ключ расширения Юникода для этого type, не null.; locale - желаемый регион, не null.
Возвращает:: название данного типа для указанного региона, или null, если оно недоступно.
Исключение:: NullPointerException - если key, type или locale равно null; IllegalArgumentException - если locale не является одним из регионов, возвращенных из getAvailableLocales().
С тех пор как:: 10

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/spi/LocaleNameProvider.html