compact1, compact2, compact3

java.util.concurrent

Interface ConcurrentNavigableMap<K,V>

参数类型

K -钥匙的Map保持型

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成员。

从以下版本开始：

一点六

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查看键包含在这个Map。
ConcurrentNavigableMap<K,V>	descendingMap() 返回此映射中包含的映射的逆顺序视图。
ConcurrentNavigableMap<K,V>	headMap(K toKey) 返回从这个Map的关键是严格小于 toKey部分。
ConcurrentNavigableMap<K,V>	headMap(K toKey, boolean inclusive) 返回从这个Map的关键是少部分（或相等，如果 inclusive是真的） toKey。
NavigableSet<K>	keySet() 返回一个 NavigableSet查看键包含在这个Map。
NavigableSet<K>	navigableKeySet() 返回一个 NavigableSet查看键包含在这个Map。
ConcurrentNavigableMap<K,V>	subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) 返回从这个Map的键范围从 fromKey到 toKey部分。
ConcurrentNavigableMap<K,V>	subMap(K fromKey, K toKey) 返回从这个Map的键范围从 fromKey，包容的部分 toKey，独家。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey) 返回从这个Map的关键是大于或等于 fromKey部分。
ConcurrentNavigableMap<K,V>	tailMap(K fromKey, boolean inclusive) 返回从这个Map的关键是大于（或等于部分，如果 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

返回从这个Map的键范围从 fromKey到 toKey部分。如果 fromKey和 toKey相等，返回Map是空的，除非 fromInclusive toInclusive都是真实的。返回的Map是由这张Map的支持，所以在返回的Map的变化反映在这张Map上，反之亦然。返回的Map支持这张Map支持的所有可选的Map操作。

返回的Map将把企图把钥匙插在它的范围之外的一个IllegalArgumentException，或构建一个区块是其端点超出其范围。

Specified by:

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不允许null键

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操作。

返回的Map将把企图把钥匙插在其范围内的IllegalArgumentException。

Specified by:

headMap 接口 NavigableMap<K,V>

参数

toKey -返回Map的关键点

inclusive - true如果高终点是被包含在返回的视图

结果

看这张Map的关键是少部分（或相等，如果 inclusive是真的） toKey

异常

ClassCastException -如果 toKey不是这个Map的比较器兼容的（或者，如果Map没有比较，如果 toKey不实现 Comparable）。实现可能，但不是必需的，如果 toKey不能相比，目前在Map键抛出该异常。

如果 toKey NullPointerException是无效的，这张Map不允许null键

IllegalArgumentException -如果这Map本身有一个限制的范围内，和 toKey超出范围的界限

tailMap

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

从接口复制的描述： NavigableMap

返回从这个Map的关键是大于（或等于部分，如果 inclusive是真的） fromKey。返回的Map是由这张Map的支持，所以在返回的Map的变化反映在这张Map上，反之亦然。返回的Map支持这张Map支持的所有可选的Map操作。

返回的Map将把企图把钥匙插在其范围内的IllegalArgumentException。

Specified by:

tailMap 接口 NavigableMap<K,V>

参数

fromKey -返回Map的关键端点低

inclusive - true如果低的终点是被包含在返回的视图

结果

看这张Map的关键是大于（或等于部分，如果 inclusive是真的） fromKey

异常

ClassCastException -如果 fromKey不是这个Map的比较器兼容的（或者，如果Map没有比较，如果 fromKey不实现 Comparable）。实现可能，但不是必需的，如果 fromKey不能相比，目前在Map键抛出该异常。

如果 fromKey NullPointerException是无效的，这张Map不允许null键

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操作。

返回的Map将把企图把钥匙插在其范围内的IllegalArgumentException。

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

Specified by:

subMap 接口 NavigableMap<K,V>

Specified by:

subMap 接口 SortedMap<K,V>

参数

fromKey低端点（含）返回的映射中的键

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

结果

看这张Map的键范围从 fromKey，包容的部分 toKey，独家

异常

ClassCastException -如果 fromKey和 toKey不能与另一个使用这个Map的比较器（或者，如果Map没有比较器，采用自然排序）。实现可能，但不是必需的，如果 fromKey或 toKey不能相比，目前在Map键抛出该异常。

NullPointerException -如果 fromKey或 toKey是无效的，这张Map不允许null键

