java.util.concurrent
介面 ConcurrentNavigableMap<K,V>

型別參數：

K - 此映射維護的鍵型別

V - 映射值的型別

所有父級介面：

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>

支持 NavigableMap 操作，且以遞歸方式支持其可導航子映射的 ConcurrentMap。

此介面是 Java Collections Framework 的成員。

從以下版本開始：

1.6

巢狀類別摘要

從介面 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 為 true）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 為 true）fromKey。

從介面 java.util.concurrent.ConcurrentMap 繼承的方法

putIfAbsent, remove, replace, replace

從介面 java.util.NavigableMap 繼承的方法

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

從介面 java.util.SortedMap 繼承的方法

comparator, entrySet, firstKey, lastKey, values

從介面 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 相等，則返回的映射為空，除非 fromExclusive 和 toExclusive 都為 true。返回的映射受此映射支持，因此返回映射中的更改將反映在此映射中，反之亦然。返回的映射支持此映射支持的所有可選映射操作。

如果試圖在返回映射的範圍之外插入一個鍵，或者建構一個任一端點位於其範圍之外的子映射，則返回的映射將拋出 IllegalArgumentException。

指定者：

介面 NavigableMap<K,V> 中的 subMap

參數：

fromKey - 返回映射中鍵的低端點

fromInclusive - 如果低端點要包含在返回的視圖中，則為 true

toKey - 返回映射中鍵的高端點

toInclusive - 如果高端點要包含在返回的視圖中，則為 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 為 true）toKey。返回的映射受此映射支持，因此返回映射中的更改將反映在此映射中，反之亦然。返回的映射支持此映射支持的所有可選映射操作。

如果試圖在返回映射的範圍之外插入一個鍵，則返回的映射將拋出 IllegalArgumentException。

指定者：

介面 NavigableMap<K,V> 中的 headMap

參數：

toKey - 返回映射中鍵的高端點

inclusive - 如果高端點要包含在返回的視圖中，則為 true

返回：

此映射的部分視圖，其鍵小於（或等於，如果 inclusive 為 true）toKey

拋出：

ClassCastException - 如果 toKey 與此映射的比較器不相容（如果映射沒有比較器；如果 toKey 沒有實作 Comparable）。如果 toKey 不能與映射中的當前鍵進行比較，則實作可以（但不是必須）拋出此異常。

NullPointerException - 如果 toKey 為 null 並且此映射不允許 null 鍵

IllegalArgumentException - 如果此映射本身有範圍限制，並且 toKey 位於範圍的邊界之外

tailMap

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

從介面 NavigableMap 複製的描述

返回此映射的部分視圖，其鍵大於（或等於，如果 inclusive 為 true）fromKey。返回的映射受此映射支持，因此返回映射中的更改將反映在此映射中，反之亦然。返回的映射支持此映射支持的所有可選映射操作。

如果試圖在返回映射的範圍之外插入一個鍵，則返回的映射將拋出 IllegalArgumentException。

指定者：

介面 NavigableMap<K,V> 中的 tailMap

參數：

fromKey - 返回映射中鍵的低端點

inclusive - 如果低端點要包含在返回的視圖中，則為 true

返回：

此映射的部分視圖，其鍵大於（或等於，如果 inclusive 為 true）fromKey

拋出：

ClassCastException - 如果 fromKey 與此映射的比較器不相容（如果映射沒有比較器；如果 fromKey 沒有實作 Comparable）。如果 fromKey 不能與映射中的當前鍵進行比較，則實作可以（但不是必須）拋出此異常。

NullPointerException - 如果 fromKey 為 null 並且此映射不允許 null 鍵

IllegalArgumentException - 如果此映射本身有範圍限制，並且 fromKey 位於範圍的邊界之外

subMap

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

從介面 NavigableMap 複製的描述

返回此映射的部分視圖，其鍵值的範圍從 fromKey（包括）到 toKey（不包括）。（如果 fromKey 和 toKey 相等，則返回映射為空。）返回的映射受此映射支持，所以在返回映射中的更改將反映在此映射中，反之亦然。返回的映射支持此映射支持的所有可選映射操作。

如果試圖在返回映射的範圍之外插入鍵，則返回的映射將拋出 IllegalArgumentException。

等效於 subMap(fromKey, true, toKey, false)。

指定者：

介面 NavigableMap<K,V> 中的 subMap

指定者：

介面 SortedMap<K,V> 中的 subMap

參數：

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)。

