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) toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다.
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) fromKey 보다 큰 키 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다.

인터페이스 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 를 throw 합니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 subMap

파라미터:

fromKey - 반환되는 맵내의 키의 하단점

fromInclusive - 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true

toKey - 반환되는 맵내의 키의 상단점

toInclusive - 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true

반환값:

맵의 fromKey ~ toKey 의 키 범위를 가지는 부분의 뷰

예외:

ClassCastException - 이 맵의 Comparator를 사용해 (이 맵이 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromKey 와 toKey 와의 상호 비교를 실시할 수 없는 경우. 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 또는 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromKey 또는 toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

IllegalArgumentException - fromKey 가 toKey 보다 큰 경우, 또는 이 맵 자체가 제한된 범위를 가지고 있어fromKey 또는 toKey 가 그 범위의 경계의 외측에 있는 경우

headMap

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

인터페이스 NavigableMap 의 기술:

toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 headMap

파라미터:

toKey - 반환되는 맵내의 키의 상단점

inclusive - 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true

반환값:

toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰

예외:

ClassCastException - toKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,toKey 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

IllegalArgumentException - 이 맵 자체가 제한된 범위를 가지고 있어toKey 가 그 범위의 경계의 외측에 있는 경우

tailMap

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

인터페이스 NavigableMap 의 기술:

fromKey 보다 큰 키 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 tailMap

파라미터:

fromKey - 반환되는 맵내의 키의 하단점

inclusive - 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true

반환값:

fromKey 보다 큰 키 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰

예외:

ClassCastException - fromKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,fromKey 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

IllegalArgumentException - 이 맵 자체가 제한된 범위를 가지고 있어fromKey 가 그 범위의 경계의 외측에 있는 경우

subMap

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

인터페이스 NavigableMap 의 기술:

맵의 fromKey (이것을 포함한다) ~ toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰를 돌려줍니다. fromKey 와 toKey 가 동일한 경우는, 빈 상태(empty)의 맵이 돌려주어집니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

subMap(fromKey, true, toKey, false) 와 등가입니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 subMap

정의:

인터페이스 SortedMap <K ,V > 내의 subMap

파라미터:

fromKey - 반환되는 맵내의 키의 하단점 (이것을 포함한다)

toKey - 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)

반환값:

맵의 fromKey (이것을 포함한다) ~ toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰

예외:

ClassCastException - 이 맵의 Comparator를 사용해 (이 맵이 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromKey 와 toKey 와의 상호 비교를 실시할 수 없는 경우. 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 또는 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromKey 또는 toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

IllegalArgumentException - fromKey 가 toKey 보다 큰 경우, 또는 이 맵 자체가 제한된 범위를 가지고 있어fromKey 또는 toKey 가 그 범위의 경계의 외측에 있는 경우

headMap

ConcurrentNavigableMap <K ,V > headMap(K  toKey)

인터페이스 NavigableMap 의 기술:

맵의 toKey 보다 작은 키를 가지는 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

headMap(toKey, false) 와 등가입니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 headMap

정의:

인터페이스 SortedMap <K ,V > 내의 headMap

파라미터:

toKey - 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)

반환값:

맵의 toKey 보다 작은 키를 가지는 부분의 뷰

예외:

ClassCastException - toKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,toKey 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

IllegalArgumentException - 이 맵 자체가 제한된 범위를 가지고 있어toKey 가 그 범위의 경계의 외측에 있는 경우

tailMap

ConcurrentNavigableMap <K ,V > tailMap(K  fromKey)

인터페이스 NavigableMap 의 기술:

맵의 fromKey 이상의 키를 가지는 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

tailMap(fromKey, true) 와 등가입니다.

정의:

인터페이스 NavigableMap <K ,V > 내의 tailMap

정의:

인터페이스 SortedMap <K ,V > 내의 tailMap

파라미터:

fromKey - 반환되는 맵내의 키의 하단점 (이것을 포함한다)

반환값:

맵의 fromKey 이상의 키를 가지는 부분의 뷰

예외:

ClassCastException - fromKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,fromKey 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

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 뷰를 돌려줍니다. 세트의 반복자는, 키를 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. add 또는 addAll 오퍼레이션은 지원되고 있지 않습니다.

뷰의 iterator 는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException 를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).

정의:

인터페이스 NavigableMap <K ,V > 내의 navigableKeySet

반환값:

이 맵내의 키의 안내 가능한 셋트뷰

keySet

NavigableSet <K > keySet()

이 맵에 포함되는 키 NavigableSet 뷰를 돌려줍니다. 세트의 반복자는, 키를 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. add 또는 addAll 오퍼레이션은 지원되고 있지 않습니다.

뷰의 iterator 는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException 를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).

이 메소드는,navigableKeySet 와 동등합니다.

정의:

인터페이스 Map <K ,V > 내의 keySet

정의:

인터페이스 SortedMap <K ,V > 내의 keySet

반환값:

이 맵내의 키의 안내 가능한 셋트뷰

descendingKeySet

NavigableSet <K > descendingKeySet()

이 맵에 포함되는 키의 역순서 NavigableSet 뷰를 돌려줍니다. 세트의 반복자는, 키를 내림차순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. add 또는 addAll 오퍼레이션은 지원되고 있지 않습니다.

뷰의 iterator 는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException 를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).

정의:

인터페이스 NavigableMap <K ,V > 내의 descendingKeySet

반환값:

이 맵내의 키의 역순서의 안내 가능한 셋트뷰