java.util.concurrent

Соедините интерфейсом с ConcurrentMap <K, V>

Введите Параметры:

K - тип ключей сохраняется этой картой

V - тип отображенных значений

Все Суперинтерфейсы:

Карта <K, V>

Все Известные Подынтерфейсы:

ConcurrentNavigableMap <K, V>

Все Известные Классы с реализацией:

ConcurrentHashMap, ConcurrentSkipListMap

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

A Map обеспечивая дополнительный атомарный putIfAbsent, remove, и методы replace.

Эффекты непротиворечивости памяти: Как с другими параллельными наборами, действиями в потоке до размещения объекта в a ConcurrentMap поскольку ключ или значение происходят - перед действиями, последующими за доступом или удалением того объекта от ConcurrentMap в другом потоке.

Этот интерфейс является элементом Платформы Наборов Java.

С тех пор:

1.5

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от интерфейса java.util. Карта

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. Карта

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 с ключом, если реализация поддерживает нулевые значения.)

Броски:

UnsupportedOperationException - если работа put не поддерживается этой картой

ClassCastException - если класс указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте

NullPointerException - если указанный ключ или значение являются нулем, и эта карта не разрешает нулевые ключи или значения

IllegalArgumentException - если некоторое свойство указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте

удалить

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, если значение было удалено

Броски:

UnsupportedOperationException - если работа remove не поддерживается этой картой

ClassCastException - если ключ или значение имеют несоответствующий тип для этой (дополнительной) карты

NullPointerException - если указанный ключ или значение являются нулем, и эта карта не разрешает нулевые ключи или оценивает (дополнительный)

замена

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 не поддерживается этой картой

ClassCastException - если класс указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте

NullPointerException - если указанный ключ или значение являются нулем, и эта карта не разрешает нулевые ключи или значения

IllegalArgumentException - если некоторое свойство указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте

замена

V replace(K key,
        V value)

Заменяет запись для ключа только если в настоящий момент отображенный на некоторое значение. Это эквивалентно

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

за исключением того, что действие выполняется атомарно.

Параметры:

key - ключ, с которым связывается указанное значение

value - значение, которое будет связано с указанным ключом

Возвраты:

предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа. (Возврат null может также указать, что карта ранее связанный null с ключом, если реализация поддерживает нулевые значения.)

Броски:

UnsupportedOperationException - если работа put не поддерживается этой картой

ClassCastException - если класс указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте

NullPointerException - если указанный ключ или значение являются нулем, и эта карта не разрешает нулевые ключи или значения

IllegalArgumentException - если некоторое свойство указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте