Класс Locale.LanguageRange

public static final double MAX_WEIGHT

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

public static final double MIN_WEIGHT

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

public LanguageRange(String range)

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

Это эквивалентно LanguageRange(range, MAX_WEIGHT).

public LanguageRange(String range, double weight)

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

public String getRange()

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

public double getWeight()

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

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

Парсит заданный ranges для генерации списка приоритетов языка.

Этот метод выполняет синтаксическую проверку каждого диапазона языка в заданном ranges, но не выполняет проверку с использованием реестра подтэгов языка IANA.

Задаваемый 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)
 

В весовом списке каждому диапазону языка присваивается значение веса. Значение веса идентично значению "quality value" в RFC 2616 и выражает то, насколько пользователь предпочитает язык. Значение веса указывается после соответствующего диапазона языка, за которым следует ";q=", а значение веса по умолчанию равно MAX_WEIGHT при его отсутствии.

В отличие от весового списка, диапазоны языка в списке с приоритетами сортируются в порядке убывания в зависимости от приоритета. Первый диапазон языка имеет наивысший приоритет и в большей степени соответствует предпочтениям пользователя.

В любом случае диапазоны языка сортируются в порядке убывания в списке приоритетов языка на основе приоритета или веса. Если диапазон языка встречается в заданном ranges более одного раза, только первый из них включается в список приоритетов языка.

Возвращаемый список состоит из диапазонов языка из заданного ranges и их эквивалентов, найденных в реестре подтэгов языка IANA. Например, если заданный ranges равен "Accept-Language: iw,en-us;q=0.7,en;q=0.3", элементами возвращаемого списка являются:

  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
 

Два диапазона языка, "iw" и "he", имеют одинаковый наивысший приоритет в списке. Добавление "he" в список приоритетов языка пользователя позволяет методу сопоставления местоположений найти иврит в качестве сопоставляемого местоположения (или тега языка), даже если приложение или система предлагают только "he" в качестве поддерживаемого местоположения (или тега языка).

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

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

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

Создаёт новый настраиваемый список приоритетов языка с помощью заданного priorityList и map. Если заданный map пустой, этот метод возвращает копию заданного priorityList.

В карте ключ представляет собой диапазон языка, а значение — список его эквивалентов. '*' не может использоваться в карте. Каждый эквивалентный диапазон языка имеет то же значение веса, что и его исходный диапазон языка.

  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"
 

Настройка выполняется после изменения с использованием реестра подтэгов языка IANA.

Например, если список приоритетов языка пользователя состоит из пяти диапазонов языка ("zh", "zh-CN", "en", "zh-TW", и "zh-HK"), новый сгенерированный список приоритетов языка, настроенный с помощью приведенного выше примера карты, будет содержать "zh", "zh-Hans", "zh-CN", "zh-Hans-CN", "en", "zh-TW", и "zh-HK".

"zh-HK" и "zh-TW" не преобразуются в "zh-Hans-HK" или "zh-Hans-TW", даже если они включены в список приоритетов языка. В этом примере отображение используется для явного различения упрощенного китайского и традиционного китайского.

Если отображение "zh" на "zh" не включено в карту, будет выполнено простое замещение, и настроенный список не будет включать "zh" и "zh-CN".

public int hashCode()

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

public boolean equals(Object obj)

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

public String toString()

Возвращает информативную строковое представление этого объекта LanguageRange, состоящую из диапазона языка и веса, если диапазон взвешен, а вес меньше максимального веса.