Class ConcurrentSkipListMap<K,V>

public ConcurrentSkipListMap()

public ConcurrentSkipListMap(Comparator<? super K> comparator)

Параметры:

comparator — компаратор, который будет использоваться для упорядочивания этой карты. Если null, будет использоваться естественный порядок ключей.

public ConcurrentSkipListMap(Map<? extends K, ? extends V> m)

Параметры:

m — карта, отображения из которой следует поместить в эту карту

Исключения:

ClassCastException — если ключи в m не являются Comparable или не могут сравниваться друг с другом

NullPointerException — если указанная карта или любой из ее ключей либо значений равен null

public ConcurrentSkipListMap(SortedMap<K, ? extends V> m)

Параметры:

m — отсортированная карта, отображения из которой следует поместить в эту карту, а компаратор — использовать для сортировки этой карты

Исключения:

NullPointerException — если указанная отсортированная карта или любой из ее ключей либо значений равен null

public ConcurrentSkipListMap<K,V> clone()

Переопределяет:

clone в классе AbstractMap<K,V>

Возвращает:

поверхностную копию этой карты

См. также:

• Cloneable

public boolean containsKey(Object key)

Определен в:

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

Переопределяет:

containsKey в классе AbstractMap<K,V>

Параметры:

key — ключ, наличие которого в этой карте требуется проверить

Возвращает:

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ равен null

public V get(Object key)

Определен в:

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

Переопределяет:

get в классе AbstractMap<K,V>

Параметры:

key — ключ, значение которого требуется вернуть

Возвращает:

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ равен null

public V getOrDefault(Object key, V defaultValue)

Определен в:

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

Определен в:

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

Параметры:

key — ключ

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

Возвращает:

отображение для ключа, если оно имеется; в противном случае — defaultValue

Исключения:

NullPointerException — если указанный ключ равен null

Начиная с:

1.8

public V put(K key, V value)

Определен в:

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

Переопределяет:

put в классе AbstractMap<K,V>

Параметры:

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

value — значение, связываемое с указанным ключом

Возвращает:

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ или значение равны null

public V remove(Object key)

Определен в:

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

Переопределяет:

remove в классе AbstractMap<K,V>

Параметры:

key — ключ, отображение для которого следует удалить

Возвращает:

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ равен null

public boolean containsValue(Object value)

Определен в:

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

Переопределяет:

containsValue в классе AbstractMap<K,V>

Параметры:

value — значение, наличие которого в этой карте требуется проверить

Возвращает:

true, если существует отображение для value; в противном случае — false

Исключения:

NullPointerException — если указанное значение равно null

public int size()

Определен в:

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

Переопределяет:

size в классе AbstractMap<K,V>

Возвращает:

количество отображений «ключ—значение» в этой карте

public boolean isEmpty()

Определен в:

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

Переопределяет:

isEmpty в классе AbstractMap<K,V>

Возвращает:

true, если эта карта не содержит отображений «ключ—значение»

public void clear()

Определен в:

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

Переопределяет:

clear в классе AbstractMap<K,V>

public V computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)

Определен в:

computeIfAbsent в интерфейсе ConcurrentMap<K,V>

Определен в:

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

Параметры:

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

mappingFunction — функция для вычисления значения

Возвращает:

текущее значение (существующее или вычисленное), связанное с указанным ключом, или null, если вычисленное значение равно null

Исключения:

NullPointerException — если указанный ключ равен null или mappingFunction равна null

Начиная с:

1.8

public V computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Определен в:

computeIfPresent в интерфейсе ConcurrentMap<K,V>

Определен в:

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

Параметры:

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

remappingFunction — функция для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если такого значения нет

Исключения:

NullPointerException — если указанный ключ равен null или remappingFunction равна null

Начиная с:

1.8

public V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Определен в:

compute в интерфейсе ConcurrentMap<K,V>

Определен в:

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

Параметры:

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

remappingFunction — функция для вычисления значения

Возвращает:

новое значение, связанное с указанным ключом, или null, если такого значения нет

Исключения:

NullPointerException — если указанный ключ равен null или remappingFunction равна null

Начиная с:

1.8

public V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

Определен в:

merge в интерфейсе ConcurrentMap<K,V>

Определен в:

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

Параметры:

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

value — значение, используемое при отсутствии отображения

remappingFunction — функция для повторного вычисления значения, если оно имеется

Возвращает:

новое значение, связанное с указанным ключом, или null, если такого значения нет

Исключения:

NullPointerException — если указанный ключ или значение равны null либо remappingFunction равна null

Начиная с:

1.8

public NavigableSet<K> keySet()

Определен в:

keySet в интерфейсе ConcurrentNavigableMap<K,V>

Определен в:

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

Определен в:

keySet в интерфейсе SortedMap<K,V>

