LocaleNameProvider (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

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 类提供本地化名称的服务提供者的一个抽象类。

从以下版本开始：: 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)