Локаль. Разработчик (Платформа Java SE 7)

java.lang. Объект
- java.util. Локаль. Разработчик

Включение класса:

Локаль
```
public static final class Locale.Builder
extends Object
```
Builder используется, чтобы создать экземпляры Locale от значений, сконфигурированных методами set. В отличие от этого Locale конструкторы, Builder проверки, если значение, сконфигурированное методом set, удовлетворяет требования синтаксиса, определенные Locale класс. A Locale объект создается a Builder правильно построено и может быть преобразован к правильно построенному BCP IETF 47 тегов языка, не теряя информацию.
Отметьте: Locale класс не обеспечивает синтаксических ограничений на разновидность, в то время как BCP 47 требует, чтобы каждый различный подтег был 5 - 8 буквенно-цифровыми индикаторами или синглом, числовым сопровождаемый 3 буквенно-цифровыми индикаторами. Метод setVariant броски IllformedLocaleException для разновидности, которая не удовлетворяет это ограничение. Если необходимо поддерживать такую разновидность, используйте конструктора Локали. Однако, имейте в виду это a Locale объект, создаваемый этот путь, мог бы потерять различную информацию когда преобразовано к BCP 47 тегов языка.
Следующий пример показывает, как создать a Locale объект с Builder.
```
     Locale aLocale = new Builder().setLanguage("sr").setScript("Latn").setRegion("RS").build();
 
```
Разработчики могут быть снова использованы; clear() сбросы все поля к их значениям по умолчанию.
С тех пор:

1.7

См. Также:
Locale.forLanguageTag(java.lang.String)

Сводка конструктора

Конструкторы
Конструктор и Описание

Locale.Builder()
Создает пустого Разработчика.

Конструкторы
Конструктор и Описание
`Locale.Builder()` Создает пустого Разработчика.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Локаль. Разработчик`	`addUnicodeLocaleAttribute(String attribute)` Добавляет unicode атрибут локали, если не уже существующий, иначе не имеет никакого эффекта.
`Локаль`	`build()` Возвращает экземпляр `Locale` создаваемый из полей устанавливается на этом разработчике.
`Локаль. Разработчик`	`clear()` Сбрасывает разработчика к его начальному, пустому состоянию.
`Локаль. Разработчик`	`clearExtensions()` Сбрасывает расширения их начального, пустого состояния.
`Локаль. Разработчик`	`removeUnicodeLocaleAttribute(String attribute)` Удаляет unicode атрибут локали, если есть иначе не имеет никакого эффекта.
`Локаль. Разработчик`	`setExtension(char key, String value)` Устанавливает расширение для данного ключа.
`Локаль. Разработчик`	`setLanguage(String language)` Устанавливает язык.
`Локаль. Разработчик`	`setLanguageTag(String languageTag)` Сбрасывает Разработчика, чтобы соответствовать обеспеченному BCP IETF 47 тегов языка.
`Локаль. Разработчик`	`setLocale(Locale locale)` Сбросы `Builder` соответствовать обеспеченный `locale`.
`Локаль. Разработчик`	`setRegion(String region)` Устанавливает область.
`Локаль. Разработчик`	`setScript(String script)` Устанавливает сценарий.
`Локаль. Разработчик`	`setUnicodeLocaleKeyword(String key, String type)` Устанавливает тип ключевого слова локали Unicode для данного ключа.
`Локаль. Разработчик`	`setVariant(String variant)` Устанавливает разновидность.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - Локаль. Разработчик
```
public Locale.Builder()
```
    Создает пустого Разработчика. Значение по умолчанию всех полей, расширений, и информации о личном пользовании является пустой строкой.
- Деталь метода
  - setLocale
```
public Locale.Builder setLocale(Locale locale)
```
    Сбросы Builder соответствовать обеспеченный locale. Существующее состояние отбрасывается.
    Все поля локали должны быть правильно построены, видеть Locale.
    Локали с любой плохо сформированной полевой причиной IllformedLocaleException быть брошенным, за исключением следующих трех случаев, которые принимаются по причинам совместимости:
    - Локаль ("ja", "JP", "JP") обрабатывается как "ja-JP-u-ca-japanese"
    - Локаль ("th", "TH", "TH") обрабатывается как "th-TH-u-nu-thai"
    - Локаль ("нет", "НЕТ", "Нью-Йорк") обрабатывается как "nn-NO"
    Параметры:
    locale - локаль
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если locale имеет любые плохо сформированные поля.
    
    NullPointerException - если locale нуль.
  - setLanguageTag
```
public Locale.Builder setLanguageTag(String languageTag)
```
    Сбрасывает Разработчика, чтобы соответствовать обеспеченному BCP IETF 47 тегов языка. Отбрасывает существующее состояние. Нуль и пустая строка заставляют разработчика быть сброшенным, как clear(). Теги Grandfathered (см. Locale.forLanguageTag(java.lang.String)) преобразовываются в их каноническую форму прежде, чем быть обработанным. Иначе, тег языка должен быть правильно построен (см. Locale) или исключение выдается (в отличие от этого Locale.forLanguageTag, который только отбрасывает плохо сформированный и после частей тега).
    
    Параметры:
    languageTag - тег языка
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если languageTag плохо формируется
    См. Также:
    Locale.forLanguageTag(String)
  - setLanguage
```
public Locale.Builder setLanguage(String language)
```
    Устанавливает язык. Если language пустая строка или нуль, язык в этом Builder удаляется. Иначе, язык должен быть правильно построен, или исключение выдается.
    Типичное значение языка является двумя или трехбуквенным кодом языка как определено в ISO639.
    
    Параметры:
    language - язык
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если language плохо формируется
  - setScript
```
public Locale.Builder setScript(String script)
```
    Устанавливает сценарий. Если script нуль или пустая строка, сценарий в этом Builder удаляется. Иначе, сценарий должен быть правильно построен, или исключение выдается.
    Типичное значение сценария является четырехбуквенным кодом сценария как определено ISO 15924.
    
    Параметры:
    script - сценарий
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если script плохо формируется
  - setRegion
```
public Locale.Builder setRegion(String region)
```
    Устанавливает область. Если область является нулем или пустой строкой, областью в этом Builder удаляется. Иначе, область должна быть правильно построена, или исключение выдается.
    Типичное значение области является двухбуквенным кодом ISO 3166 или трехразрядной ООН М. 49 кода области.
    Значение страны в Locale создаваемый Builder всегда нормализуется к верхнему регистру.
    
    Параметры:
    region - область
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если region плохо формируется
  - setVariant
```
public Locale.Builder setVariant(String variant)
```
    Устанавливает разновидность. Если разновидность является нулем или пустой строкой, разновидностью в этом Builder удаляется. Иначе, это должно состоять из одного или более правильно построенных подтегов, или исключение выдается.
    Отметьте: Этот метод проверяет если variant удовлетворяет BCP IETF требования синтаксиса 47 различных подтегов, и нормализует значение к строчным буквам. Однако, Locale класс не вводит синтаксического ограничения для разновидности, и различного значения в Locale является чувствительным к регистру. Чтобы установить такую разновидность, используйте конструктора Локали.
    
    Параметры:
    variant - разновидность
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если variant плохо формируется
  - setExtension
```
public Locale.Builder setExtension(char key,
                          String value)
