|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
java.lang.Objectjava.util.AbstractMap <K, V>
java.util.concurrent.ConcurrentSkipListMap<K, V>
K
- 이 맵이 보관 유지하는 키의 형태V
- 맵 되는 값의 형태public class ConcurrentSkipListMap<K, V>
측정할 수 있는 병행 ConcurrentNavigableMap
구현입니다. 맵은, 사용하는 생성자 에 응해, 그 키자연 순서부에 따라, 또는 맵 작성시에 제공되는 Comparator
에 의해 소트 됩니다.
이 클래스는,SkipLists 의 병행 변형을 구현해,containsKey,get,put,remove 의 각 오퍼레이션과 그 변형에 예상되는 평균 log(n) 시간 코스트를 제공합니다. 삽입, 삭제, 갱신, 액세스의 각 오퍼레이션은, 복수의 thread에 의해 병행해, 안전하게 실행됩니다. 반복자는 「약일관성」을 가져, 어떤 시점 또는 반복자의 작성 이후의 맵 상태를 반영하는 요소를 돌려줍니다. 이것들은 ConcurrentModificationException
를 throw 하지 않고, 다른 오퍼레이션과의 동시성 처리가 가능합니다. 승순의 키로 늘어놓을 수 있었던 뷰와 그 반복자는, 내림차순의 경우보다 고속으로 됩니다.
이 클래스내의 메소드에 의해 반환되는 모든 Map.Entry 페어와 그 뷰는, 매핑의 생성시의 snapshot를 나타냅니다. 이것은 Entry.setValue 메소드를 지원하고 있습니다. 다만, 필요로 하는 효과에 응해,put,putIfAbsent, 또는 replace 를 사용해, 관련지을 수 있었던 맵내의 매핑을 변경할 수가 있습니다.
대부분의 컬렉션과는 달라,size 메소드는 일정시간의 오퍼레이션은 아닌 것에 유의해 주세요. 이러한 맵에는 비동기라고 하는 특성이 있기 (위해)때문에, 현재의 요소수를 판정하려면 요소 전체를 횡단(traverse) 할 필요가 있습니다. 또,putAll,equals, 및 clear 의 일괄 오퍼레이션은, 원자적인 실행은 보증되고 있지 않습니다. 예를 들어,putAll 오퍼레이션과 병행해 동작하는 반복자는, 추가된 요소의 일부 밖에 표시하지 않는 것이 있습니다.
이 클래스와 그 뷰 및 반복자는,Map
및 Iterator
인터페이스의 「옵션」메소드 모든 것을 구현합니다. 다른 대부분의 동시성 처리 컬렉션과 같이, 이 클래스는 null 키 또는 값의 사용을 허가하지 않습니다. 이것은, 일부의 null 반환값은, 요소가 없는 경우와 확실히 구별할 수가 없기 때문입니다.
이 클래스는,Java Collections Framework 의 멤버입니다.
상자의 클래스의 개요 |
---|
클래스 java.util. AbstractMap 로부터 상속된 상자의 클래스/인터페이스 |
---|
AbstractMap.SimpleEntry <K ,V >, AbstractMap.SimpleImmutableEntry <K ,V > |
인터페이스 java.util. Map 로부터 상속된 상자의 클래스/인터페이스 |
---|
Map.Entry <K ,V > |
생성자 의 개요 | |
---|---|
ConcurrentSkipListMap ()
키자연 순서부에 따라 소트 된, 새로운 빈 상태(empty)의 맵을 작성합니다. |
|
ConcurrentSkipListMap (Comparator <? super K > comparator)
지정된 Comparator에 따라 소트 된, 새로운 빈 상태(empty)의 맵을 작성합니다. |
|
ConcurrentSkipListMap (Map <? extends K ,? extends V > m)
지정된 맵과 같은 매핑을 가져, 키자연 순서부에 따라 소트 된 새로운 맵을 작성합니다. |
|
ConcurrentSkipListMap (SortedMap <K ,? extends V > m)
지정된 소트 맵과 같은 매핑을 가져, 같은 순서부를 사용하는, 새로운 맵을 작성합니다. |
메소드의 개요 | |
---|---|
Map.Entry <K ,V > |
ceilingEntry (K key)
지정된 키 이상의, 최소의 키와 관련하는 키와 값의 매핑을 돌려줍니다. |
K |
ceilingKey (K key)
지정된 키와 동일한가 그것보다 큰 키 속에서 최소의 것을 돌려줍니다. |
void |
clear ()
모든 매핑을 맵으로부터 삭제합니다. |
ConcurrentSkipListMap <K ,V > |
clone ()
ConcurrentSkipListMap 의 인스턴스의 shallow 복사를 돌려줍니다. |
Comparator <? super K > |
comparator ()
이 맵내의 키를 순서 붙이고 하는데 사용하는 Comparator를 돌려줍니다. |
boolean |
containsKey (Object key)
맵이 지정된 키의 매핑을 보관 유지하는 경우에 true 를 돌려줍니다. |
boolean |
containsValue (Object value)
맵이 1 개 또는 복수의 키와 지정된 값을 매핑 하고 있는 경우에 true 를 돌려줍니다. |
NavigableSet <K > |
descendingKeySet ()
이 맵에 포함되는 키의 역순서 NavigableSet 뷰를 돌려줍니다. |
ConcurrentNavigableMap <K ,V > |
descendingMap ()
맵내에 보관 유지되고 있는 매핑의 역의순서의 뷰를 돌려줍니다. |
Set <Map.Entry <K ,V >> |
entrySet ()
이 맵에 포함되는 맵 Set 뷰를 돌려줍니다. |
boolean |
equals (Object o)
지정된 객체가 이 맵과 동일한지 어떤지를 비교합니다. |
Map.Entry <K ,V > |
firstEntry ()
맵내의 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. |
K |
firstKey ()
맵내에 현재 있는 최초 (하단)의 키를 돌려줍니다. |
Map.Entry <K ,V > |
floorEntry (K key)
지정된 키 이하의, 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. |
K |
floorKey (K key)
지정된 키와 동일한가 그것보다 작은 키 속에서 최대의 것을 돌려줍니다. |
V |
get (Object key)
지정된 키가 맵 되고 있는 값을 돌려줍니다. |
ConcurrentNavigableMap <K ,V > |
headMap (K toKey)
맵의 toKey 보다 작은 키를 가지는 부분의 뷰를 돌려줍니다. |
ConcurrentNavigableMap <K ,V > |
headMap (K toKey,
boolean inclusive)
toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. |
Map.Entry <K ,V > |
higherEntry (K key)
지정된 키보다 확실히 큰, 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. |
K |
higherKey (K key)
지정된 키보다 확실히 큰 키 속에서 최소의 것을 돌려줍니다. |
boolean |
isEmpty ()
맵이 키와 값의 매핑을 보관 유지하지 않는 경우에 true 를 돌려줍니다. |
NavigableSet <K > |
keySet ()
이 맵에 포함되는 키 NavigableSet 뷰를 돌려줍니다. |
Map.Entry <K ,V > |
lastEntry ()
맵내의 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. |
K |
lastKey ()
맵내에 현재 있는 최후 (상단)의 키를 돌려줍니다. |
Map.Entry <K ,V > |
lowerEntry (K key)
지정된 키보다 확실히 작은, 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. |
K |
lowerKey (K key)
지정된 키보다 확실히 작은 키 속에서 최대의 것을 돌려줍니다. |
NavigableSet <K > |
navigableKeySet ()
이 맵에 포함되는 키 NavigableSet 뷰를 돌려줍니다. |
Map.Entry <K ,V > |
pollFirstEntry ()
맵내의 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해, 돌려줍니다. |
Map.Entry <K ,V > |
pollLastEntry ()
맵내의 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해, 돌려줍니다. |
V |
put (K key,
V value)
지정된 값과 지정된 키를 이 맵에 관련짓습니다. |
V |
putIfAbsent (K key,
V value)
지정된 키가 아직 값과 관련지을 수 있지 않은 경우는, 지정된 값에 관련짓습니다. |
V |
remove (Object key)
지정된 키의 매핑이 있으면 맵으로부터 삭제합니다. |
boolean |
remove (Object key,
Object value)
지정된 값에 키가 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 삭제합니다. |
V |
replace (K key,
V value)
키가 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 치환합니다. |
boolean |
replace (K key,
V oldValue,
V newValue)
지정된 값에 키가 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 치환합니다. |
int |
size ()
맵내의 키치 매핑의 수를 돌려줍니다. |
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 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. |
Collection <V > |
values ()
이 맵에 포함되는 값 Collection 뷰를 돌려줍니다. |
클래스 java.util. AbstractMap 로부터 상속된 메소드 |
---|
hashCode , putAll , toString |
클래스 java.lang. Object 로부터 상속된 메소드 |
---|
finalize , getClass , notify , notifyAll , wait , wait , wait |
인터페이스 java.util. Map 로부터 상속된 메소드 |
---|
hashCode , putAll |
생성자 의 상세 |
---|
public ConcurrentSkipListMap()
public ConcurrentSkipListMap(Comparator <? super K > comparator)
comparator
- 이 맵의 순서부를 실시하기 위해서(때문에) 사용되는 Comparator.
null 의 경우, 키자연 순서부가 사용된다public ConcurrentSkipListMap(Map <? extends K ,? extends V > m)
m
- 매핑이 이 맵에 배치되는 맵
ClassCastException
- m 내의 키가 Comparable
가 아닌지, 서로 비교 가능하지 않은 경우
NullPointerException
- 지정된 맵, 또는 그 키와 값중 한쪽이 null 의 경우public ConcurrentSkipListMap(SortedMap <K ,? extends V > m)
m
- 매핑이 이 맵에 배치되어 Comparator가 이 맵의 소트에 사용되는, 소트 된 맵
NullPointerException
- 지정된 소트 맵, 또는 그 키와 값중 한쪽이 null 의 경우메소드의 상세 |
---|
public ConcurrentSkipListMap <K ,V > clone()
AbstractMap <K ,V >
내의 clone
Cloneable
public boolean containsKey(Object key)
Map <K ,V >
내의 containsKey
AbstractMap <K ,V >
내의 containsKey
key
- 맵에 있을지 어떨지가 판정되는 키
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public V get(Object key)
null
를 돌려줍니다.
즉, 맵의 순서부에 따라 key
가 k
에 동일해지는 것 같은, 키 k
로부터 값 v
에의 매핑이 이 맵에 포함되어 있는 경우, 이 메소드는 v
를 돌려줍니다. 그 이외의 경우는,null
를 돌려줍니다. 이러한 매핑이 1 개만 있습니다.
Map <K ,V >
내의 get
AbstractMap <K ,V >
내의 get
key
- 관련지을 수 있었던 값이 반환되는 키
null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public V put(K key, V value)
Map <K ,V >
내의 put
AbstractMap <K ,V >
내의 put
key
- 지정된 값을 관련지을 수 있는 키value
- 지정된 키에 관련지을 수 있는 값
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키 또는 값이 null 의 경우public V remove(Object key)
Map <K ,V >
내의 remove
AbstractMap <K ,V >
내의 remove
key
- 매핑을 삭제할 필요가 있는 키
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public boolean containsValue(Object value)
Map <K ,V >
내의 containsValue
AbstractMap <K ,V >
내의 containsValue
value
- 맵에 있을지 어떨지를 판정되는 값
NullPointerException
- 지정된 값이 null 인 경우public int size()
대부분의 컬렉션과는 달라, 이 메소드는 일정시간의 오퍼레이션은 아닌 것에 유의해 주세요. 이러한 맵에는 비동기라고 하는 특성이 있기 (위해)때문에, 현재의 요소수를 판정하려면 요소 모든 것을 횡단(traverse) 해 카운트 할 필요가 있습니다. 또, 이 메소드의 실행중으로 사이즈가 변경될 가능성도 있어, 그 경우, 반환되는 값은 부정확하게 됩니다. 그 때문에, 이 메소드는, 일반적으로은 동시성 처리 어플리케이션에서는 별로 편리하지는 않습니다.
Map <K ,V >
내의 size
AbstractMap <K ,V >
내의 size
public boolean isEmpty()
Map <K ,V >
내의 isEmpty
AbstractMap <K ,V >
내의 isEmpty
public void clear()
Map <K ,V >
내의 clear
AbstractMap <K ,V >
내의 clear
public NavigableSet <K > keySet()
NavigableSet
뷰를 돌려줍니다. 세트의 반복자는, 키를 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove
,Set.remove
,removeAll
,retainAll
, 및 clear
의 각 오퍼레이션을 통해 실시합니다. add
또는 addAll
오퍼레이션은 지원되고 있지 않습니다.
뷰의 iterator
는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException
를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).
이 메소드는,navigableKeySet
와 동등합니다.
ConcurrentNavigableMap <K ,V >
내의 keySet
Map <K ,V >
내의 keySet
SortedMap <K ,V >
내의 keySet
AbstractMap <K ,V >
내의 keySet
public NavigableSet <K > navigableKeySet()
ConcurrentNavigableMap
의 기술:NavigableSet
뷰를 돌려줍니다. 세트의 반복자는, 키를 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove
,Set.remove
,removeAll
,retainAll
, 및 clear
의 각 오퍼레이션을 통해 실시합니다. add
또는 addAll
오퍼레이션은 지원되고 있지 않습니다.
뷰의 iterator
는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException
를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).
ConcurrentNavigableMap <K ,V >
내의 navigableKeySet
NavigableMap <K ,V >
내의 navigableKeySet
public Collection <V > values()
Collection
뷰를 돌려줍니다. 컬렉션의 반복자는, 값을 대응하는 키의 승순으로 돌려줍니다. 컬렉션은 맵과 연동하고 있으므로, 맵에 대한 변경은 컬렉션에 반영되어 또 컬렉션에 대한 변경은 맵에 반영됩니다. 컬렉션은 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수 있습니다. 삭제는,Iterator.remove,Collection.remove,removeAll,retainAll, 및 clear 오퍼레이션을 통해 실시합니다. Set 는,add 오퍼레이션이나 addAll 오퍼레이션은 지원하고 있습니다.
뷰의 Iterator 는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException
를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).
Map <K ,V >
내의 values
SortedMap <K ,V >
내의 values
AbstractMap <K ,V >
내의 values
public Set <Map.Entry <K ,V >> entrySet()
Set
뷰를 돌려줍니다. 세트의 반복자는, 엔트리를 키의 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. Set 는,add 오퍼레이션이나 addAll 오퍼레이션은 지원하고 있습니다.
뷰의 Iterator 는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException
를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).
iterator.next() 에 의해 반환되는 Map.Entry 요소는,setValue 오퍼레이션을 지원하지 않습니다.
Map <K ,V >
내의 entrySet
SortedMap <K ,V >
내의 entrySet
AbstractMap <K ,V >
내의 entrySet
public ConcurrentNavigableMap <K ,V > descendingMap()
ConcurrentNavigableMap
의 기술:반환되는 맵의 순서는,Collections.reverseOrder
(comparator()) 와 같습니다. 식 m.descendingMap(). descendingMap()
는, 본질적으로는 m
와 같은 m
의 뷰를 돌려줍니다.
ConcurrentNavigableMap <K ,V >
내의 descendingMap
NavigableMap <K ,V >
내의 descendingMap
public NavigableSet <K > descendingKeySet()
ConcurrentNavigableMap
의 기술:NavigableSet
뷰를 돌려줍니다. 세트의 반복자는, 키를 내림차순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove
,Set.remove
,removeAll
,retainAll
, 및 clear
의 각 오퍼레이션을 통해 실시합니다. add
또는 addAll
오퍼레이션은 지원되고 있지 않습니다.
뷰의 iterator
는 「약일관성」을 가지는 반복자이며,ConcurrentModificationException
를 throw 할 것은 없고, 반복자의 구축시에 존재한 요소를 횡단(traverse) 하는 것을 보증합니다. 또, 구축 후의 모든 변경을 반영합니다 (다만 보증되지는 않았다).
ConcurrentNavigableMap <K ,V >
내의 descendingKeySet
NavigableMap <K ,V >
내의 descendingKeySet
public boolean equals(Object o)
Map <K ,V >
내의 equals
AbstractMap <K ,V >
내의 equals
o
- 이 맵과 동일한지 어떤지를 비교하는 객체
Object.hashCode()
,
Hashtable
public V putIfAbsent(K key, V value)
if (! map.containsKey(key)) return map.put(key, value); else return map.get(key);다만, 액션이 원자적으로 실행되는 점이 다릅니다.
ConcurrentMap <K ,V >
내의 putIfAbsent
key
- 지정된 값을 관련지을 수 있는 키value
- 지정된 키에 관련지을 수 있는 값
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키 또는 값이 null 의 경우public boolean remove(Object key, Object value)
if (map.containsKey(key) && map.get(key). equals(value)) { map.remove(key); return true; } else return false;다만, 액션이 원자적으로 실행되는 점이 다릅니다.
ConcurrentMap <K ,V >
내의 remove
key
- 지정된 값을 관련지을 수 있는 키value
- 지정된 키에 관련지을 수 있고 있다고 예상되는 값
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public boolean replace(K key, V oldValue, V newValue)
if (map.containsKey(key) && map.get(key). equals(oldValue)) { map.put(key, newValue); return true; } else return false;다만, 액션이 원자적으로 실행되는 점이 다릅니다.
ConcurrentMap <K ,V >
내의 replace
key
- 지정된 값을 관련지을 수 있는 키oldValue
- 지정된 키에 관련지을 수 있고 있다고 예상되는 값newValue
- 지정된 키에 관련지을 수 있는 값
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 인수가 1 개에서도 null 의 경우public V replace(K key, V value)
if (map.containsKey(key)) { return map.put(key, value); } else return null;다만, 액션이 원자적으로 실행되는 점이 다릅니다.
ConcurrentMap <K ,V >
내의 replace
key
- 지정된 값을 관련지을 수 있는 키value
- 지정된 키에 관련지을 수 있는 값
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키 또는 값이 null 의 경우public Comparator <? super K > comparator()
SortedMap
의 기술:
SortedMap <K ,V >
내의 comparator
public K firstKey()
SortedMap
의 기술:
SortedMap <K ,V >
내의 firstKey
NoSuchElementException
- 맵이 빈 상태(empty)의 경우public K lastKey()
SortedMap
의 기술:
SortedMap <K ,V >
내의 lastKey
NoSuchElementException
- 맵이 빈 상태(empty)의 경우public ConcurrentNavigableMap <K ,V > subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
NavigableMap
의 기술:fromKey
~ toKey
의 키 범위를 가지는 부분의 뷰를 돌려줍니다. fromKey
와 toKey
가 동일한 경우, 반환되는 맵은 비웁니다. 다만,fromExclusive
와 toExclusive
가 어느쪽이나 true 의 경우는 제외합니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.
반환되는 맵은, 그 범위외의 키가 삽입되려고 하거나 단 점중 한쪽이 그 범위외에 있는 것 같은 서브 맵이 구축되려고 하거나 하면(자),IllegalArgumentException
를 throw 합니다.
ConcurrentNavigableMap <K ,V >
내의 subMap
NavigableMap <K ,V >
내의 subMap
fromKey
- 반환되는 맵내의 키의 하단점fromInclusive
- 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true
toKey
- 반환되는 맵내의 키의 상단점toInclusive
- 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true
fromKey
~ toKey
의 키 범위를 가지는 부분의 뷰
ClassCastException
- 이 맵의 Comparator를 사용해 (이 맵이 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromKey
와 toKey
와의 상호 비교를 실시할 수 없는 경우. 구현은, 맵내에 현재 존재하고 있는 키와 fromKey
또는 toKey
를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- fromKey
또는 toKey
가 null 의 경우
IllegalArgumentException
- fromKey
가 toKey
보다 큰 경우, 또는 이 맵 자체가 제한된 범위를 가지고 있어fromKey
또는 toKey
가 그 범위의 경계의 외측에 있는 경우public ConcurrentNavigableMap <K ,V > headMap(K toKey, boolean inclusive)
NavigableMap
의 기술:toKey
보다 작은 키 (inclusive
가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.
반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException
를 throw 합니다.
ConcurrentNavigableMap <K ,V >
내의 headMap
NavigableMap <K ,V >
내의 headMap
toKey
- 반환되는 맵내의 키의 상단점inclusive
- 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true
toKey
보다 작은 키 (inclusive
가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰
ClassCastException
- toKey
가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,toKey
가 Comparable
를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 toKey
를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- toKey
가 null 의 경우
IllegalArgumentException
- 이 맵 자체가 제한된 범위를 가지고 있어toKey
가 그 범위의 경계의 외측에 있는 경우public ConcurrentNavigableMap <K ,V > tailMap(K fromKey, boolean inclusive)
NavigableMap
의 기술:fromKey
보다 큰 키 (inclusive
가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다. 반환되는 맵은 이 맵에 연동하고 있어, 반환되는 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 반환되는 맵은, 이 맵이 지원하는 옵션의 맵 오퍼레이션을 모두 지원합니다.
반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException
를 throw 합니다.
ConcurrentNavigableMap <K ,V >
내의 tailMap
NavigableMap <K ,V >
내의 tailMap
fromKey
- 반환되는 맵내의 키의 하단점inclusive
- 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true
fromKey
보다 큰 키 (inclusive
가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰
ClassCastException
- fromKey
가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,fromKey
가 Comparable
를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 fromKey
를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- fromKey
가 null 의 경우
IllegalArgumentException
- 이 맵 자체가 제한된 범위를 가지고 있어fromKey
가 그 범위의 경계의 외측에 있는 경우public ConcurrentNavigableMap <K ,V > subMap(K fromKey, K toKey)
NavigableMap
의 기술:반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.
subMap(fromKey, true, toKey, false)
와 등가입니다.
ConcurrentNavigableMap <K ,V >
내의 subMap
NavigableMap <K ,V >
내의 subMap
SortedMap <K ,V >
내의 subMap
fromKey
- 반환되는 맵내의 키의 하단점 (이것을 포함한다)toKey
- 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)
ClassCastException
- 이 맵의 Comparator를 사용해 (이 맵이 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromKey 와 toKey 와의 상호 비교를 실시할 수 없는 경우. 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 또는 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- fromKey
또는 toKey
가 null 의 경우
IllegalArgumentException
- fromKey 가 toKey 보다 큰 경우, 또는 이 맵 자체가 제한된 범위를 가지고 있어fromKey 또는 toKey 가 그 범위의 경계의 외측에 있는 경우public ConcurrentNavigableMap <K ,V > headMap(K toKey)
NavigableMap
의 기술:반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.
headMap(toKey, false)
와 등가입니다.
ConcurrentNavigableMap <K ,V >
내의 headMap
NavigableMap <K ,V >
내의 headMap
SortedMap <K ,V >
내의 headMap
toKey
- 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)
ClassCastException
- toKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,toKey 가 Comparable
를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 toKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- toKey
가 null 의 경우
IllegalArgumentException
- 이 맵 자체가 제한된 범위를 가지고 있어toKey 가 그 범위의 경계의 외측에 있는 경우public ConcurrentNavigableMap <K ,V > tailMap(K fromKey)
NavigableMap
의 기술:반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.
tailMap(fromKey, true)
와 등가입니다.
ConcurrentNavigableMap <K ,V >
내의 tailMap
NavigableMap <K ,V >
내의 tailMap
SortedMap <K ,V >
내의 tailMap
fromKey
- 반환되는 맵내의 키의 하단점 (이것을 포함한다)
ClassCastException
- fromKey 가 이 맵의 Comparator와 호환성이 없는 경우 (또는, 이 맵이 Comparator를 가지지 않는 경우,fromKey 가 Comparable
를 구현하고 있지 않는 경우). 구현은, 맵내에 현재 존재하고 있는 키와 fromKey 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다
NullPointerException
- fromKey
가 null 의 경우
IllegalArgumentException
- 이 맵 자체가 제한된 범위를 가지고 있어fromKey 가 그 범위의 경계의 외측에 있는 경우public Map.Entry <K ,V > lowerEntry(K key)
NavigableMap <K ,V >
내의 lowerEntry
key
- 키
key
보다 작은 키 속에서 최대의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public K lowerKey(K key)
NavigableMap
의 기술:null
를 돌려줍니다.
NavigableMap <K ,V >
내의 lowerKey
key
- 키
key
보다 작은 키 속에서 최대의 것. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public Map.Entry <K ,V > floorEntry(K key)
NavigableMap <K ,V >
내의 floorEntry
key
- 키
key
와 동일한가 그것보다 작은 키 속에서 최대의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public K floorKey(K key)
NavigableMap
의 기술:null
를 돌려줍니다.
NavigableMap <K ,V >
내의 floorKey
key
- 키
key
와 동일한가 그것보다 작은 키 속에서 최대의 것. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public Map.Entry <K ,V > ceilingEntry(K key)
NavigableMap <K ,V >
내의 ceilingEntry
key
- 키
key
와 동일한가 그것보다 큰 키 속에서 최소의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public K ceilingKey(K key)
NavigableMap
의 기술:null
를 돌려줍니다.
NavigableMap <K ,V >
내의 ceilingKey
key
- 키
key
와 동일한가 그것보다 큰 키 속에서 최소의 것. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public Map.Entry <K ,V > higherEntry(K key)
NavigableMap <K ,V >
내의 higherEntry
key
- 키
key
보다 큰 키 속에서 최소의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public K higherKey(K key)
NavigableMap
의 기술:null
를 돌려줍니다.
NavigableMap <K ,V >
내의 higherKey
key
- 키
key
보다 큰 키 속에서 최소의 것. 그러한 키가 존재하지 않는 경우는 null
ClassCastException
- 지정된 키가 맵내에 현재 있는 키와 비교할 수 없는 경우
NullPointerException
- 지정된 키가 null 인 경우public Map.Entry <K ,V > firstEntry()
NavigableMap <K ,V >
내의 firstEntry
null
public Map.Entry <K ,V > lastEntry()
NavigableMap <K ,V >
내의 lastEntry
null
public Map.Entry <K ,V > pollFirstEntry()
NavigableMap <K ,V >
내의 pollFirstEntry
null
public Map.Entry <K ,V > pollLastEntry()
NavigableMap <K ,V >
내의 pollLastEntry
null
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.