ConcurrentHashMap (Платформа Java SE 8 b92)

java.lang. Объект
- java.util. AbstractMap<K, V>
- - java.util.concurrent.ConcurrentHashMap<K,V>

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

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

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

Все Реализованные Интерфейсы:

Сериализуемый, ConcurrentMap <K, V>, Карта <K, V>
```
public class ConcurrentHashMap<K,V>
extends AbstractMap<K,V>
implements ConcurrentMap<K,V>, Serializable
```
Хэш-таблица, поддерживающая полный параллелизм извлечений и корректируемый ожидаемый параллелизм для обновлений. Этот class повинуется той же самой функциональной спецификации как Hashtable, и включает версии методов, соответствующих каждому методу Hashtable. Однако, даже при том, что все операции ориентированы на многопотоковое исполнение, операции извлечения не влекут за собой блокировку, и нет никакой поддержки блокировки всей таблицы в пути, который предотвращает весь доступ. Этот class является полностью взаимодействующим с Hashtable в программах, которые полагаются на его потокобезопасность, но не на его деталях синхронизации.
Операции извлечения (включая get) обычно не блокируют, так может наложиться с операциями обновления (включая put и remove). Извлечения отражают результаты последний раз завершенного содержания операций обновления на их начало. Для совокупных операций, таких как putAll и clear, параллельные извлечения могут отразить вставку или удаление только некоторых записей. Точно так же Iterators и Перечисления возвращают элементы, отражающие состояние хэш-таблицы в некоторый момент в или начиная с создания iterator/enumeration. Они не бросают ConcurrentModificationException. Однако, iterators разрабатываются, чтобы использоваться только одним потоком за один раз.
Позволенный параллелизм среди операций обновления ведется дополнительным параметром конструктора concurrencyLevel (значение по умолчанию 16), который используется в качестве подсказки для внутренней калибровки. Таблица внутренне делится, чтобы попытаться разрешить обозначенное число параллельных обновлений без конкуренции. Поскольку размещение в хэш-таблицах чрезвычайно случайно, фактический параллелизм изменится. Идеально, следует выбрать значение, чтобы разместить так много потоков, как будет когда-либо одновременно изменять таблицу. Используя значительно более высокое значение чем Вы нуждаются, может потратить впустую пространство и время, и значительно нижнее значение может вести, чтобы распараллелить конкуренцию. Но переоценки и недооценки в пределах порядка величины обычно не оказывают много значимого влияния. Значение каждый является соответствующим, когда известно, что только один поток изменит, и все другие будут только читать. Кроме того, изменение размеров этого или любого другого вида хэш-таблицы является относительно медленной работой, таким образом, когда возможный, это - хорошая идея обеспечить оценки ожидаемых табличных размеров в конструкторах.
Этот class и его представления и iterators реализуют все дополнительные методы Map и Iterator интерфейсы.
Как Hashtable но в отличие от этого HashMap, этот class не позволяет null использоваться в качестве ключа или значения.
Этот class является элементом Платформы Наборов Java.

С тех пор:

1.5

См. Также:

Сериализированная Форма

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от class java.util. AbstractMap
  AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
- Вложенные классы/интерфейсы, наследованные от интерфейса java.util. Карта
  Map.Entry<K,V>

Сводка конструктора

