Класс 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 или код зоны ООН М.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().

См. также:

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 - четырёхбуквенный код скрипта в формате заглавных букв (первая буква — заглавная от '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 или код области ООН М.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().

См. также:

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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/spi/LocaleNameProvider.html