-
- 参数类型
-
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
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 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
-
-
-
-
方法详细信息
-
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 interfaceSortedMap<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
。
-
descendingKeySet
NavigableSet<K> descendingKeySet()
返回此映射中包含的键的反向顺序NavigableSet
视图。 set的迭代器按降序返回键。 该集由地图支持,因此对地图的更改将反映在集中,反之亦然。 该组支持元件移除,即从映射中相应的映射,经由Iterator.remove
,Set.remove
,removeAll
,retainAll
,和clear
操作。 它不支持add
或addAll
操作。视图的迭代器和分裂器是weakly consistent 。
- Specified by:
-
descendingKeySet
,界面NavigableMap<K,V>
- 结果
- 此映射中键的反向可导航设置视图
-
-