java.util.spi

クラス CurrencyNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.CurrencyNameProvider

public abstract class CurrencyNameProvider
extends LocaleServiceProvider

Currency クラスに対してローカライズされた通貨記号と表示名を提供するサービスプロバイダの abstract クラスです。LocaleServiceProvider の仕様に記述された動作を決定する際、通貨記号は名前とみなされることに注意してください。

導入されたバージョン:

1.6

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	getDisplayName(String currencyCode, Locale locale) ユーザーへの表示に適した通貨の名前を返します。
abstract String	getSymbol(String currencyCode, Locale locale) 指定されたロケールについて、指定された通貨コードの記号を取得します。

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

getAvailableLocales

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

CurrencyNameProvider

protected CurrencyNameProvider()

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

メソッドの詳細

getSymbol

public abstract String getSymbol(String currencyCode,
               Locale locale)

指定されたロケールについて、指定された通貨コードの記号を取得します。たとえば、「USD」(US ドル) については、指定されたロケールが US の場合は、記号は「$」になります。ほかのロケールの場合は、記号は「US$」になります。記号を決定できない場合は null が返されるべきです。

パラメータ:

currencyCode - ISO 4217 通貨コード。「A」(U+0041) から「Z」(U+005A) までの大文字 3 つから構成される

locale - 目的のロケール

戻り値:

指定されたロケールの指定された通貨コードの記号。そのロケールの記号が使用可能でない場合は null

例外:

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

IllegalArgumentException - currencyCode が 3 つの大文字の形式になっていないか、locale が getAvailableLocales() から返されたロケールのいずれでもない場合。

関連項目:

Currency.getSymbol(java.util.Locale)

getDisplayName

public String getDisplayName(String currencyCode,
                    Locale locale)

ユーザーへの表示に適した通貨の名前を返します。デフォルト実装は null を返します。

パラメータ:

currencyCode - ISO 4217 通貨コード。「A」(U+0041) から「Z」(U+005A) までの大文字 3 つから構成される

locale - 目的のロケール

戻り値:

ユーザーに表示するために適切な通貨の名前か、またはロケールで名前が使用できない場合は null

例外:

IllegalArgumentException - currencyCode が 3 つの大文字の形式になっていないか、locale が getAvailableLocales() から返されたロケールのいずれでもない場合。

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

導入されたバージョン:

1.7