compact1, compact2, compact3

java.util

Class Locale.Builder

java.lang.Object

java.util.Locale.Builder

Enclosing class:

Locale

public static final class Locale.Builder
extends Object

Builder用于配置值的制定者建立的实例 Locale。不像 Locale构造函数的 Builder检查一个值是否通过setter配置满足的 Locale类定义的语法要求。由 Builder创造 Locale对象是形成可以转化为良好的IETF BCP 47语言标签失去信息。

注：的Locale类不提供任何句法变异，而变异的BCP 47要求每一个子标记有5到8个字母数字或一个数字后面跟着3个字母。方法setVariant抛出IllformedLocaleException一变不满足这个约束。如果有必要支持这样的变体，使用区域设置构造函数。但是，请记住，一个Locale对象创建的这种方式可能会失去时变信息转化为BCP 47语言标记。

下面的示例演示如何创建一个与Builder Locale对象。

     Locale aLocale = new Builder().setLanguage("sr").setScript("Latn").setRegion("RS").build();
 

建设者可以重复使用；clear()重置为其默认值的所有领域。

从以下版本开始：

一点七

另请参见：

Locale.forLanguageTag(java.lang.String)

构造方法摘要

构造方法

Constructor and Description
Builder() 构造一个空的生成器。

方法摘要

Modifier and Type	Method and Description
Locale.Builder	addUnicodeLocaleAttribute(String attribute) 添加一个Unicode locale属性，如果不是已经存在，否则没有效果。
Locale	build() 返回的字段设置该生成器创建的 Locale实例。
Locale.Builder	clear() 重置为其初始状态的建设者，空。
Locale.Builder	clearExtensions() 重置为其初始扩展，空的状态。
Locale.Builder	removeUnicodeLocaleAttribute(String attribute) 删除一个Unicode区域的属性，如果存在，否则没有效果。
Locale.Builder	setExtension(char key, String value) 设置给定键的扩展。
Locale.Builder	setLanguage(String language) 设置语言。
Locale.Builder	setLanguageTag(String languageTag) 重置Builder与IETF语言标记提供BCP 47。
Locale.Builder	setLocale(Locale locale) 重置 Builder匹配提供 locale。
Locale.Builder	setRegion(String region) 设置区域。
Locale.Builder	setScript(String script) 设置脚本。
Locale.Builder	setUnicodeLocaleKeyword(String key, String type) 集Unicode现场关键字类型为给定的关键。
Locale.Builder	setVariant(String variant) 设置变体。

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

构造一个空的生成器。所有字段、扩展和私有信息的默认值是空字符串。

方法详细信息

setLocale

public Locale.Builder setLocale(Locale locale)

重置 Builder匹配提供 locale。现有的状态被丢弃。

对现场所有字段必须是格式良好的，看到Locale。

任何地方病形成原因等IllformedLocaleException被抛出，除了以下三例接受兼容性的原因：

• 现场（“ja”，“JP”，“JP”）被视为“ja-jp-u-ca-japanese”
• 现场（“日”、“日”、“日”）被视为“th-th-u-nu-thai”
• 现场（“没有”，“没有”，“纽约”）被视为“神经网络”

参数

locale -现场

结果

该生成器。

异常

如果有任何 IllformedLocaleException locale病形成的领域。

NullPointerException -如果 locale是空的。

setLanguageTag

public Locale.Builder setLanguageTag(String languageTag)

重置Builder与IETF语言标记提供BCP 47。抛弃现有的状态。空和空字符串事业的建设者被重置，像 clear()。祖父的标签（见 Locale.forLanguageTag(java.lang.String)）转换成标准的形式处理前。否则，语言标签必须形成（见 Locale）或抛出一个异常（不像 Locale.forLanguageTag，这只是丢弃病形成和下面的标签部分）。

参数

languageTag -语言标记

结果

该生成器。

异常

IllformedLocaleException -如果 languageTag病形成

另请参见：

Locale.forLanguageTag(String)

setLanguage

public Locale.Builder setLanguage(String language)

设置语言。如果 language是空字符串或空，在这 Builder语言被删除。否则，语言一定要 well-formed或抛出一个异常。

语言的典型值为一二或三个字母的语言代码中定义的iso639。

参数

language -语言

结果

该生成器。

异常

IllformedLocaleException -如果 language病形成

