java.util.spi
public abstract class LocaleNameProvider extends LocaleServiceProvider
LocaleNameProvider
provides localized
versions of the names that represent a particular
locale. Note that a null
value may
be returned, which should be treated as a lack of
support for the specified Locale
.Modifier | Constructor and Description |
---|---|
protected |
LocaleNameProvider()
Constructs a new
LocaleNameProvider . |
Modifier and Type | Method and Description |
---|---|
abstract String |
getDisplayCountry(String countryCode,
Locale locale)
Returns the localized name for the specified ISO 3166
country in the supplied
Locale . |
abstract String |
getDisplayLanguage(String langCode,
Locale locale)
Returns the localized name for the specified ISO 639
language in the supplied
Locale . |
abstract String |
getDisplayVariant(String variant,
Locale locale)
Returns the localized name for the specified variant
in the supplied
Locale . |
getAvailableLocales
protected LocaleNameProvider()
LocaleNameProvider
.
Provided for implicit invocation by subclasses.public abstract String getDisplayCountry(String countryCode, Locale locale)
Locale
.
For example, if the country code is "DE"
,
this method will return "Germany"
for
Locale.ENGLISH
but "Deutschland"
for Locale.GERMANY
. If the name of the country
in the given locale is not supported, null
is returned.countryCode
- the ISO 3166 country code, consisting
of two uppercase letters from 'A' to 'Z'locale
- the locale to express the country in.null
if one is
not available.NullPointerException
- if the locale is null.IllegalArgumentException
- if the country code is
not in the correct format
or the locale is not one
returned by
LocaleServiceProvider.getAvailableLocales()
Locale.getDisplayCountry(java.util.Locale)
public abstract String getDisplayLanguage(String langCode, Locale locale)
Locale
.
For example, if the language code is "de"
,
this method will return "German"
for
Locale.ENGLISH
but "Deutsch"
for Locale.GERMANY
. If the name of the language
in the given locale is not supported, null
is returned.langCode
- the ISO 639 language code, consisting
of two lowercase letters from 'a' to 'z'locale
- the locale to express the language in.null
if one is
not available.NullPointerException
- if the locale is null.IllegalArgumentException
- if the language code is
not in the correct format
or the locale is not one
returned by
LocaleServiceProvider.getAvailableLocales()
Locale.getDisplayLanguage(java.util.Locale)
public abstract String getDisplayVariant(String variant, Locale locale)
Locale
. If the name
of the variant in the given locale is not supported,
null
is returned.variant
- the variant.locale
- the locale to express the variant in.null
if one is
not available.NullPointerException
- if the locale is null.IllegalArgumentException
- if the locale is not one
returned by
LocaleServiceProvider.getAvailableLocales()
Locale.getDisplayVariant(java.util.Locale)