Класс 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"-to-"zh" отсутствует в карте, выполняется простое замещение, и настроенный список не будет включать "zh" и "zh-CN".

public int hashCode()

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

public boolean equals(Object obj)

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

public String toString()

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