setScript

public Locale.Builder setScript(String script)

设置脚本。如果 script是null或空字符串，这 Builder脚本删除。否则，脚本必须 well-formed或抛出一个异常。

典型的脚本值是由国际标准化组织15924定义的一四个字母的脚本代码。

参数

script -脚本

结果

该生成器。

异常

IllformedLocaleException -如果 script病形成

setRegion

public Locale.Builder setRegion(String region)

设置区域。如果区域是null或空字符串，这 Builder区域被删除。否则，该地区必须 well-formed或抛出一个异常。

典型区域的值是一二字母的ISO 3166代码或一三位UN M.49地区代码。

由Builder创造Locale国家价值始终转换为大写。

参数

region -区域

结果

该生成器。

异常

IllformedLocaleException -如果 region病形成

setVariant

public Locale.Builder setVariant(String variant)

设置变体。如果变量是null或空字符串，这 Builder变异被删除。否则，它必须包含一个或多 well-formed子标签，或抛出一个异常。

注：这个方法检查，如果variant满足IETF BCP变异47个子标记的语法要求，正常的值为小写字母。然而，这Locale类不变型强加任何句法限制，并在Locale变量值是区分大小写的。要设置这样的一个变体，使用区域设置构造函数。

参数

variant -变异

结果

该生成器。

异常

IllformedLocaleException -如果 variant病形成

setExtension

public Locale.Builder setExtension(char key,
                                   String value)

设置给定键的扩展。如果值为空或空字符串，则将扩展扩展。否则，外延要 well-formed或抛出一个异常。

注：关键UNICODE_LOCALE_EXTENSION（U）是用于Unicode区域延伸。设置此密钥的值替换任何现有的Unicode重点区域/类型与那些在扩展中定义的对。

注：关键PRIVATE_USE_EXTENSION（x）是用于私人使用的代码。是形成这一关键，只需有一到八个字母数字字符子标签的价值，不是两到八，在一般情况下。

参数

key扩展-关键

value的推广价值

结果

该生成器。

异常

IllformedLocaleException -如果 key是非法的或 value病形成

另请参见：

setUnicodeLocaleKeyword(String, String)

setUnicodeLocaleKeyword

public Locale.Builder setUnicodeLocaleKeyword(String key,
                                              String type)

集Unicode现场关键字类型为给定的关键。如果类型为null，Unicode关键字被删除。否则，关键必须是非零和的键和类型必须 well-formed或抛出一个异常。

键和类型转换为小写。

注：通过setExtension(char, java.lang.String)替换所有Unicode现场关键词在扩展中定义的设置“U”延伸。

参数

key - Unicode的重点区域

type - Unicode区域类型

结果

该生成器。

异常

IllformedLocaleException -如果 key或 type病形成

NullPointerException -如果 key是空的

另请参见：

setExtension(char, String)

addUnicodeLocaleAttribute

public Locale.Builder addUnicodeLocaleAttribute(String attribute)

添加一个Unicode locale属性，如果不是已经存在，否则没有效果。该属性不能为空，必须 well-formed或抛出一个异常。

参数

attribute -属性

结果

该生成器。

异常

NullPointerException -如果 attribute是空的

IllformedLocaleException -如果 attribute病形成

另请参见：

setExtension(char, String)

removeUnicodeLocaleAttribute

public Locale.Builder removeUnicodeLocaleAttribute(String attribute)

删除一个Unicode区域的属性，如果存在，否则没有效果。该属性不能为空，必须 well-formed或抛出一个异常。

移除的属性比较是不区分大小写的。

参数

attribute -属性

结果

该生成器。

异常

NullPointerException -如果 attribute是空的

IllformedLocaleException -如果 attribute病形成

另请参见：

setExtension(char, String)

clear

public Locale.Builder clear()

重置为其初始状态的建设者，空。

结果

该生成器。

clearExtensions

public Locale.Builder clearExtensions()

重置为其初始扩展，空的状态。语言、脚本、区域和变体都是不变的。

结果

该生成器。

另请参见：

setExtension(char, String)

build

public Locale build()

返回的字段设置该生成器创建的 Locale实例。

这适用于上市Locale.forLanguageTag(java.lang.String)建设现场的转换。（祖父的标签都是setLanguageTag(java.lang.String)。）

结果

一个现场。