compact1, compact2, compact3

java.util.concurrent

Interface ConcurrentNavigableMap<K,V>

参数类型

K - 由该地图维护的键的类型

V - 映射值的类型

All Superinterfaces:

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>

A ConcurrentMap支持NavigableMap操作，并递归地为其可导航的子地图。

此接口是成员Java Collections Framework 。

从以下版本开始：

1.6

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

方法摘要

Modifier and Type	Method and Description
NavigableSet<K>	descendingKeySet() 返回此地图中包含的键的相反顺序NavigableSet 。
ConcurrentNavigableMap<K,V>	descendingMap() 返回此映射中包含的映射的反向排序视图。
ConcurrentNavigableMap<K,V>	headMap(K toKey) 返回此地图部分的视图，其密钥严格小于 toKey 。
ConcurrentNavigableMap<K,V>	headMap(K toKey, boolean inclusive) 返回此地图部分的视图，其键值小于（或等于，如果 inclusive为真） toKey 。
NavigableSet<K>	keySet() 返回此地图中包含的键的NavigableSet视图。
NavigableSet<K>	navigableKeySet() 返回此地图中包含的键的NavigableSet视图。
ConcurrentNavigableMap<K,V>	subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) 返回此地图部分的视图，其关键字范围为 fromKey至 toKey 。
ConcurrentNavigableMap<K,V>	subMap(K fromKey, K toKey) 返回此地图部分的视图，其关键字范围从 fromKey （含）到 toKey ，独占。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey) 返回此地图部分的视图，其键大于或等于 fromKey 。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey, boolean inclusive) 返回此地图部分的视图，其键大于（或等于，如果 inclusive为真） fromKey 。

Methods inherited from interface java.util.concurrent.ConcurrentMap

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Methods inherited from interface java.util.NavigableMap

ceilingEntry, ceilingKey, firstEntry, floorEntry, floorKey, higherEntry, higherKey, lastEntry, lowerEntry, lowerKey, pollFirstEntry, pollLastEntry

Methods inherited from interface java.util.SortedMap

comparator, entrySet, firstKey, lastKey, values

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

方法详细信息

subMap

ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                   boolean fromInclusive,
                                   K toKey,
                                   boolean toInclusive)

说明从界面： NavigableMap复制

返回此地图部分的视图，其关键字范围为fromKey至toKey 。 如果fromKey和toKey相等，返回的地图是空的，除非fromInclusive和toInclusive都为真。 返回的地图由此地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的映射将会尝试在其范围之外插入一个键，或者构造一个其端点位于其范围之外的子映射，因此它将抛出一个IllegalArgumentException 。

Specified by:

subMap在接口 NavigableMap<K,V>

参数

fromKey - 返回地图中的键的低端点

fromInclusive - true如果 true低端点包括在返回的视图中

toKey - 返回地图中的键的高端点

toInclusive - true如果高端点要包含在返回的视图中

结果

该地图的部分视图的范围从 fromKey到 toKey

异常

ClassCastException - 如果fromKey和toKey无法使用该地图的比较器相互比较（或者，如果地图没有比较器，则使用自然排序）。 如果fromKey或toKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 fromKey或 toKey为空，并且此映射不允许空键

IllegalArgumentException - 如果fromKey大于toKey ; 或者如果该地图本身具有有限的范围，并且fromKey或toKey位于范围的范围之外

headMap

ConcurrentNavigableMap<K,V> headMap(K toKey,
                                    boolean inclusive)

说明从界面： NavigableMap复制

返回该地图部分的视图，其键值小于（或等于，如果inclusive为真） toKey 。 返回的地图由此地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的地图会抛出一个IllegalArgumentException ，试图在其范围之外插入一个键。

Specified by:

headMap在界面 NavigableMap<K,V>

参数

toKey - 返回地图中的键的高端点

inclusive - true如果高端点要包含在返回的视图中

结果

该地图的部分的视图，其键小于（或等于，如果 inclusive为真） toKey

异常

ClassCastException - 如果toKey与此地图的toKey器不兼容（或者如果地图没有比较器，如果toKey不实现Comparable ）。 如果toKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 toKey为空，并且此映射不允许空键

IllegalArgumentException - 如果此地图本身有限制范围，并且 toKey位于范围范围之外

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey,
                                    boolean inclusive)

描述从界面： NavigableMap复制

返回此地图部分的视图，其键大于（或等于，如果inclusive为真） fromKey 。 返回的地图由此地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的地图会抛出一个IllegalArgumentException ，试图在其范围之外插入一个键。

Specified by:

tailMap在界面 NavigableMap<K,V>

参数

fromKey - 返回地图中键的低端点

inclusive - true如果 true低端点包括在返回的视图中）

结果

该地图的部分的视图，其键大于（或等于，如果 inclusive为真） fromKey

异常

ClassCastException - 如果fromKey与此地图的fromKey器不兼容（或者如果地图没有比较器，如果fromKey不实现Comparable ）。 如果fromKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 fromKey为空，并且该地图不允许空值

