LocaleNameProvider (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.util.spi
クラス LocaleNameProvider

java.lang.Object
  java.util.spi.LocaleServiceProvider
      java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
extends LocaleServiceProvider
extends LocaleServiceProvider

ローカライズされた名前を Locale クラスに対して提供するサービスプロバイダの abstract クラスです。

導入されたバージョン:: 1.6

コンストラクタの概要
`protected`	`LocaleNameProvider()` 唯一のコンストラクタです。

メソッドの概要
`abstract String`	`getDisplayCountry(String countryCode, Locale locale)` 指定された ISO 3166 国コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。
`abstract String`	`getDisplayLanguage(String languageCode, Locale locale)` 指定された ISO 639 言語コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。
`abstract String`	`getDisplayVariant(String variant, Locale locale)` 指定されたバリアントコードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。

クラス java.util.spi.LocaleServiceProvider から継承されたメソッド
`getAvailableLocales`

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

LocaleNameProvider

protected LocaleNameProvider()

唯一のコンストラクタです。サブクラスのコンストラクタによる呼び出し用で、通常は暗黙的に呼び出されます。

メソッドの詳細

getDisplayLanguage

public abstract String getDisplayLanguage(String languageCode,
                                          Locale locale)

指定された ISO 639 言語コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。たとえば、languageCode が「fr」で locale が en_US の場合、getDisplayLanguage() は「French」を返します。languageCode が「en」で locale が fr_FR の場合、getDisplayLanguage() は「anglais」を返します。返される名前が locale に従ってローカライズできない場合 (たとえば、クロアチア語に対する日本語名をプロバイダが持たない場合)、このメソッドは null を返します。

パラメータ:: languageCode - ISO 639 言語コード文字列。形式は、「a」 (U+0061) から「z」 (U+007A) までの小文字 2 つになる; locale - 目的のロケール
戻り値:: 指定されたロケールに対する指定された言語コードの名前。名前が使用可能でない場合は null
例外:: NullPointerException - languageCode または locale が null の場合; IllegalArgumentException - languageCode が 2 つの小文字の形式になっていないか、locale が getAvailableLocales() から返されたロケールのいずれでもない場合
関連項目:: Locale.getDisplayLanguage(java.util.Locale)

getDisplayCountry

public abstract String getDisplayCountry(String countryCode,
                                         Locale locale)

指定された ISO 3166 国コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。たとえば、countryCode が「FR」で locale が en_US の場合、getDisplayCountry() は「France」を返します。countryCode が「US」で locale が fr_FR の場合、getDisplayCountry() は「Etats-Unis」を返します。返される名前が locale に従ってローカライズできない場合 (たとえば、クロアチアに対する日本語名をプロバイダが持たない場合)、このメソッドは null を返します。

パラメータ:: countryCode - ISO 3166 国コード文字列。形式は、「A」 (U+0041) から「Z」 (U+005A) までの大文字 2 つになる; locale - 目的のロケール
戻り値:: 指定されたロケールに対する指定された国コードの名前。名前が使用可能でない場合は null
例外:: NullPointerException - countryCode または locale が null の場合; IllegalArgumentException - countryCode が 2 つの大文字の形式になっていないか、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)