Класс LocaleNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider extends LocaleServiceProvider

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

С версии:: 1.6

Краткое описание конструкторов

LocaleNameProvider()

Модификатор	Конструктор	Описание
`protected`	Единственный конструктор.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract String`	`getDisplayCountry(String countryCode, Locale locale)`	Возвращает локализованное название заданного регионального кода IETF BCP47 (кода страны ISO 3166 или кода территории ООН 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 и заданной локали, подходящее для отображения пользователю.
`String`	`getDisplayUnicodeExtensionType(String type, String key, Locale locale)`	Возвращает локализованное название заданного типа расширения Unicode и заданной локали, подходящее для отображения пользователю.
`abstract String`	`getDisplayVariant(String variant, Locale locale)`	Возвращает локализованное название заданного кода варианта и заданной локали, подходящее для отображения пользователю.

Методы, объявленные в классе LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Модификатор и тип	Метод	Описание
`abstract Locale[]`	`getAvailableLocales()`	Возвращает массив всех локалей, для которых этот поставщик службы локалей может предоставлять локализованные объекты или названия.
`boolean`	`isSupportedLocale(Locale locale)`	Возвращает `true`, если этот поставщик службы локалей поддерживает заданную `locale`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает выполнение текущего потока до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного времени.

Подробное описание конструкторов

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 равно null

IllegalArgumentException — если languageCode не состоит из двух или трех строчных букв либо locale не входит в число локалей, возвращаемых методом getAvailableLocales().

См. также:

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 равно null

IllegalArgumentException — если scriptCode не состоит из четырех букв в формате заглавной буквы либо locale не входит в число локалей, возвращаемых методом getAvailableLocales().

С версии:

1.7

См. также:

getDisplayCountry

public abstract String getDisplayCountry(String countryCode, Locale locale)

Возвращает локализованное название заданного регионального кода IETF BCP47 (кода страны ISO 3166 или кода территории ООН 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) или код территории ООН M.49 в формате трех цифр от '0' (U+0030) до '9' (U+0039).

locale — требуемая локаль

Возвращает:

название заданного кода страны для указанной локали или null, если оно недоступно.

Вызывает исключение:

NullPointerException — если countryCode или locale равно null

IllegalArgumentException — если countryCode не состоит из двух заглавных букв или трех цифр либо locale не входит в число локалей, возвращаемых методом getAvailableLocales().

См. также:

getDisplayVariant

public abstract String getDisplayVariant(String variant, Locale locale)

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

Параметры:

variant — строка варианта

locale — требуемая локаль

Возвращает:

название заданной строки варианта для указанной локали или null, если оно недоступно.

Вызывает исключение:

NullPointerException — если variant или locale равно null

IllegalArgumentException — если locale не входит в число локалей, возвращаемых методом getAvailableLocales().

См. также:

getDisplayUnicodeExtensionKey

public String getDisplayUnicodeExtensionKey(String key, Locale locale)

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

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

getDisplayUnicodeExtensionType

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

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

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

© 1993, 2025, 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.