java.util.spi

クラス LocaleNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.LocaleNameProvider

public abstract class LocaleNameProvider
extends LocaleServiceProvider

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

導入されたバージョン:

1.6

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	LocaleNameProvider() 唯一のコンストラクタです。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract String	getDisplayCountry(String countryCode, Locale locale) 指定された IETF BCP47 地域コード (ISO 3166 国コード、UN M.49 地域コードのいずれか) と指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。
abstract String	getDisplayLanguage(String languageCode, Locale locale) 指定された IETF BCP47 言語コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。
String	getDisplayScript(String scriptCode, Locale locale) 指定された IETF BCP47 書体コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。
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)

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

パラメータ:

languageCode -「a」(U+0061) から「z」(U+007A) までの 2 文字から 8 文字の小文字の形式の言語コード文字列

locale - 目的のロケール

戻り値:

指定されたロケールに対する指定された言語コードの名前。名前が使用可能でない場合は null。

例外:

NullPointerException - languageCode または locale が null である場合

IllegalArgumentException - languageCode が 2 文字または 3 文字の小文字の形式でないか、locale が getAvailableLocales() から返されたロケールのいずれでもない場合。

関連項目:

Locale.getDisplayLanguage(java.util.Locale)

getDisplayScript

public String getDisplayScript(String scriptCode,
                      Locale locale)

指定された IETF BCP47 書体コードと指定されたロケールに対する、ユーザーへの表示に適したローカライズ済みの名前を返します。たとえば、scriptCode が「Latn」で locale が en_US の場合、getDisplayScript() は「Latin」を返します。scriptCode が「Cyrl」で locale が fr_FR の場合、getDisplayScript() は「cyrillique」を返します。返される名前が locale に従ってローカライズできない場合 (たとえば、キリル文字に対する日本語名をプロバイダが持たない場合)、このメソッドは null を返します。デフォルト実装は null を返します。

パラメータ:

scriptCode - タイトルケース文字 (先頭の文字が「A」(U+0041) から「Z」(U+005A) までの大文字で、後に「a」(U+0061) から「z」(U+007A) までの 3 文字の小文字が続く) の形式での 4 文字のスクリプトコード文字列。

locale - 目的のロケール

戻り値:

指定されたロケールに対する指定されたスクリプトコードの名前。名前が使用可能でない場合は null。

例外:

NullPointerException - scriptCode または locale が null である場合

IllegalArgumentException - scriptCode が 4 文字のタイトルケース文字の形式でないか、locale が getAvailableLocales() から返されたロケールのいずれでもない場合。

導入されたバージョン:

1.7

関連項目:

Locale.getDisplayScript(java.util.Locale)

getDisplayCountry

public abstract String getDisplayCountry(String countryCode,
                       Locale locale)

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

パラメータ:

countryCode - '「A」(U+0041) から「Z」(U+005A) までの 2 文字の大文字の形式の国 (地域) コード文字列か、または「0」(U+0030) から「9」(U+0039) までの 3 桁の数字の形式の UN M.49 地域コード。

locale - 目的のロケール

戻り値:

指定されたロケールに対する指定された国コードの名前。名前が使用可能でない場合は null。

例外:

NullPointerException - countryCode または locale が null である場合

IllegalArgumentException - countryCode が 2 文字の大文字または 3 桁の数字の形式でないか、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)