java.util.concurrent
인터페이스 ConcurrentMap<K, V>

형태 파라미터:

K - 이 맵에 의해 유지되는 키의 형태

V - 매핑 된 값의 형태

모든 슈퍼 인터페이스:

Map <K, V>

알려진 구현 클래스 목록:

ConcurrentHashMap

public interface ConcurrentMap<K, V>
extends Map <K, V>

추가의 원자적 putIfAbsent, remove, replace 메서드를 제공하는 Map .

이 인터페이스는 Java Collections Framework 멤버입니다.

도입된 버전 :

1.5

중첩(Nested) 클래스 개요

인터페이스 java.util. Map 로부터 상속된 중첩(Nested) 클래스/인터페이스

Map.Entry <K, V >

메서드 개요

V	putIfAbsent (K key, V value) 지정된 키를 값과 관련지을 수 있지 않은 경우는 지정된 값에 관련짓습니다.
boolean	remove (Object key, Object value) 키가 지정된 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 삭제합니다.
V	replace (K key, V value) 키가 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 치환합니다.
boolean	replace (K key, V oldValue, V newValue) 키가 지정된 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 치환합니다.

인터페이스 java.util. Map 로부터 상속된 메서드

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

메서드의 상세

putIfAbsent

V  putIfAbsent(K  key,
              V  value)

지정된 키를 값과 관련지을 수 있지 않은 경우는 지정된 값에 관련짓습니다. 이것은 아래와 같습니다.

   if (! map.containsKey(key)) 
      return map.put(key, value);
   else
      return map.get(key);
 

다만, 액션이 원자적으로 실행되는 점이 다릅니다.

파라미터:

key - 지정되는 값을 관련된 키

value - 지정되는 키에 관련된 값

반환값:

지정된 키에 관련한 이전의 값. key에 매핑이 없었던 경우는 null. 또한, null 반환값은 구현이 null 치를 지원 하고 있는 경우는 지정된 키에 이전 맵이 null을 관련짓고 있던 것을 나타내는 경우도 있다

예외:

UnsupportedOperationException - put 오퍼레이션이 맵에 의해 지원 되어 있지 않은 경우

ClassCastException - 지정된 키 또는 값의 클래스가 원인으로 맵에 포함할 수 없는 경우

IllegalArgumentException - 이 키 또는 값의 특성이 원인으로 맵에 포함할 수 없는 경우

NullPointerException - 맵이 null 키나 null 치를 허가하지 않을 때에 지정된 키 또는 값이 null인 경우

remove

boolean remove(Object  key,
               Object  value)

키가 지정된 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 삭제합니다. 다음과 같이 동작합니다.

 
  if ((map.containsKey(key) && map.get(key). equals(value)) {
     map.remove(key);
     return true;
 } else return false;
 

다만, 액션이 원자적으로 실행되는 점이 다릅니다.

파라미터:

key - 지정되는 값을 관련된 키

value - 지정되는 키에 관련된 값

반환값:

값이 삭제되었을 경우는 true, 그렇지 않은 경우는 false

예외:

UnsupportedOperationException - 이 맵이 remove 오퍼레이션을 지원 하지 않는 경우

NullPointerException - 맵이 null 키나 null 치를 허가하지 않을 때에 지정된 키 또는 값이 null인 경우

replace

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;
 

다만, 액션이 원자적으로 실행되는 점이 다릅니다.

파라미터:

key - 지정되는 값을 관련된 키

oldValue - 지정되는 키에 관련지을 수 있다고 예상되는 값

newValue - 지정되는 키에 관련된 값

반환값:

값이 치환되었을 경우는 true

예외:

UnsupportedOperationException - put 오퍼레이션이 맵에 의해 지원 되어 있지 않은 경우

NullPointerException - 맵이 null 키나 null 치를 허가하지 않을 때에 지정된 키 또는 값이 null인 경우

replace

V  replace(K  key,
          V  value)

키가 값에 현재 매핑 되고 있는 경우에게만, 그 키의 엔트리를 치환합니다. 다음과 같이 동작합니다.

 
  if ((map.containsKey(key)) {
     return map.put(key, value);
 } else return null;
 

다만, 액션이 원자적으로 실행되는 점이 다릅니다.

파라미터:

key - 지정되는 값을 관련된 키

value - 지정되는 키에 관련된 값

반환값:

지정된 키에 관련한 이전의 값. key에 매핑이 없었던 경우는 null. 또한, null 반환값은 구현이 null 치를 지원 하고 있는 경우는 지정된 키에 이전 맵이 null을 관련짓고 있던 것을 나타내는 경우도 있다

예외:

UnsupportedOperationException - put 오퍼레이션이 맵에 의해 지원 되어 있지 않은 경우

NullPointerException - 맵이 null 키나 null 치를 허가하지 않을 때에 지정된 키 또는 값이 null인 경우