指定者：

介面 NavigableMap<K,V> 中的 headMap

指定者：

介面 SortedMap<K,V> 中的 headMap

參數：

toKey - 返回映射中鍵的高端點（不包括）

返回：

此映射的部分視圖，該映射的鍵嚴格小於 toKey

拋出：

ClassCastException - 如果 toKey 與此映射的比較器不相容（如果該映射沒有比較器；如果 toKey 沒有實作 Comparable）。如果 toKey 不能與映射中的當前鍵進行比較，則實作可以（但不是必須）拋出此異常。

NullPointerException - 如果 toKey 為 null，並且此映射不允許使用 null 鍵

IllegalArgumentException - 如果此映射本身有範圍限制，並且 toKey 位於範圍的邊界之外

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey)

從介面 NavigableMap 複製的描述

返回此映射的部分視圖，其鍵大於等於 fromKey。返回的映射受此映射支持，所以在返回映射中的更改將反映在映射中，反之亦然。返回的映射支持此映射支持的所有可選映射操作。

如果試圖在返回映射的範圍之外插入鍵，則返回的映射將拋出 IllegalArgumentException。

等效於 tailMap(fromKey, true)。

指定者：

介面 NavigableMap<K,V> 中的 tailMap

指定者：

介面 SortedMap<K,V> 中的 tailMap

參數：

fromKey - 返回映射中鍵的低端點（包括）

返回：

此映射的部分視圖，其鍵大於等於 fromKey

拋出：

ClassCastException - 如果 fromKey 與此映射的比較器不相容（如果該映射沒有比較器；如果 fromKey 沒有實作 Comparable）。如果 fromKey 不能與映射中的當前鍵進行比較，則實作可以（但不是必須）拋出此異常。

NullPointerException - 如果 fromKey 為 null，並且此映射不允許使用 null 鍵

IllegalArgumentException - 如果此映射本身有範圍限制，並且 fromKey 位於範圍的邊界之外

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

返回此映射中所包含映射關係的逆序視圖。降序映射受此映射的支持，因此對此映射的更改將反映在降序映射中，反之亦然。

返回映射的順序等於 Collections.reverseOrder(comparator())。表達式 m.descendingMap().descendingMap() 返回的 m 視圖基本等效於 m。

指定者：

介面 NavigableMap<K,V> 中的 descendingMap

返回：

此映射的逆序視圖

navigableKeySet

NavigableSet<K> navigableKeySet()

返回此映射中所包含鍵的 NavigableSet 視圖。set 的迭代器按升序返回鍵。set 受映射支持，因此對映射的更改將反映在 set 中，反之亦然。set 支持元素移除，即通過 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

視圖的 iterator 是一個不會拋出 ConcurrentModificationException 的“弱一致”迭代器，能確保遍歷建構迭代器後存在的所有元素，並且可以（但並不保證）反映建構後的所有修改。

指定者：

介面 NavigableMap<K,V> 中的 navigableKeySet

返回：

此映射中鍵的可導航 set 視圖

keySet

NavigableSet<K> keySet()

返回此映射中所包含鍵的 NavigableSet 視圖。set 的迭代器按升序返回鍵。set 受映射支持，因此對映射的更改將反映在 set 中，反之亦然。set 支持元素移除，即通過 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

視圖的 iterator 是一個不會拋出 ConcurrentModificationException 的“弱一致”迭代器，能確保遍歷建構迭代器後存在的所有元素，並且可以（但並不保證）反映建構後的所有修改。

此方法等效於方法 navigableKeySet。

指定者：

介面 Map<K,V> 中的 keySet

指定者：

介面 SortedMap<K,V> 中的 keySet

返回：

此映射中鍵的可導航 set 視圖

descendingKeySet

NavigableSet<K> descendingKeySet()

返回此映射中所包含鍵的逆序 NavigableSet 視圖。set 的迭代器按降序返回鍵。set 受映射支持，因此對映射的更改將反映在 set 中，反之亦然。set 支持元素移除，即通過 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作從映射中移除相應的映射關係。它不支持 add 或 addAll 操作。

視圖的 iterator 是一個不會拋出 ConcurrentModificationException 的“弱一致”迭代器，能確保遍歷建構迭代器後存在的所有元素，並且可以（但並不保證）反映建構後的所有修改。

指定者：

介面 NavigableMap<K,V> 中的 descendingKeySet

返回：

此映射中鍵的逆序可導航 set 視圖