LocaleNameProvider (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

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

构造方法摘要
`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)