|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.util.spi.LocaleServiceProvider java.util.spi.LocaleNameProvider
public abstract class LocaleNameProvider
An abstract class for service providers that
provide localized names for the
Locale
class.
Constructor Summary | |
---|---|
protected |
LocaleNameProvider()
Sole constructor. |
Method Summary | |
---|---|
abstract String |
getDisplayCountry(String countryCode,
Locale locale)
Returns a localized name for the given ISO 3166 country code and the given locale that is appropriate for display to the user. |
abstract String |
getDisplayLanguage(String languageCode,
Locale locale)
Returns a localized name for the given ISO 639 language code and the given locale that is appropriate for display to the user. |
abstract String |
getDisplayVariant(String variant,
Locale locale)
Returns a localized name for the given variant code and the given locale that is appropriate for display to the user. |
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()
Method Detail |
---|
public abstract String getDisplayLanguage(String languageCode, Locale locale)
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()
.Locale.getDisplayLanguage(java.util.Locale)
public abstract String getDisplayCountry(String countryCode, Locale locale)
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()
.Locale.getDisplayCountry(java.util.Locale)
public abstract String getDisplayVariant(String variant, Locale locale)
locale
,
this method returns null.
variant
- the variant stringlocale
- the desired locale
NullPointerException
- if variant
or locale
is null
IllegalArgumentException
- if locale
isn't
one of the locales returned from
getAvailableLocales()
.Locale.getDisplayVariant(java.util.Locale)
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.