|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
K - the type of keys maintained by this mapV - the type of mapped valuespublic interface ConcurrentMap<K,V>
A Map providing additional atomic
putIfAbsent, remove, and replace methods.
This interface is a member of the Java Collections Framework.
| Nested Class Summary |
|---|
| Nested classes/interfaces inherited from interface java.util.Map |
|---|
Map.Entry<K,V> |
| Method Summary | |
|---|---|
V |
putIfAbsent(K key,
V value)
If the specified key is not already associated with a value, associate it with the given value. |
boolean |
remove(Object key,
Object value)
Remove entry for key only if currently mapped to given value. |
V |
replace(K key,
V value)
Replace entry for key only if currently mapped to some value. |
boolean |
replace(K key,
V oldValue,
V newValue)
Replace entry for key only if currently mapped to given value. |
| Methods inherited from interface java.util.Map |
|---|
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values |
| Method Detail |
|---|
V putIfAbsent(K key,
V value)
if (!map.containsKey(key))
return map.put(key, value);
else
return map.get(key);
Except that the action is performed atomically.
key - key with which the specified value is to be associated.value - value to be associated with the specified key.
UnsupportedOperationException - if the put operation is
not supported by this map.
ClassCastException - if the class of the specified key or value
prevents it from being stored in this map.
IllegalArgumentException - if some aspect of this key or value
prevents it from being stored in this map.
NullPointerException - if this map does not permit null
keys or values, and the specified key or value is
null.
boolean remove(Object key,
Object value)
if ((map.containsKey(key) && map.get(key).equals(value)) {
map.remove(key);
return true;
} else return false;
except that the action is performed atomically.
key - key with which the specified value is associated.value - value associated with the specified key.
UnsupportedOperationException - if the remove operation is
not supported by this map.
NullPointerException - if this map does not permit null
keys or values, and the specified key or value is
null.
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;
except that the action is performed atomically.
key - key with which the specified value is associated.oldValue - value expected to be associated with the specified key.newValue - value to be associated with the specified key.
UnsupportedOperationException - if the put operation is
not supported by this map.
NullPointerException - if this map does not permit null
keys or values, and the specified key or value is
null.
V replace(K key,
V value)
if ((map.containsKey(key)) {
return map.put(key, value);
} else return null;
except that the action is performed atomically.
key - key with which the specified value is associated.value - value to be associated with the specified key.
UnsupportedOperationException - if the put operation is
not supported by this map.
NullPointerException - if this map does not permit null
keys or values, and the specified key or value is
null.
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.