Класс LocaleNameProvider

public abstract class LocaleNameProvider
extends LocaleServiceProvider

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

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 - строка кода сценария из четырёх символов в формате заглавных букв (первая буква — заглавная буква между 'A' (U+0041) и 'Z' (U+005A), за которой следуют три строчных буквы между 'a' (U+0061) и 'z' (U+007A)).

locale - желаемый локали

Возвращает:

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

Исключения:

NullPointerException - если scriptCode или locale равно null

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

Since:

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)