IllegalArgumentException -如果 fromKey大于 toKey；或者如果这Map本身有一个限制的范围内，和 fromKey或 toKey超出范围的界限

headMap

ConcurrentNavigableMap<K,V> headMap(K toKey)

从接口复制的描述： NavigableMap

返回从这个Map的关键是严格小于 toKey部分。返回的Map是由这张Map的支持，所以在返回的Map的变化反映在这张Map上，反之亦然。返回的Map支持这张Map支持的所有可选的Map操作。

返回的Map将把企图把钥匙插在其范围内的IllegalArgumentException。

相当于headMap(toKey, false)。

Specified by:

headMap 接口 NavigableMap<K,V>

Specified by:

headMap 接口 SortedMap<K,V>

参数

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

结果

看这张Map的关键是严格小于 toKey部分

异常

ClassCastException -如果 toKey不是这个Map的比较器兼容的（或者，如果Map没有比较，如果 toKey不实现 Comparable）。实现可能，但不是必需的，如果 toKey不能相比，目前在Map键抛出该异常。

如果 toKey NullPointerException是无效的，这张Map不允许null键

IllegalArgumentException -如果这Map本身有一个限制的范围内，和 toKey超出范围的界限

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey)

从接口复制的描述： NavigableMap

返回从这个Map的关键是大于或等于 fromKey部分。返回的Map由Map的支持，所以在返回的Map变化都反映在这张Map上，反之亦然。返回的Map支持这张Map支持的所有可选的Map操作。

返回的Map将把企图把钥匙插在其范围内的IllegalArgumentException。

相当于tailMap(fromKey, true)。

Specified by:

tailMap 接口 NavigableMap<K,V>

Specified by:

tailMap 接口 SortedMap<K,V>

参数

fromKey低端点（含）返回的映射中的键

结果

看这张Map的关键是大于或等于 fromKey部分

异常

ClassCastException -如果 fromKey不是这个Map的比较器兼容的（或者，如果Map没有比较，如果 fromKey不实现 Comparable）。实现可能，但不是必需的，如果 fromKey不能相比，目前在Map键抛出该异常。

如果 fromKey NullPointerException是无效的，这张Map不允许null键

IllegalArgumentException -如果这Map本身有一个限制的范围内，和 fromKey超出范围的界限

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

返回此映射中包含的映射的逆顺序视图。该Map是由这张Map的支持，所以对Map的变化反映在Map上，反之亦然。

返回Map具有订购相当于Collections.reverseOrder(comparator())。表达m.descendingMap().descendingMap()返回从m本质上相当于m。

Specified by:

descendingMap 接口 NavigableMap<K,V>

结果

这张Map的一个相反的顺序视图

navigableKeySet

NavigableSet<K> navigableKeySet()

返回一个 NavigableSet查看键包含在这个Map。该集合的迭代器以提升顺序返回键。该集合是由Map的支持，所以对Map的变化反映在集合中，反之亦然。设置支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Set.remove， removeAll， retainAll，和 clear操作。它不支持 add或 addAll操作。

视图的迭代器和spliterators是weakly consistent。

Specified by:

navigableKeySet 接口 NavigableMap<K,V>

结果

在这张Map上的键的可导航的集合视图

keySet

NavigableSet<K> keySet()

返回一个 NavigableSet的关键视图包含在这个Map。该集合的迭代器以提升顺序返回键。该集合是由Map的支持，所以对Map的变化反映在集合中，反之亦然。设置支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Set.remove， removeAll， retainAll，和 clear操作。它不支持 add或 addAll操作。

视图的迭代器和spliterators是weakly consistent。

这种方法是等效的方法navigableKeySet。

Specified by:

keySet 接口 Map<K,V>

Specified by:

keySet 接口 SortedMap<K,V>

结果

在这张Map上的键的可导航的集合视图

descendingKeySet

NavigableSet<K> descendingKeySet()

返回一个相反的顺序 NavigableSet查看键包含在这个Map。该集合的迭代器以递减的顺序返回键。该集合是由Map的支持，所以对Map的变化反映在集合中，反之亦然。设置支持元素的去除，从Map中移除相应的映射，通过 Iterator.remove， Set.remove， removeAll， retainAll，和 clear操作。它不支持 add或 addAll操作。

视图的迭代器和spliterators是weakly consistent。

Specified by:

descendingKeySet 接口 NavigableMap<K,V>

结果

在这张Map中的键的一个反向顺序可导航的集合视图