所有类
|
摘要: 嵌套 | 字段 | 构造方法 | 方法 |
详细信息: 字段 | 构造方法 | 方法 |
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
从接口 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
- 与指定键相关联的值。
-
返回:
-
以前与指定键相关联的值,如果该键没有映射关系,则返回 null。如果该实现支持 null 值,则返回 null 还可以指示此映射以前曾将 null 与指定键相关联。
-
抛出:
-
UnsupportedOperationException
- 如果此映射不支持 put 操作。
-
ClassCastException
- 如果指定键或值的类不允许将其存储在此映射中。
-
IllegalArgumentException
- 如果此键或值的某些方面不允许将其存储在此映射中。
-
NullPointerException
- 如果此映射不允许 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。
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
- 与指定键相关联的值。
-
返回:
-
如果该值被替换,则返回 ture
-
抛出:
-
UnsupportedOperationException
- 如果此映射不支持 put 操作。
-
NullPointerException
- 如果此映射不允许使用 null 键或值,并且指定的键或值为 null。
replace
V replace(K key,
V value)
-
只有目前将键的条目映射到某一值时,才替换该键的条目。操作如下:
if ((map.containsKey(key)) {
return map.put(key, value);
} else return null;
除了原子地执行此操作之外。
-
-
-
参数:
-
key
- 与指定值相关联的键。
-
value
- 与指定键相关联的值。
-
返回:
-
以前与指定键相关联的值,如果该键没有映射关系,则返回 null。如果该实现支持 null 值,则返回 null 还可以指示此映射以前曾将 null 与指定键相关联。
-
抛出:
-
UnsupportedOperationException
- 如果此映射不支持 put 操作。
-
NullPointerException
- 如果此映射不允许 null 键或值,并且指定的键或值为 null。
所有类
|
摘要: 嵌套 | 字段 | 构造方法 | 方法 |
详细信息: 字段 | 构造方法 | 方法 |