Класс Locale.LanguageRange

Этот класс выражает диапазон языка, определённый в RFC 4647 Сопоставление тегов языка. Диапазон языка — это идентификатор, используемый для выбора тегов языка, удовлетворяющих определённым требованиям, с использованием механизмов, описанных в Сопоставлении языков. Список, представляющий предпочтения пользователя и состоящий из диапазонов языка, называется списком приоритетов языков.

Существует два типа диапазонов языка: базовые и расширенные. В RFC 4647 синтаксис диапазонов языка выражается в ABNF следующим образом:

basic-language-range    = (1*8ALPHA *("-" 1*8alphanum)) / "*"
extended-language-range = (1*8ALPHA / "*")
                          *("-" (1*8alphanum / "*"))
alphanum                = ALPHA / DIGIT

Поля

MAX_WEIGHT

public static final double MAX_WEIGHT

Константа, содержащая максимальное значение веса, 1.0, что указывает на то, что диапазон языков хорошо подходит пользователю.

См. также:

Значения константных полей

MIN_WEIGHT

public static final double MIN_WEIGHT

Константа, содержащая минимальное значение веса, 0.0, что указывает на то, что диапазон языков не подходит пользователю.

См. также:

Значения константных полей

Конструкторы

LanguageRange

public LanguageRange(String range)

Параметры:

range - диапазон языков

Исключения:

NullPointerException - если заданный range null

LanguageRange

public LanguageRange(String range,
                     double weight)

Создает LanguageRange с заданным range и weight. Обратите внимание, что проверка по регистру тегов языков IANA не выполняется во время создания.

Параметры:

range - диапазон языков

weight - значение веса между MIN_WEIGHT и MAX_WEIGHT

Исключения:

NullPointerException - если заданный range null

IllegalArgumentException - если заданное weight меньше MIN_WEIGHT или больше MAX_WEIGHT

Методы

getRange

public String getRange()

Возвращает диапазон языка данного LanguageRange.

Возвращает:

диапазон языка.

getWeight

public double getWeight()

Возвращает вес данного LanguageRange.

Возвращает:

значение веса.

parse

public static List<Locale.LanguageRange> parse(String ranges)

"Accept-Language: ja,en;q=0.4"  (weighted list with Accept-Language prefix)
   "ja,en;q=0.4"                   (weighted list)
   "ja,en"                         (prioritized list)

Range                                   Weight
    "iw" (older tag for Hebrew)             1.0
    "he" (new preferred code for Hebrew)    1.0
    "en-us" (English, United States)        0.7
    "en" (English)                          0.3

Параметры:

ranges - список диапазонов языков, разделенных запятыми, или список диапазонов языков в формате заголовка "Accept-Language", определенного в RFC 2616

Возвращает:

список приоритетов языков, состоящий из диапазонов языков, включенных в заданный ranges , и их эквивалентов, если они доступны. Список изменяемый.

Исключения:

NullPointerException - если ranges равно null

IllegalArgumentException - если диапазон языка или вес, найденные в заданном ranges , имеют неправильный формат

parse

public static List<Locale.LanguageRange> parse(String ranges,
                                               Map<String,List<String>> map)

Парсит заданный ranges для генерации списка приоритетов языков, а затем настраивает список с помощью заданного map. Этот метод эквивалентен mapEquivalents(parse(ranges), map).

Параметры:

ranges - список диапазонов языков, разделенных запятыми, или список диапазонов языков в формате заголовка "Accept-Language", определенного в RFC 2616

map - карта, содержащая информацию для настройки диапазонов языков

Возвращает:

список приоритетов языков с настройкой. Список изменяемый.

Исключения:

NullPointerException - если ranges равно null

IllegalArgumentException - если диапазон языка или вес, найденные в заданном ranges , имеют неправильный формат

См. также:

parse(String), mapEquivalents(java.util.List<java.util.Locale.LanguageRange>, java.util.Map<java.lang.String, java.util.List<java.lang.String>>)

mapEquivalents

public static List<Locale.LanguageRange> mapEquivalents(List<Locale.LanguageRange> priorityList,
                                                        Map<String,List<String>> map)

An example of map:
    Key                            Value
      "zh" (Chinese)                 "zh",
                                     "zh-Hans"(Simplified Chinese)
      "zh-HK" (Chinese, Hong Kong)   "zh-HK"
      "zh-TW" (Chinese, Taiwan)      "zh-TW"

Параметры:

priorityList - список приоритетов языков пользователя

map - карта, содержащая информацию для настройки диапазонов языков

Возвращает:

новый список приоритетов языков с настройкой. Список изменяемый.

Исключения:

NullPointerException - если priorityList null

См. также:

parse(String, Map)

hashCode

public int hashCode()

Возвращает значение хэш-кода для объекта.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Сравнивает этот объект с указанным объектом. Результат равен true, если и только если аргумент не null и является объектом LanguageRange , содержащим те же значения range и weight , что и этот объект.

Переопределяет:

equals в классе Object

Параметры:

obj - объект для сравнения

Возвращает:

true если значения range и weight этого объекта совпадают со значениями obj ; false в противном случае.

См. также:

Object.hashCode(), HashMap