モジュール java.base
パッケージ java.util.spi

クラスLocaleNameProvider

java.lang.Object
java.util.spi.LocaleServiceProvider
java.util.spi.LocaleNameProvider
public abstract class LocaleNameProvider
extends LocaleServiceProvider
Localeクラスに対してローカライズされた通貨記号を提供するサービス・プロバイダの抽象クラスです。
導入されたバージョン:
1.6

  • コンストラクタの詳細

    • 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)

    • getDisplayUnicodeExtensionKey

      public String getDisplayUnicodeExtensionKey​(String key, Locale locale)
      指定された「Unicode拡張」キーのローカライズされた名前と、ユーザーへの表示に適した指定されたロケールを返します。 返される名前がlocaleに従ってローカライズできない場合、このメソッドはnullを返します。
      実装要件:
      デフォルト実装はnullを返します。
      パラメータ:
      key - Unicode拡張キー.nullではありません。
      locale - 目的のロケールで、nullではありません。
      戻り値:
      指定されたロケールの指定されたキー文字列の名前。使用できない場合はnull。
      例外:
      NullPointerException - keyまたはlocaleがnullの場合
      IllegalArgumentException - localeがgetAvailableLocales()から返されたロケールのいずれでもない場合。
      導入されたバージョン:
      10

    • getDisplayUnicodeExtensionType

      public String getDisplayUnicodeExtensionType​(String type, String key, Locale locale)
      指定された「Unicode拡張」型のローカライズされた名前と、ユーザーへの表示に適した指定されたロケールを返します。 返される名前がlocaleに従ってローカライズできない場合、このメソッドはnullを返します。
      実装要件:
      デフォルト実装はnullを返します。
      パラメータ:
      type - Unicode拡張の型で、nullではありません。
      key - このtypeのUnicode拡張キー.nullではありません。
      locale - 目的のロケールで、nullではありません。
      戻り値:
      指定されたロケールの指定された型文字列の名前。使用できない場合はnull。
      例外:
      NullPointerException - key、typeまたはlocaleがnullの場合
      IllegalArgumentException - localeがgetAvailableLocales()から返されたロケールのいずれでもない場合。
      導入されたバージョン:
      10