Класс 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

Методы, объявленные в классе 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() вернет "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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/spi/LocaleNameProvider.html