compact1, compact2, compact3

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>

Сводка метода

Модификатор и Тип	Метод и Описание
default V	getOrDefault(Object key, V defaultValue) Возвращает значение, на которое указанный ключ отображается, или defaultValue если эта карта не содержит отображения для ключа.
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, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, hashCode, isEmpty, keySet, merge, put, putAll, remove, replaceAll, size, values

Деталь метода

getOrDefault

default V getOrDefault(Object key,
                       V defaultValue)

Возвращает значение, на которое указанный ключ отображается, или defaultValue если эта карта не содержит отображения для ключа.

Реализация по умолчанию не делает гарантий о синхронизации или свойствах атомарности этого метода. Любая реализация, обеспечивающая гарантии атомарности, должна переопределить этот метод и задокументировать его свойства параллелизма.

Определенный:

getOrDefault в интерфейсе Map<K,V>

Примечание реализации:

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

Параметры:

key - ключ, присваиваемое значение которого должно быть возвращено

Возвраты:

значение, на которое указанный ключ отображается, или defaultValue если эта карта не содержит отображения для ключа

putIfAbsent

V putIfAbsent(K key,
              V value)

Если указанный ключ уже не связывается со значением, свяжите его с данным значением. Это эквивалентно

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

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

Определенный:

putIfAbsent в интерфейсе Map<K,V>

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

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

удалить

boolean remove(Object key,
               Object value)

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

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

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

Определенный:

remove в интерфейсе Map<K,V>

Параметры:

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

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

Возвраты:

true если значение было удалено

Броски:

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

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

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

замена

boolean replace(K key,
                V oldValue,
                V newValue)

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

 
 if (map.containsKey(key) && Objects.equals(map.get(key), oldValue)) {
   map.put(key, newValue);
   return true;
 } else
   return false;

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

Определенный:

replace в интерфейсе Map<K,V>

Параметры:

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

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

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

Возвраты:

true если значение было заменено

Броски:

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

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

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

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

замена

V replace(K key,
          V value)

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

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

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

Определенный:

replace в интерфейсе Map<K,V>

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

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