java.lang.Object | ||
↳ | java.util.spi.LocaleServiceProvider | |
↳ | java.util.spi.LocaleNameProvider |
An abstract class for service providers that
provide localized names for the
Locale
class.
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Sole constructor.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns a localized name for the given ISO 3166 country code and the
given locale that is appropriate for display to the user.
| |||||||||||
Returns a localized name for the given ISO 639 language code and the
given locale that is appropriate for display to the user.
| |||||||||||
Returns a localized name for the given variant code and the given locale that
is appropriate for display to the user.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.util.spi.LocaleServiceProvider
| |||||||||||
From class
java.lang.Object
|
Sole constructor. (For invocation by subclass constructors, typically implicit.)
Returns a localized name for the given ISO 3166 country code and the
given locale that is appropriate for display to the user.
For example, if countryCode
is "FR" and locale
is en_US, getDisplayCountry() will return "France"; if countryCode
is "US" and locale
is fr_FR, getDisplayCountry() will return "Etats-Unis".
If the name returned cannot be localized according to locale
,
(say, the provider does not have a Japanese name for Croatia),
this method returns null.
countryCode | the ISO 3166 country code string in the form of two upper-case letters between 'A' (U+0041) and 'Z' (U+005A) |
---|---|
locale | the desired locale |
NullPointerException | if countryCode or locale is null |
---|---|
IllegalArgumentException | if countryCode is not in the form of
two upper-case letters, or locale isn't
one of the locales returned from
getAvailableLocales() . |
Returns a localized name for the given ISO 639 language code and the
given locale that is appropriate for display to the user.
For example, if languageCode
is "fr" and locale
is en_US, getDisplayLanguage() will return "French"; if languageCode
is "en" and locale
is fr_FR, getDisplayLanguage() will return "anglais".
If the name returned cannot be localized according to locale
,
(say, the provider does not have a Japanese name for Croatian),
this method returns null.
languageCode | the ISO 639 language code string in the form of two lower-case letters between 'a' (U+0061) and 'z' (U+007A) |
---|---|
locale | the desired locale |
NullPointerException | if languageCode or locale is null |
---|---|
IllegalArgumentException | if languageCode is not in the form of
two lower-case letters, or locale isn't
one of the locales returned from
getAvailableLocales() . |
Returns a localized name for the given variant code and the given locale that
is appropriate for display to the user.
If the name returned cannot be localized according to locale
,
this method returns null.
variant | the variant string |
---|---|
locale | the desired locale |
NullPointerException | if variant or locale is null |
---|---|
IllegalArgumentException | if locale isn't
one of the locales returned from
getAvailableLocales() . |