模块  java.base
软件包  java.util

Class Locale.LanguageRange

    • 字段详细信息

      • 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)
        构造一个LanguageRange使用给定的range 请注意,在构建时未对IANA语言子标签注册表进行验证。

        这相当于LanguageRange(range, MAX_WEIGHT)

        参数
        range - 语言范围
        异常
        NullPointerException - 如果给定的 rangenull
        IllegalArgumentException - 如果给定的 range不符合RFC 4647中提到的语言范围的语法
      • LanguageRange

        public LanguageRange​(String range,
                             double weight)
        构造一个LanguageRange使用给定的rangeweight 请注意,在构建时未对IANA语言子标签注册表进行验证。
        参数
        range - 语言范围
        weight - 重量值,在 MIN_WEIGHTMAX_WEIGHT之间
        异常
        NullPointerException - 如果给定的 rangenull
        IllegalArgumentException - 如果给定的 range不符合RFC 4647中提到的语言范围的语法,或者给定的 weight小于 MIN_WEIGHT或大于 MAX_WEIGHT
    • 方法详细信息

      • getRange

        public String getRange()
        返回此 LanguageRange的语言范围。
        结果
        语言范围。
      • getWeight

        public double getWeight()
        返回此 LanguageRange的重量。
        结果
        重量值。
      • parse

        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) 
        在加权列表中,每个语言范围都被赋予权重值。 权重值与RFC 2616中的“质量值” 相同 ,它表示用户更喜欢该语言的程度。 权重值对应的语言范围之后进行后指定";q=" ,默认权重值是MAX_WEIGHT被省略,当它。

        与加权列表不同,优先级列表中的语言范围基于其优先级以降序排序。 第一语言范围具有最高优先级,并且最符合用户的偏好。

        在任何一种情况下,语言范围都根据优先级或权重在语言优先级列表中按降序排序。 如果语言范围ranges出现在给定的ranges ,则只有第一个语言范围包含在语言优先级列表中。

        返回的列表包含给定ranges的语言范围及其在IANA语言子标签注册表中找到的等价物。 例如,如果给定的ranges"Accept-Language: iw,en-us;q=0.7,en;q=0.3""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"作为受支持的语言环境(或语言标记),语言环境匹配方法也可以将希伯来语作为匹配的语言环境(或语言标记)。
        参数
        ranges - 以逗号分隔的语言范围列表或以 RFC 2616中定义的“Accept-Language”标头形式的语言范围列表
        结果
        语言优先级列表,包含给定ranges包含的语言范围及其等效语言范围(如果有)。 该列表是可修改的。
        异常
        NullPointerException - 如果 ranges为空
        IllegalArgumentException - 如果给定的 ranges的语言范围或重量 ranges不正确
      • mapEquivalents

        public static List<Locale.LanguageRange> mapEquivalents​(List<Locale.LanguageRange> priorityList,
                                                                Map<String,​List<String>> map)
        使用给定的priorityListmap生成新的自定义语言优先级列表。 如果给定的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"

        参数
        priorityList - 用户的语言优先级列表
        map - 包含用于自定义语言范围的信息的映射
        结果
        具有自定义功能的新语言优先级列表。 该列表是可修改的。
        异常
        NullPointerException - 如果 priorityListnull
        另请参见:
        parse(String, Map)
      • equals

        public boolean equals​(Object obj)
        将此对象与指定的对象进行比较。 当且仅当参数不是null并且是包含与此对象相同的rangeweight值的LanguageRange对象时,结果为true。
        重写:
        equals在类 Object
        参数
        obj - 要与之比较的对象
        结果
        true如果此对象的rangeweight是一样的obj的; 否则为false
        另请参见:
        Object.hashCode()HashMap
      • toString

        public String toString()
        返回此 LanguageRange对象的信息性字符串表示形式,如果范围已加权且权重小于最大权重, LanguageRange语言范围和权重组成。
        重写:
        toString在类 Object
        结果
        LanguageRange对象的字符串表示形式。