Конструкторы
Конструктор и Описание
`ConcurrentHashMap()` Создает новую, пустую карту с емкостью начальной буквы значения по умолчанию (16), коэффициент загрузки (0.75) и concurrencyLevel (16).
`ConcurrentHashMap(int initialCapacity)` Создает новую, пустую карту с указанной начальной емкостью, и с коэффициентом загрузки значения по умолчанию (0.75) и concurrencyLevel (16).
`ConcurrentHashMap(int initialCapacity, float loadFactor)` Создает новую, пустую карту с указанной начальной емкостью и коэффициентом загрузки и со значением по умолчанию concurrencyLevel (16).
`ConcurrentHashMap(int initialCapacity, float loadFactor, int concurrencyLevel)` Создает новую, пустую карту с указанной начальной емкостью, коэффициентом загрузки и уровнем параллелизма.
`ConcurrentHashMap(Map<? extends K,? extends V> m)` Создает новую карту с теми же самыми отображениями как данная карта.

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

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`clear()` Удаляет все отображения из этой карты.
`boolean`	`contains(Object value)` Тестирование метода наследства, если некоторые контурные карты в указанное значение в этой таблице.
`boolean`	`containsKey(Object key)` Тесты, если указанный объект является ключом в этой таблице.
`boolean`	`containsValue(Object value)` `true` возвратов, если эта карта отображает один или более ключей на указанное значение.
`Enumeration<V>`	`elements()` Возвращает перечисление значений в этой таблице.
`Set<Map.Entry<K,V>>`	`entrySet()` Возвраты a `Set` представление отображений содержится в этой карте.
`V`	`get(Object key)` Возвращает значение, на которое указанный ключ отображается, или `null` если эта карта не содержит отображения для ключа.
`boolean`	`isEmpty()` `true` возвратов, если эта карта не содержит отображений значения ключа.
`Enumeration<K>`	`keys()` Возвращает перечисление ключей в этой таблице.
`Set<K>`	`keySet()` Возвраты a `Set` представление ключей содержится в этой карте.
`V`	`put(K key, V value)` Отображает указанный ключ на указанное значение в этой таблице.
`void`	`putAll(Map<? extends K,? extends V> m)` Копии все отображения от указанной карты до этого.
`V`	`putIfAbsent(K key, V value)` Если указанный ключ уже не связывается со значением, свяжите его с данным значением.
`V`	`remove(Object key)` Удаляет ключ (и его соответствующее значение) из этой карты.
`boolean`	`remove(Object key, Object value)` Удаляет запись для ключа только если в настоящий момент отображенный на данное значение.
`V`	`replace(K key, V value)` Заменяет запись для ключа только если в настоящий момент отображенный на некоторое значение.
`boolean`	`replace(K key, V oldValue, V newValue)` Заменяет запись для ключа только если в настоящий момент отображенный на данное значение.
`int`	`size()` Возвращает число отображений значения ключа в этой карте.
`Collection<V>`	`values()` Возвраты a `Collection` представление значений содержится в этой карте.

Методы, наследованные от class java.util. AbstractMap
clone, equals, hashCode, toString

Методы, наследованные от class java.lang. Объект
finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.util.concurrent. ConcurrentMap
getOrDefault

Методы, наследованные от интерфейса java.util. Карта
compute, computeIfAbsent, computeIfPresent, equals, forEach, hashCode, merge, replaceAll

- Деталь конструктора
  - ConcurrentHashMap
```
public ConcurrentHashMap(int initialCapacity,
                         float loadFactor,
                         int concurrencyLevel)
```
    Создает новую, пустую карту с указанной начальной емкостью, коэффициентом загрузки и уровнем параллелизма.
    
    Параметры:
    
    initialCapacity - начальная емкость. Реализация выполняет внутреннюю калибровку, чтобы разместить это много элементов.
    
    loadFactor - порог коэффициента загрузки, используемый, чтобы управлять изменением размеров. Изменение размеров может быть выполнено, когда среднее число элементов на мусорное ведро превышает этот порог.
    
    concurrencyLevel - предполагаемое число параллельного обновления потоков. Реализация выполняет внутреннюю калибровку, чтобы попытаться разместить это много потоков.
    
    Броски:
    
    IllegalArgumentException - если начальная емкость отрицательна или коэффициент загрузки, или concurrencyLevel неположительны.
  - ConcurrentHashMap
