模块 java.base
包 java.util.concurrent

接口 ConcurrentNavigableMap<K,V>

类型参数：
K - 此map维护的键类型
V - 映射值的类型
所有父级接口：
ConcurrentMap<K,V> , Map<K,V> , NavigableMap<K,V> , SortedMap<K,V>
所有已知的实现类：
ConcurrentSkipListMap
public interface ConcurrentNavigableMap<K,V> extends ConcurrentMap <K,V>, NavigableMap <K,V>
ConcurrentMap 支持 NavigableMap 操作，并递归地支持其可导航子map。

此接口是 Java 集合框架 的成员。

自从：
1.6

  • 方法详情

    • subMap

      ConcurrentNavigableMap <K ,V > subMap(K  fromKey, boolean fromInclusive, K  toKey, boolean toInclusive)
      从接口 NavigableMap 复制的描述
      返回此map部分的视图，其键范围从 fromKey 到 toKey 。如果 fromKey 和 toKey 相等，则返回的映射为空，除非 fromInclusive 和 toInclusive 都为真。返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将抛出 IllegalArgumentException 尝试插入其范围之外的键，或构建其端点位于其范围之外的子图。

      指定者：
      subMap 在接口 NavigableMap<K,V> 中
      参数：
      fromKey - 返回map中键的低端点
      fromInclusive - true 如果低端点要包含在返回的视图中
      toKey - 返回map中键的高端点
      toInclusive - true 如果高端点要包含在返回的视图中
      返回：
      此map的部分视图，其键范围从 fromKey 到 toKey
      抛出：
      ClassCastException - 如果 fromKey 和 toKey 无法使用此map的比较器相互比较（或者，如果map没有比较器，则使用自然排序）。如果无法将 fromKey 或 toKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 fromKey 或 toKey 为空且此map不允许空键
      IllegalArgumentException - 如果 fromKey 大于 toKey ；或者如果这个map本身有一个限制范围，并且 fromKey 或 toKey 位于范围的边界之外

    • headMap

      ConcurrentNavigableMap <K ,V > headMap(K  toKey, boolean inclusive)
      从接口 NavigableMap 复制的描述
      返回此map部分的视图，其键小于（或等于，如果 inclusive 为真） toKey 。返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将在尝试插入其范围之外的键时抛出 IllegalArgumentException。

      指定者：
      headMap 在接口 NavigableMap<K,V> 中
      参数：
      toKey - 返回map中键的高端点
      inclusive - true 如果高端点要包含在返回的视图中
      返回：
      此map的部分视图，其键小于（或等于，如果inclusive为真）toKey
      抛出：
      ClassCastException - 如果 toKey 与此map的比较器不兼容（或者，如果map没有比较器，如果 toKey 未实现 Comparable ）。如果无法将 toKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 toKey 为空且此map不允许空键
      IllegalArgumentException - 如果这个map本身有一个限制范围，并且 toKey 位于范围的边界之外

    • tailMap

      ConcurrentNavigableMap <K ,V > tailMap(K  fromKey, boolean inclusive)
      从接口 NavigableMap 复制的描述
      返回此map部分的视图，其键大于（或等于，如果 inclusive 为真） fromKey 。返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将在尝试插入其范围之外的键时抛出 IllegalArgumentException。

      指定者：
      tailMap 在接口 NavigableMap<K,V> 中
      参数：
      fromKey - 返回map中键的低端点
      inclusive - true 如果低端点要包含在返回的视图中
      返回：
      此map的部分视图，其键大于（或等于，如果inclusive为真）fromKey
      抛出：
      ClassCastException - 如果 fromKey 与此map的比较器不兼容（或者，如果map没有比较器，如果 fromKey 未实现 Comparable ）。如果无法将 fromKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 fromKey 为空且此map不允许空键
      IllegalArgumentException - 如果这个map本身有一个限制范围，并且 fromKey 位于范围的边界之外

    • subMap

      ConcurrentNavigableMap <K ,V > subMap(K  fromKey, K  toKey)
      从接口 NavigableMap 复制的描述
      返回此map部分的视图，其键范围从 fromKey（含）到 toKey（不包含）。 （如果 fromKey 和 toKey 相等，则返回的map为空。）返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将在尝试插入其范围之外的键时抛出 IllegalArgumentException。

      相当于 subMap(fromKey, true, toKey, false) 。

      指定者：
      subMap 在接口 NavigableMap<K,V> 中
      指定者：
      subMap 在接口 SortedMap<K,V> 中
      参数：
      fromKey - 返回map中键的低端点（包括）
      toKey - 返回map中键的高端点（不包括）
      返回：
      此map的部分视图，其键范围从 fromKey 到 toKey 不包括在内
      抛出：
      ClassCastException - 如果 fromKey 和 toKey 无法使用此map的比较器相互比较（或者，如果map没有比较器，则使用自然排序）。如果无法将 fromKey 或 toKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 fromKey 或 toKey 为空且此map不允许空键
      IllegalArgumentException - 如果 fromKey 大于 toKey ；或者如果这个map本身有一个限制范围，并且 fromKey 或 toKey 位于范围的边界之外

    • headMap

      ConcurrentNavigableMap <K ,V > headMap(K  toKey)
      从接口 NavigableMap 复制的描述
      返回此map部分的视图，其键严格小于 toKey 。返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将在尝试插入其范围之外的键时抛出 IllegalArgumentException。

      相当于 headMap(toKey, false) 。

      指定者：
      headMap 在接口 NavigableMap<K,V> 中
      指定者：
      headMap 在接口 SortedMap<K,V> 中
      参数：
      toKey - 返回map中键的高端点（不包括）
      返回：
      此map的键严格小于 toKey 的部分的视图
      抛出：
      ClassCastException - 如果 toKey 与此map的比较器不兼容（或者，如果map没有比较器，如果 toKey 未实现 Comparable ）。如果无法将 toKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 toKey 为空且此map不允许空键
      IllegalArgumentException - 如果这个map本身有一个限制范围，并且 toKey 位于范围的边界之外

    • tailMap

      ConcurrentNavigableMap <K ,V > tailMap(K  fromKey)
      从接口 NavigableMap 复制的描述
      返回此map的键大于或等于 fromKey 的部分的视图。返回的map受此map支持，因此返回map中的更改会反映在此map中，反之亦然。返回的map支持此map支持的所有可选map操作。

      返回的映射将在尝试插入其范围之外的键时抛出 IllegalArgumentException。

      相当于 tailMap(fromKey, true) 。

      指定者：
      tailMap 在接口 NavigableMap<K,V> 中
      指定者：
      tailMap 在接口 SortedMap<K,V> 中
      参数：
      fromKey - 返回map中键的低端点（包括）
      返回：
      此map的键大于或等于 fromKey 的部分的视图
      抛出：
      ClassCastException - 如果 fromKey 与此map的比较器不兼容（或者，如果map没有比较器，如果 fromKey 未实现 Comparable ）。如果无法将 fromKey 与当前map中的键进行比较，实现可能会（但不是必须）抛出此异常。
      NullPointerException - 如果 fromKey 为空且此map不允许空键
      IllegalArgumentException - 如果这个map本身有一个限制范围，并且 fromKey 位于范围的边界之外

    • descendingMap

      ConcurrentNavigableMap <K ,V > descendingMap()
      返回此map中包含的映射的逆序视图。降序图受此map支持，因此对map的更改会反映在降序图中，反之亦然。

      返回的map的排序等同于 Collections.reverseOrder (comparator()) 。表达式 m.descendingMap().descendingMap() 返回 m 的视图，本质上等同于 m 。

      指定者：
      descendingMap 在接口 NavigableMap<K,V> 中
      返回：
      这张map的倒序视图

    • keySet

      NavigableSet <K > keySet()
      返回此map中包含的键的 NavigableSet 视图。该集合的迭代器按升序返回键。该集合由map支持，因此对map的更改会反映在集合中，反之亦然。该集合支持元素删除，即通过 Iterator.remove 、 Set.remove 、 removeAll 、 retainAll 和 clear 操作从map中删除相应的映射。它不支持 add 或 addAll 操作。

      视图的迭代器和拆分器是 弱一致 。

      此方法等同于方法 navigableKeySet 。

      指定者：
      keySet 在接口 Map<K,V> 中
      指定者：
      keySet 在接口 SortedMap<K,V> 中
      返回：
      此map中键的可导航集合视图

    • descendingKeySet

      NavigableSet <K > descendingKeySet()
      返回此map中包含的键的逆序 NavigableSet 视图。该集合的迭代器按降序返回键。该集合由map支持，因此对map的更改会反映在集合中，反之亦然。该集合支持元素删除，即通过 Iterator.remove 、 Set.remove 、 removeAll 、 retainAll 和 clear 操作从map中删除相应的映射。它不支持 add 或 addAll 操作。

      视图的迭代器和拆分器是 弱一致 。

      指定者：
      descendingKeySet 在接口 NavigableMap<K,V> 中
      返回：
      此map中键的逆序可导航集视图