```
    Устанавливает расширение для данного ключа. Если значение является нулем или пустой строкой, расширение удаляется. Иначе, расширение должно быть правильно построено, или исключение выдается.
    Отметьте: ключ 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 для данного ключа. Если тип является нулем, ключевое слово Unicode удаляется. Иначе, ключ должен быть ненулем и обоими ключами, и тип должен быть правильно построен, или исключение выдается.
    Ключи и типы преобразовываются в нижний регистр.
    Note:Setting 'u' расширение через setExtension(char, java.lang.String) замены все ключевые слова локали Unicode с определенными в расширении.
    
    Параметры:
    key - ключ локали Unicode
    type - тип локали Unicode
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    IllformedLocaleException - если key или type плохо формируется
    
    NullPointerException - если key нуль
    См. Также:
    setExtension(char, String)
  - addUnicodeLocaleAttribute
```
public Locale.Builder addUnicodeLocaleAttribute(String attribute)
```
    Добавляет unicode атрибут локали, если не уже существующий, иначе не имеет никакого эффекта. Атрибут не должен быть нулем и должен быть правильно построен, или исключение выдается.
    
    Параметры:
    attribute - атрибут
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    NullPointerException - если attribute нуль
    
    IllformedLocaleException - если attribute плохо формируется
    См. Также:
    setExtension(char, String)
  - removeUnicodeLocaleAttribute
```
public Locale.Builder removeUnicodeLocaleAttribute(String attribute)
```
    Удаляет unicode атрибут локали, если есть иначе не имеет никакого эффекта. Атрибут не должен быть нулем и должен быть правильно построен, или исключение выдается.
    comparision атрибута для удаления является нечувствительным к регистру.
    
    Параметры:
    attribute - атрибут
    
    Возвраты:
    Этот разработчик.
    
    Броски:
    
    NullPointerException - если attribute нуль
    
    IllformedLocaleException - если attribute плохо формируется
    См. Также:
    setExtension(char, String)
  - очистить
```
public Locale.Builder clear()
```
    Сбрасывает разработчика к его начальному, пустому состоянию.
    
    Возвраты:
    Этот разработчик.
  - clearExtensions
```
public Locale.Builder clearExtensions()
```
    Сбрасывает расширения их начального, пустого состояния. Язык, сценарий, область и разновидность неизменны.
    
    Возвраты:
    Этот разработчик.
    См. Также:
    setExtension(char, String)
  - сборка
```
public Locale build()
```
    Возвращает экземпляр Locale создаваемый из полей устанавливается на этом разработчике.
    Это применяет преобразования, перечисленные в Locale.forLanguageTag(java.lang.String) создавая Локаль. (Теги Grandfathered обрабатываются в setLanguageTag(java.lang.String).)
    
    Возвраты:
    Локаль.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Локаль класса. Разработчик

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Локаль. Разработчик

Деталь метода

setLocale

setLanguageTag

setLanguage

setScript

setRegion

setVariant

setExtension

setUnicodeLocaleKeyword

addUnicodeLocaleAttribute

removeUnicodeLocaleAttribute

очистить

clearExtensions

сборка