Переопределяет:

keySet в классе AbstractMap<K,V>

Возвращает:

представление ключей этой карты в виде навигационного набора

public NavigableSet<K> navigableKeySet()

Определен в:

navigableKeySet в интерфейсе ConcurrentNavigableMap<K,V>

Определен в:

navigableKeySet в интерфейсе NavigableMap<K,V>

Возвращает:

представление ключей этой карты в виде навигационного набора

public Collection<V> values()

Определен в:

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

Определен в:

values в интерфейсе SortedMap<K,V>

Переопределяет:

values в классе AbstractMap<K,V>

Возвращает:

представление значений этой карты в виде коллекции

public Set<Map.Entry<K,V>> entrySet()

Определен в:

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

Определен в:

entrySet в интерфейсе SortedMap<K,V>

Возвращает:

представление отображений, содержащихся в этой карте, в виде набора, отсортированного по возрастанию ключей

public ConcurrentNavigableMap<K,V> descendingMap()

Определен в:

descendingMap в интерфейсе ConcurrentNavigableMap<K,V>

Определен в:

descendingMap в интерфейсе NavigableMap<K,V>

Возвращает:

представление этой карты в обратном порядке

public NavigableSet<K> descendingKeySet()

Определен в:

descendingKeySet в интерфейсе ConcurrentNavigableMap<K,V>

Определен в:

descendingKeySet в интерфейсе NavigableMap<K,V>

Возвращает:

представление ключей этой карты в виде навигационного набора в обратном порядке

public boolean equals(Object o)

Определен в:

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

Переопределяет:

equals в классе AbstractMap<K,V>

Параметры:

o — объект, сравниваемый на равенство с этой картой

Возвращает:

true, если указанный объект равен этой карте

См. также:

• Object.hashCode()
• HashMap

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, если для ключа не было отображения

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ или значение равны null

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ равен null

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

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если любой из аргументов равен null

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, если для ключа не было отображения

Исключения:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в карте

NullPointerException — если указанный ключ или значение равны null

public Comparator<? super K> comparator()

Указано в:

comparator в интерфейсе SortedMap<K,V>

Возвращает:

компаратор, используемый для упорядочения ключей в этой карте, или null, если в этой карте используется естественный порядок ключей

public K firstKey()

Указано в:

firstKey в интерфейсе SortedMap<K,V>

Возвращает:

первый (наименьший) ключ, находящийся в данный момент в этой карте

Вызывает исключение:

NoSuchElementException — если эта карта пуста

public K lastKey()

Указано в:

lastKey в интерфейсе SortedMap<K,V>

Возвращает:

последний (наибольший) ключ, находящийся в данный момент в этой карте

Вызывает исключение:

NoSuchElementException — если эта карта пуста

public V putFirst(K k, V v)

Указано в:

putFirst в интерфейсе SequencedMap<K,V>

Указано в:

putFirst в интерфейсе SortedMap<K,V>

Параметры:

k — ключ

v — значение

Возвращает:

значение, ранее связанное с k, или null, если такого значения нет

Вызывает исключение:

UnsupportedOperationException — всегда

Начиная с версии:

21

public V putLast(K k, V v)

Указано в:

putLast в интерфейсе SequencedMap<K,V>

Указано в:

putLast в интерфейсе SortedMap<K,V>

Параметры:

k — ключ

v — значение

Возвращает:

значение, ранее связанное с k, или null, если такого значения нет

Вызывает исключение:

UnsupportedOperationException — всегда

Начиная с версии:

21

public ConcurrentNavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)

Указано в:

subMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

subMap в интерфейсе NavigableMap<K,V>

Параметры:

fromKey — нижняя граница ключей возвращаемой карты

fromInclusive — true, если нижнюю границу необходимо включить в возвращаемое представление

toKey — верхняя граница ключей возвращаемой карты

toInclusive — true, если верхнюю границу необходимо включить в возвращаемое представление

Возвращает:

представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey

Вызывает исключение:

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

NullPointerException — если fromKey или toKey равно null

IllegalArgumentException — если fromKey больше toKey; или если диапазон самой карты ограничен и fromKey или toKey находится за его границами

public ConcurrentNavigableMap<K,V> headMap(K toKey, boolean inclusive)

Указано в:

headMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

headMap в интерфейсе NavigableMap<K,V>

Параметры:

toKey — верхняя граница ключей возвращаемой карты

inclusive — true, если верхнюю границу необходимо включить в возвращаемое представление

Возвращает:

представление части этой карты, ключи которой меньше (или равны, если inclusive равно true) toKey

Вызывает исключение:

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

NullPointerException — если toKey равно null

IllegalArgumentException — если диапазон самой карты ограничен и toKey находится за его границами

public ConcurrentNavigableMap<K,V> tailMap(K fromKey, boolean inclusive)

Указано в:

tailMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

tailMap в интерфейсе NavigableMap<K,V>

Параметры:

fromKey — нижняя граница ключей возвращаемой карты

inclusive — true, если нижнюю границу необходимо включить в возвращаемое представление

Возвращает:

представление части этой карты, ключи которой больше (или равны, если inclusive равно true) fromKey

Вызывает исключение:

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

NullPointerException — если fromKey равно null

IllegalArgumentException — если диапазон самой карты ограничен и fromKey находится за его границами

public ConcurrentNavigableMap<K,V> subMap(K fromKey, K toKey)

Указано в:

subMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

subMap в интерфейсе NavigableMap<K,V>

Указано в:

subMap в интерфейсе SortedMap<K,V>

Параметры:

fromKey — нижняя граница (включительно) ключей возвращаемой карты

toKey — верхняя граница (исключительно) ключей возвращаемой карты

Возвращает:

представление части этой карты, ключи которой находятся в диапазоне от fromKey включительно до toKey исключительно

Вызывает исключение:

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

NullPointerException — если fromKey или toKey равно null

IllegalArgumentException — если fromKey больше toKey; или если диапазон самой карты ограничен и fromKey или toKey находится за его границами

public ConcurrentNavigableMap<K,V> headMap(K toKey)

Указано в:

headMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

headMap в интерфейсе NavigableMap<K,V>

Указано в:

headMap в интерфейсе SortedMap<K,V>

Параметры:

toKey — верхняя граница (исключительно) ключей возвращаемой карты

Возвращает:

представление части этой карты, ключи которой строго меньше toKey

Вызывает исключение:

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

NullPointerException — если toKey равно null

IllegalArgumentException — если диапазон самой карты ограничен и toKey находится за его границами

public ConcurrentNavigableMap<K,V> tailMap(K fromKey)

Указано в:

tailMap в интерфейсе ConcurrentNavigableMap<K,V>

Указано в:

tailMap в интерфейсе NavigableMap<K,V>

Указано в:

tailMap в интерфейсе SortedMap<K,V>

Параметры:

fromKey — нижняя граница (включительно) ключей возвращаемой карты

Возвращает:

представление части этой карты, ключи которой больше или равны fromKey

Вызывает исключение:

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

NullPointerException — если fromKey равно null

IllegalArgumentException — если диапазон самой карты ограничен и fromKey находится за его границами

public Map.Entry<K,V> lowerEntry(K key)

Указано в:

lowerEntry в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

запись с наибольшим ключом, меньшим key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public K lowerKey(K key)

Указано в:

lowerKey в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

наибольший ключ, меньший key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public Map.Entry<K,V> floorEntry(K key)

Указано в:

floorEntry в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

запись с наибольшим ключом, меньшим или равным key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public K floorKey(K key)

Указано в:

floorKey в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

наибольший ключ, меньший или равный key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public Map.Entry<K,V> ceilingEntry(K key)

Указано в:

ceilingEntry в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

запись с наименьшим ключом, большим или равным key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public K ceilingKey(K key)

Указано в:

ceilingKey в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

наименьший ключ, больший или равный key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public Map.Entry<K,V> higherEntry(K key)

Указано в:

higherEntry в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

запись с наименьшим ключом, большим key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public K higherKey(K key)

Указано в:

higherKey в интерфейсе NavigableMap<K,V>

Параметры:

key — ключ

Возвращает:

наименьший ключ, больший key, или null, если такого ключа нет

Вызывает исключение:

ClassCastException — если указанный ключ нельзя сравнить с ключами, находящимися в данный момент в карте

NullPointerException — если указанный ключ равен null

public Map.Entry<K,V> firstEntry()

Указано в:

firstEntry в интерфейсе NavigableMap<K,V>

Указано в:

firstEntry в интерфейсе SequencedMap<K,V>

Возвращает:

запись с наименьшим ключом или null, если эта карта пуста

public Map.Entry<K,V> lastEntry()

Указано в:

lastEntry в интерфейсе NavigableMap<K,V>

Указано в:

lastEntry в интерфейсе SequencedMap<K,V>

Возвращает:

запись с наибольшим ключом или null, если эта карта пуста

public Map.Entry<K,V> pollFirstEntry()

Указано в:

pollFirstEntry в интерфейсе NavigableMap<K,V>

Указано в:

pollFirstEntry в интерфейсе SequencedMap<K,V>

Возвращает:

удалённая первая запись этой карты или null, если эта карта пуста

public Map.Entry<K,V> pollLastEntry()

Указано в:

pollLastEntry в интерфейсе NavigableMap<K,V>

Указано в:

pollLastEntry в интерфейсе SequencedMap<K,V>

Возвращает:

удалённая последняя запись этой карты или null, если эта карта пуста