```
public ConcurrentHashMap(int initialCapacity,
                         float loadFactor)
```
    Создает новую, пустую карту с указанной начальной емкостью и коэффициентом загрузки и со значением по умолчанию concurrencyLevel (16).
    
    Параметры:
    
    initialCapacity - Реализация выполняет внутреннюю калибровку, чтобы разместить это много элементов.
    
    loadFactor - порог коэффициента загрузки, используемый, чтобы управлять изменением размеров. Изменение размеров может быть выполнено, когда среднее число элементов на мусорное ведро превышает этот порог.
    
    Броски:
    
    IllegalArgumentException - если начальная емкость элементов отрицательна, или коэффициент загрузки неположителен
    
    С тех пор:
    
    1.6
  - ConcurrentHashMap
```
public ConcurrentHashMap(int initialCapacity)
```
    Создает новую, пустую карту с указанной начальной емкостью, и с коэффициентом загрузки значения по умолчанию (0.75) и concurrencyLevel (16).
    
    Параметры:
    
    initialCapacity - начальная емкость. Реализация выполняет внутреннюю калибровку, чтобы разместить это много элементов.
    
    Броски:
    
    IllegalArgumentException - если начальная емкость элементов отрицательна.
  - ConcurrentHashMap
```
public ConcurrentHashMap()
```
    Создает новую, пустую карту с емкостью начальной буквы значения по умолчанию (16), коэффициент загрузки (0.75) и concurrencyLevel (16).
  - ConcurrentHashMap
```
public ConcurrentHashMap(Map<? extends K,? extends V> m)
```
    Создает новую карту с теми же самыми отображениями как данная карта. Карта создается с емкостью 1.5 раза числа отображений в данной карте или 16 (какой бы ни больше), и коэффициент загрузки значения по умолчанию (0.75) и concurrencyLevel (16).
    
    Параметры:
    
    m - карта
- Деталь метода
  - isEmpty
```
public boolean isEmpty()
```
    true возвратов, если эта карта не содержит отображений значения ключа.
    
    Определенный:
    
    isEmpty в интерфейсе Map<K,V>
    
    Переопределения:
    
    isEmpty в class AbstractMap<K,V>
    
    Возвраты:
    
    true, если эта карта не содержит отображений значения ключа
  - размер
```
public int size()
```
    Возвращает число отображений значения ключа в этой карте. Если карта содержит больше чем элементы Integer.MAX_VALUE, Integer.MAX_VALUE возвратов.
    
    Определенный:
    
    size в интерфейсе Map<K,V>
    
    Переопределения:
    
    size в class AbstractMap<K,V>
    
    Возвраты:
    
    число отображений значения ключа в этой карте
  - добраться
```
public V get(Object key)
```
    Возвращает значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа.
    Более формально, если эта карта содержит отображение от ключа k к значению v так, что key.equals(k), тогда этот метод возвраты v; иначе это возвращается null. (Может быть самое большее одно такое отображение.)
    
    Определенный:
    
    get в интерфейсе Map<K,V>
    
    Переопределения:
    
    get в class AbstractMap<K,V>
    
    Параметры:
    
    key - ключ, присваиваемое значение которого должно быть возвращено
    
    Возвраты:
    
    значение, на которое указанный ключ отображается, или null если эта карта не содержит отображения для ключа
    
    Броски:
    
    NullPointerException - если указанный ключ является нулем
  - containsKey
```
public boolean containsKey(Object key)
```
    Тесты, если указанный объект является ключом в этой таблице.
    
    Определенный:
    
    containsKey в интерфейсе Map<K,V>
    
    Переопределения:
    
    containsKey в class AbstractMap<K,V>
    
    Параметры:
    
    key - возможный ключ
    
    Возвраты:
    
    true, если и только если указанный объект является ключом в этой таблице, как определено методом equals; false иначе.
    
    Броски:
    
    NullPointerException - если указанный ключ является нулем
  - containsValue
