Module java.base
Package java.util.concurrent

Interface ConcurrentNavigableMap<K,V>

类型参数:
K - 此映射维护的键的类型
V - 映射值的类型
所有超级接口:
ConcurrentMap<K,V>, Map<K,V>, NavigableMap<K,V>, SequencedMap<K,V>, SortedMap<K,V>
所有已知实现类:
ConcurrentSkipListMap
public interface ConcurrentNavigableMap<K,V> extends ConcurrentMap<K,V>, NavigableMap<K,V>
支持ConcurrentMap操作的NavigableMap的视图，对其可导航子映射也是递归的。

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

自版本:
1.6

  • Method Details

    • subMap

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

      如果尝试插入超出其范围的键，则返回的映射将抛出IllegalArgumentException。

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

    • headMap

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

      如果尝试插入超出其范围的键，则返回的映射将抛出IllegalArgumentException。

      指定者:
      headMap 在接口 NavigableMap<K,V>
      参数:
      toKey - 返回的映射中键的高端点
      inclusive - 如果要在返回视图中包含高端点，则为true
      返回:
      键小于（如果inclusive为true，则为小于或等于）toKey的部分视图
      抛出:
      ClassCastException - 如果toKey与此映射的比较器不兼容（或者如果映射没有比较器，则toKey不实现Comparable）。如果toKey无法与当前映射中的键进行比较，实现可能会但不一定会抛出此异常。
      NullPointerException - 如果toKey为null且此映射不允许空键
      IllegalArgumentException - 如果此映射本身具有受限范围，并且toKey超出范围的边界

    • tailMap

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

      如果尝试插入超出其范围的键，则返回的映射将抛出IllegalArgumentException。

      指定者:
      tailMap 在接口 NavigableMap<K,V>
      参数:
      fromKey - 返回的映射中键的低端点
      inclusive - 如果要在返回视图中包含低端点，则为true
      返回:
      键大于（如果inclusive为true，则为大于或等于）fromKey的部分视图
      抛出:
      ClassCastException - 如果fromKey与此映射的比较器不兼容（或者如果映射没有比较器，则fromKey不实现Comparable）。如果fromKey无法与当前映射中的键进行比较，实现可能会但不一定会抛出此异常。
      NullPointerException - 如果fromKey为null且此映射不允许空键
      IllegalArgumentException - 如果此映射本身具有受限范围，并且fromKey超出范围的边界

    • subMap

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

      如果尝试插入超出其范围的键，则返回的映射将抛出IllegalArgumentException。

      等同于subMap(fromKey, true, toKey, false)。

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

    • headMap

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

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

      等效于headMap(toKey, false)。

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

    • tailMap

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

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

      等效于tailMap(fromKey, true)。

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

    • descendingMap

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

      返回的地图具有等效于Collections.reverseOrder(comparator())的排序。表达式m.descendingMap().descendingMap()返回与m基本等效的m视图。

      指定由：
      descendingMap 在接口 NavigableMap<K,V>中
      返回：
      此地图的逆序视图

    • keySet

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

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

      此方法等效于方法navigableKeySet。

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

    • descendingKeySet

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

      该视图的迭代器和分割器是弱一致性的。

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