IllegalArgumentException - 如果此地图本身有限制范围，并且 fromKey位于范围的范围之外

subMap

ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                   K toKey)

描述从界面： NavigableMap复制

返回此映射，其键从范围的所述部分的视图fromKey （包括）到toKey ，排他性的。 （如果fromKey和toKey相等，返回的地图为空。）返回的地图由该地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的地图会抛出一个IllegalArgumentException ，试图在其范围之外插入一个键。

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

Specified by:

subMap中的 NavigableMap<K,V>

Specified by:

subMap在界面 SortedMap<K,V>

参数

fromKey - 返回地图中的键的低端点（含）

toKey - 返回地图中的键的高端点（独占）

结果

该地图的部分视图，其范围从 fromKey （含）到 toKey ，独占

异常

ClassCastException - 如果fromKey和toKey无法使用该地图的比较器相互比较（或者，如果地图没有比较器，则使用自然排序）。 如果fromKey或toKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 fromKey或 toKey为空，并且此映射不允许空键

IllegalArgumentException - 如果fromKey大于toKey ; 或者如果此地图本身具有限制范围，并且fromKey或toKey位于范围范围之外

headMap

ConcurrentNavigableMap<K,V> headMap(K toKey)

说明从界面： NavigableMap复制

返回此地图部分的视图，其密钥严格小于toKey 。 返回的地图由此地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的地图会抛出一个IllegalArgumentException ，试图在其范围之外插入一个键。

相当于headMap(toKey, false) 。

Specified by:

headMap在界面 NavigableMap<K,V>

Specified by:

headMap在界面 SortedMap<K,V>

参数

toKey - 返回地图中的键的高端点（独占）

结果

该地图的部分密钥严格小于 toKey

异常

ClassCastException - 如果toKey与此地图的toKey器不兼容（或者如果地图没有比较器，如果toKey不实现Comparable ）。 如果toKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 toKey为空，并且此映射不允许空键

IllegalArgumentException - 如果这张地图本身有一个有限的范围，而 toKey位于范围的范围之外

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey)

说明从界面： NavigableMap复制

返回此地图部分的视图，其键大于或等于fromKey 。 返回的地图由此地图支持，因此返回的地图中的更改将反映在该地图中，反之亦然。 返回的地图支持该地图支持的所有可选地图操作。

返回的地图将扔一个IllegalArgumentException尝试在其范围之外插入一个键。

相当于tailMap(fromKey, true) 。

Specified by:

tailMap在界面 NavigableMap<K,V>

Specified by:

tailMap在接口 SortedMap<K,V>

参数

fromKey - 返回地图中键的低端点（含）

结果

该地图的部分的视图，其键大于或等于 fromKey

异常

ClassCastException - 如果fromKey与此地图的fromKey器不兼容（或者如果地图没有比较器，如果fromKey不实现Comparable ）。 如果fromKey无法与当前在地图中的键进行比较，则实施可能但不是必须抛出此异常。

NullPointerException - 如果 fromKey为空，并且此映射不允许空值

IllegalArgumentException - 如果这个地图本身有一个限制的范围，而 fromKey位于范围的范围之外

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

返回此映射中包含的映射的反向排序视图。 降序地图由该地图支持，所以对地图的更改反映在降序地图中，反之亦然。

返回的地图的订单等价于Collections.reverseOrder (comparator()) 。 表达式m.descendingMap().descendingMap()返回m.descendingMap().descendingMap()的视图， m相当于m 。

Specified by:

descendingMap在界面 NavigableMap<K,V>

结果

这张地图的倒序视图

navigableKeySet

NavigableSet<K> navigableKeySet()

返回此地图中包含的键的NavigableSet视图。 该集合的迭代器按升序返回密钥。 该集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

视图的迭代器和拼接器是weakly consistent 。

Specified by:

navigableKeySet在界面 NavigableMap<K,V>

结果

该地图中的键的可导航集合视图

keySet

NavigableSet<K> keySet()

返回此地图中包含的键的NavigableSet视图。 该集合的迭代器按升序返回密钥。 该集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

视图的迭代器和拼接器是weakly consistent 。

该方法相当于方法navigableKeySet 。

Specified by:

keySet在接口 Map<K,V>

Specified by:

keySet在接口 SortedMap<K,V>

结果

该地图中的键的可导航集合视图

descendingKeySet

NavigableSet<K> descendingKeySet()

返回此地图中包含的键的相反顺序NavigableSet 。 集合的迭代器按降序返回密钥。 该集合由地图支持，因此对地图的更改将反映在集合中，反之亦然。 该组支持元件移除，即从映射中相应的映射，经由Iterator.remove ， Set.remove ， removeAll ， retainAll和clear操作。 它不支持add或addAll操作。

视图的迭代器和拼接器是weakly consistent 。

Specified by:

descendingKeySet中的 NavigableMap<K,V>

结果

该地图中的键的反向导航设置视图