```
public boolean containsValue(Object value)
```
    true возвратов, если эта карта отображает один или более ключей на указанное значение. Отметьте: Этот метод требует полного внутреннего обхода хэш-таблицы, и так намного медленнее чем метод containsKey.
    
    Определенный:
    
    containsValue в интерфейсе Map<K,V>
    
    Переопределения:
    
    containsValue в class AbstractMap<K,V>
    
    Параметры:
    
    value - оцените, чье присутствие в этой карте должно быть протестировано
    
    Возвраты:
    
    true, если эта карта отображает один или более ключей на указанное значение
    
    Броски:
    
    NullPointerException - если указанное значение является нулем
  - содержит
```
public boolean contains(Object value)
```
    Тестирование метода наследства, если некоторые контурные карты в указанное значение в этой таблице. Этот метод идентичен в функциональности containsValue(java.lang.Object), и существует исключительно, чтобы гарантировать полную совместимость class Hashtable, который поддерживал этот метод до введения платформы Наборов Java.
    
    Параметры:
    
    value - значение, чтобы искать
    
    Возвраты:
    
    true, если и только если некоторые контурные карты к параметру value в этой таблице как определено методом equals; false иначе
    
    Броски:
    
    NullPointerException - если указанное значение является нулем
  - поместить
```
public V put(K key,
             V value)
```
    Отображает указанный ключ на указанное значение в этой таблице. Ни ключ, ни значение не могут быть нулем.
    Значение может быть получено, вызывая метод get с ключом, который равен исходному ключу.
    
    Определенный:
    
    put в интерфейсе Map<K,V>
    
    Переопределения:
    
    put в class AbstractMap<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    value - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    предыдущее значение, связанное с key, или null, если не было никакого отображения для key
    
    Броски:
    
    NullPointerException - если указанный ключ или значение являются нулем
  - putIfAbsent
```
public V putIfAbsent(K key,
                     V value)
```
    Если указанный ключ уже не связывается со значением, свяжите его с данным значением. Это эквивалентно
```
 
 if (!map.containsKey(key))
   return map.put(key, value);
 else
   return map.get(key);
```
    за исключением того, что действие выполняется атомарно.
    Определенный:
    
    putIfAbsent в интерфейсе ConcurrentMap<K,V>
    
    Определенный:
    
    putIfAbsent в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым должно быть связано указанное значение
    
    value - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа
    
    Броски:
    
    NullPointerException - если указанный ключ или значение являются нулем
  - putAll
```
public void putAll(Map<? extends K,? extends V> m)
```
    Копии все отображения от указанной карты до этого. Эти отображения заменяют любые отображения, которые эта карта имела для любого из ключей в настоящий момент в указанной карте.
    
    Определенный:
    
    putAll в интерфейсе Map<K,V>
    
    Переопределения:
    
    putAll в class AbstractMap<K,V>
    
    Параметры:
    
    m - отображения, которые будут сохранены в этой карте
  - удалить
```
public V remove(Object key)
```
    Удаляет ключ (и его соответствующее значение) из этой карты. Этот метод ничего не делает, если ключ не находится в карте.
    
    Определенный:
    
    remove в интерфейсе Map<K,V>
    
    Переопределения:
    
    remove в class AbstractMap<K,V>
    
    Параметры:
    
    key - ключ, который должен быть удален
    
    Возвраты:
    
    предыдущее значение, связанное с key, или null, если не было никакого отображения для key
    
    Броски:
    
    NullPointerException - если указанный ключ является нулем
  - удалить
```
public 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 в интерфейсе ConcurrentMap<K,V>
    
    Определенный:
    
    remove в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    value - значение, которое, как ожидают, будет связано с указанным ключом
    
    Возвраты:
    
    true если значение было удалено
    
    Броски:
    
    NullPointerException - если указанный ключ является нулем
  - замена
```
public 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 в интерфейсе ConcurrentMap<K,V>
    
    Определенный:
    
    replace в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    oldValue - значение, которое, как ожидают, будет связано с указанным ключом
    
    newValue - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    true если значение было заменено
    
    Броски:
    
    NullPointerException - если каким-либо из параметров является нуль
  - замена
