模块 java.base

软件包 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>

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

此接口是Java Collections Framework的成员。

从以下版本开始：

1.6

嵌套类汇总

Nested classes/interfaces declared in interface java.util.Map

Map.Entry<K,V>

方法摘要

变量和类型	方法	描述
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 ）到 toKey （独占）。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey)	返回此映射部分的视图，其键大于或等于 fromKey 。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey, boolean inclusive)	返回此映射的部分视图，其键大于（或等于，如果 inclusive为真） fromKey 。

声明方法的接口 java.util.concurrent.ConcurrentMap

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

声明方法的接口 java.util.Map

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

声明方法的接口 java.util.NavigableMap

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

声明方法的接口 java.util.SortedMap

comparator, entrySet, firstKey, lastKey, values

方法详细信息

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如果 true高端点包含在返回的视图中

结果

此地图部分的视图，其键范围为 fromKey至 toKey

异常

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

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

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如果 true高端点包含在返回的视图中

结果

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

异常

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

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

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不实现Comparable ）。 如果fromKey无法与地图中当前的键进行比较，则实现可能（但不是必须）抛出此异常。

NullPointerException - 如果 fromKey为null且此映射不允许空键

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

subMap

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

从界面复制的说明： NavigableMap

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

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

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

Specified by:

subMap ，界面 NavigableMap<K,V>

Specified by:

subMap in interface SortedMap<K,V>

参数

fromKey - 返回映射中键的低端点（包括）

toKey - 返回映射中键的高端点（独占）

结果

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

异常

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

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

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未实现Comparable ）。 如果toKey无法与地图中当前的键进行比较，则实现可能（但不是必须）抛出此异常。

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

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未实现Comparable ）。 如果fromKey无法与地图中当前的键进行比较，则实现可能（但不是必须）抛出此异常。

NullPointerException - 如果 fromKey为null且此映射不允许空键

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

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

返回此映射中包含的映射的逆序视图。 降序地图由此地图支持，因此对地图的更改将反映在降序地图中，反之亦然。

返回的地图的排序等同于Collections.reverseOrder (comparator()) 。 表达m.descendingMap().descendingMap()返回一个视图的m实质上等同于m 。

Specified by:

descendingMap ，界面 NavigableMap<K,V>

结果

此地图的逆序视图

navigableKeySet

NavigableSet<K> navigableKeySet()

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

视图的迭代器和分裂器是weakly consistent 。

Specified by:

navigableKeySet在界面 NavigableMap<K,V>

结果

此地图中键的可导航设置视图

keySet

NavigableSet<K> keySet()

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

视图的迭代器和分裂器是weakly consistent 。

Specified by:

descendingKeySet ，界面 NavigableMap<K,V>

结果

此映射中键的反向可导航设置视图