LocaleNameProvider (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 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 類別提供本地化名稱的服務提供者的一個抽象類別。

從以下版本開始：: 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 對返回的名稱進行本地化（比方說提供者沒有 Croatian 的日本名稱），則此方法返回 null。

參數：: languageCode - ISO 639 語言程式碼字元串，用 'a' (U+0061) 和 'z' (U+007A) 之間的兩個小寫字母表示; locale - 所需的語言環境
返回：: 指定語言環境的給定語言程式碼的名稱；如果該名稱不可用，則返回 null。
拋出：: NullPointerException - 如果 languageCode 或 locale 為 null; IllegalArgumentException - 如果 languageCode 不是以兩個小寫字母的形式表示，或者 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 對返回的名稱進行本地化（比方說提供者沒有 Croatia 的日本名稱），則此方法返回 null。

參數：: countryCode - ISO 3166 國家程式碼字元串，用 'A' (U+0041) 和 'Z' (U+005A) 之間的兩個大寫字母表示; locale - 所需的語言環境
返回：: 指定語言環境的給定國家程式碼的名稱；如果該名稱不可用，則返回 null。
拋出：: NullPointerException - 如果 countryCode 或 locale 為 null; IllegalArgumentException - 如果 countryCode 不是以兩個大寫字母的形式表示，或者 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)