```
public V replace(K key,
                 V value)
```
    Заменяет запись для ключа только если в настоящий момент отображенный на некоторое значение. Это эквивалентно
```
 
 if (map.containsKey(key)) {
   return map.put(key, value);
 } else
   return null;
```
    за исключением того, что действие выполняется атомарно.
    Определенный:
    
    replace в интерфейсе ConcurrentMap<K,V>
    
    Определенный:
    
    replace в интерфейсе Map<K,V>
    
    Параметры:
    
    key - ключ, с которым связывается указанное значение
    
    value - значение, которое будет связано с указанным ключом
    
    Возвраты:
    
    предыдущее значение, связанное с указанным ключом, или null, если не было никакого отображения для ключа
    
    Броски:
    
    NullPointerException - если указанный ключ или значение являются нулем
  - очистить
```
public void clear()
```
    Удаляет все отображения из этой карты.
    
    Определенный:
    
    clear в интерфейсе Map<K,V>
    
    Переопределения:
    
    clear в class AbstractMap<K,V>
  - набор ключей
```
public Set<K> keySet()
```
    Возвраты a Set представление ключей содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из этой карты, через Iterator.remove, Set.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.
    iterator представления "слабо непротиворечивый" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.
    
    Определенный:
    
    keySet в интерфейсе Map<K,V>
    
    Переопределения:
    
    keySet в class AbstractMap<K,V>
    
    Возвраты:
    
    представление набора ключей содержится в этой карте
  - значения
```
public Collection<V> values()
```
    Возвраты a Collection представление значений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из этой карты, через Iterator.remove, Collection.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.
    iterator представления "слабо непротиворечивый" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.
    
    Определенный:
    
    values в интерфейсе Map<K,V>
    
    Переопределения:
    
    values в class AbstractMap<K,V>
    
    Возвраты:
    
    представление набора значений содержится в этой карте
  - entrySet
```
public Set<Map.Entry<K,V>> entrySet()
```
    Возвраты a Set представление отображений содержится в этой карте. Набор поддерживается картой, так изменения к карте отражаются в наборе, и наоборот. Набор поддерживает удаление элемента, которое удаляет соответствующее отображение из карты, через Iterator.remove, Set.remove, removeAll, retainAll, и операции clear. Это не поддерживает операции addAll или add.
    iterator представления "слабо непротиворечивый" iterator, который никогда не будет бросать ConcurrentModificationException, и гарантии, чтобы пересечь элементы, поскольку они существовали на конструкцию iterator, и может (но не гарантироваться), отражают любые модификации, последующие за конструкцией.
    
    Определенный:
    
    entrySet в интерфейсе Map<K,V>
    
    Определенный:
    
    entrySet в class AbstractMap<K,V>
    
    Возвраты:
    
    представление набора отображений содержится в этой карте
  - ключи
```
public Enumeration<K> keys()
```
    Возвращает перечисление ключей в этой таблице.
    
    Возвраты:
    
    перечисление ключей в этой таблице
    
    См. Также:
    
    keySet()
  - элементы
```
public Enumeration<V> elements()
```
    Возвращает перечисление значений в этой таблице.
    
    Возвраты:
    
    перечисление значений в этой таблице
    
    См. Также:
    
    values()

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс ConcurrentHashMap <K, V>

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

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

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

Сводка конструктора

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

Методы, наследованные от class java.util. AbstractMap

Методы, наследованные от class java.lang. Объект

Методы, наследованные от интерфейса java.util.concurrent. ConcurrentMap

Методы, наследованные от интерфейса java.util. Карта

Деталь конструктора

ConcurrentHashMap

ConcurrentHashMap

ConcurrentHashMap

ConcurrentHashMap

ConcurrentHashMap

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

isEmpty

размер

добраться

containsKey

containsValue

содержит

поместить

putIfAbsent

putAll

удалить

удалить

замена

замена

очистить

набор ключей

значения

entrySet

ключи

элементы