|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.spi.LocaleServiceProvider
java.util.spi.LocaleNameProvider
public abstract class LocaleNameProvider
A 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
.
Constructor Summary | |
---|---|
protected |
LocaleNameProvider()
Constructs a new LocaleNameProvider . |
Method Summary | |
---|---|
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 . |
Methods inherited from class java.util.spi.LocaleServiceProvider |
---|
getAvailableLocales |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected LocaleNameProvider()
LocaleNameProvider
.
Provided for implicit invocation by subclasses.
Method Detail |
---|
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)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |