Класс 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 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, если эта карта пуста