Интерфейс ConcurrentNavigableMap<K,​V>

Параметры типа:
K - тип ключей, поддерживаемых этой картой
V - тип сопоставленных значений
Все суперинтерфейсы:
ConcurrentMap<K,​V>, Map<K,​V>, NavigableMap<K,​V>, SortedMap<K,​V>
Все известные реализующие классы:
ConcurrentSkipListMap
public interface ConcurrentNavigableMap<K,V>
extends ConcurrentMap<K,​V>, NavigableMap<K,​V>

A ConcurrentMap поддерживающий NavigableMap операции, и рекурсивно для его навигационных под-карт.

Этот интерфейс является членом Java Collections Framework.

С:
1.6

Вложенные классы

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.Map

Map.Entry<K,​V>

Методы

Модификатор и тип Метод Описание
NavigableSet<K> descendingKeySet()

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

ConcurrentNavigableMap<K,​V> descendingMap()

Возвращает представление в обратном порядке сопоставлений, содержащихся в этой карте.

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

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

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

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

NavigableSet<K> keySet()

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

NavigableSet<K> navigableKeySet()

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

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

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

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

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

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

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

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

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

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

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Методы, объявленные в интерфейсе java.util.Map

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

Методы, объявленные в интерфейсе java.util.NavigableMap

ceilingEntry, ceilingKey, firstEntry, floorEntry, floorKey, higherEntry, higherKey, lastEntry, lowerEntry, lowerKey, pollFirstEntry, pollLastEntry

Методы, объявленные в интерфейсе java.util.SortedMap

comparator, entrySet, firstKey, lastKey, values

Методы

subMap

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

Описание скопировано из интерфейса: NavigableMap

Возвращает представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey. Если fromKey и toKey равны, возвращаемая карта пуста, если только fromInclusive и toInclusive не являются одновременно истинными. Возвращаемая карта основана на этой карте, поэтому изменения в возвращаемой карте отражаются в этой карте и наоборот. Возвращаемая карта поддерживает все необязательные операции с картой, которые поддерживает эта карта.

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона или создать подкарту, одна из конечных точек которой находится за пределами её диапазона.

Указано в:
subMap в интерфейсе NavigableMap<K,​V>
Параметры:
fromKey - нижняя граница ключей в возвращаемой карте
fromInclusive - true если нижняя граница должна быть включена в возвращаемое представление
toKey - верхняя граница ключей в возвращаемой карте
toInclusive - true если верхняя граница должна быть включена в возвращаемое представление
Возвращает:
представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey
Исключения:
ClassCastException - если fromKey и toKey не могут быть сравнены друг с другом с использованием компаратора этой карты (или, если карта не имеет компаратора, с использованием естественного порядка). Реализации могут, но не обязаны, вызывать это исключение, если fromKey или toKey не могут быть сравнены с ключами, которые в настоящее время находятся в карте.
NullPointerException - если fromKey или toKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если fromKey больше, чем toKey; или если сама эта карта имеет ограниченный диапазон, и fromKey или toKey находится за пределами границ диапазона

headMap

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

Описание скопировано из интерфейса: NavigableMap

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

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона.

Указано в:
headMap в интерфейсе NavigableMap<K,​V>
Параметры:
toKey - верхняя граница ключей в возвращаемой карте
inclusive - true если верхняя граница должна быть включена в возвращаемое представление
Возвращает:
представление части этой карты, ключи которой меньше (или равны, если inclusive истинно) toKey
Исключения:
ClassCastException - если toKey несовместим с компаратором этой карты (или, если карта не имеет компаратора, если toKey не реализует Comparable). Реализации могут, но не обязаны, вызывать это исключение, если toKey не может быть сравнен с ключами, которые в настоящее время находятся в карте.
NullPointerException - если toKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если сама эта карта имеет ограниченный диапазон, и toKey находится за пределами границ диапазона

tailMap

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

Описание скопировано из интерфейса: NavigableMap

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

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона.

Указано в:
tailMap в интерфейсе NavigableMap<K,​V>
Параметры:
fromKey - нижняя граница ключей в возвращаемой карте
inclusive - true если нижняя граница должна быть включена в возвращаемое представление
Возвращает:
представление части этой карты, ключи которой больше (или равны, если inclusive истинно) fromKey
Исключения:
ClassCastException - если fromKey несовместим с компаратором этой карты (или, если карта не имеет компаратора, если fromKey не реализует Comparable). Реализации могут, но не обязаны, вызывать это исключение, если fromKey не может быть сравнен с ключами, которые в настоящее время находятся в карте.
NullPointerException - если fromKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если сама эта карта имеет ограниченный диапазон, и fromKey находится за пределами границ диапазона

subMap

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

Описание скопировано из интерфейса: NavigableMap

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

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона.

Эквивалентно subMap(fromKey, true, toKey, false).

Указано в:
subMap в интерфейсе NavigableMap<K,​V>
Указано в:
subMap в интерфейсе SortedMap<K,​V>
Параметры:
fromKey - нижняя граница (включительно) ключей в возвращаемой карте
toKey - верхняя граница (исключительно) ключей в возвращаемой карте
Возвращает:
представление части этой карты, ключи которой находятся в диапазоне от fromKey, включительно, до toKey, не включая
Исключения:
ClassCastException - если fromKey и toKey не могут быть сравнены друг с другом с использованием компаратора этой карты (или, если карта не имеет компаратора, с использованием естественного порядка). Реализации могут, но не обязаны, вызывать это исключение, если fromKey или toKey не могут быть сравнены с ключами, которые в настоящее время находятся в карте.
NullPointerException - если fromKey или toKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если fromKey больше, чем toKey; или если сама эта карта имеет ограниченный диапазон, и fromKey или toKey находится за пределами границ диапазона

headMap

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

Описание скопировано из интерфейса: NavigableMap

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

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона.

Эквивалентно headMap(toKey, false).

Указано в:
headMap в интерфейсе NavigableMap<K,​V>
Указано в:
headMap в интерфейсе SortedMap<K,​V>
Параметры:
toKey - верхняя граница (исключительно) ключей в возвращаемой карте
Возвращает:
представление части этой карты, ключи которой строго меньше toKey
Исключения:
ClassCastException - если toKey несовместим с компаратором этой карты (или, если карта не имеет компаратора, если toKey не реализует Comparable). Реализации могут, но не обязаны, вызывать это исключение, если toKey не может быть сравнен с ключами, которые в настоящее время находятся в карте.
NullPointerException - если toKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если сама эта карта имеет ограниченный диапазон, и toKey находится за пределами границ диапазона

tailMap

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

Описание скопировано из интерфейса: NavigableMap

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

Возвращаемая карта вызовет исключение IllegalArgumentException при попытке вставить ключ за пределами своего диапазона.

Эквивалентно tailMap(fromKey, true).

Указано в:
tailMap в интерфейсе NavigableMap<K,​V>
Указано в:
tailMap в интерфейсе SortedMap<K,​V>
Параметры:
fromKey - нижняя граница (включительно) ключей в возвращаемой карте
Возвращает:
представление части этой карты, ключи которой больше или равны fromKey
Исключения:
ClassCastException - если fromKey несовместим с компаратором этой карты (или, если карта не имеет компаратора, если fromKey не реализует Comparable). Реализации могут, но не обязаны, вызывать это исключение, если fromKey не может быть сравнен с ключами, которые в настоящее время находятся в карте.
NullPointerException - если fromKey равно null, и эта карта не допускает ключей null
IllegalArgumentException - если сама эта карта имеет ограниченный диапазон, и fromKey находится за пределами границ диапазона

descendingMap

ConcurrentNavigableMap<K,V> descendingMap()

Возвращает представление отображений, содержащихся в этом отображении, в обратном порядке. Отображение в обратном порядке опирается на это отображение, поэтому изменения в отображении отражаются в отображении в обратном порядке, и наоборот.

Возвращаемое отображение имеет порядок, эквивалентный Collections.reverseOrder(comparator()). Выражение m.descendingMap().descendingMap() возвращает представление m, по сути, эквивалентное m.

Определено в:
descendingMap в интерфейсе NavigableMap<K,​V>
Возвращает:
представление этого отображения в обратном порядке
NavigableSet<K> navigableKeySet()

Возвращает представление набора ключей, содержащихся в этом отображении, в виде NavigableSet. Итератор набора возвращает ключи в порядке возрастания. Набор опирается на отображение, поэтому изменения в отображении отражаются в наборе, и наоборот. Набор поддерживает удаление элементов, что удаляет соответствующее отображение из отображения, посредством операций Iterator.remove, Set.remove, removeAll, retainAll, и clear. Он не поддерживает операции add или addAll.

Итераторы и разделители представления являются слабо согласованными.

Определено в:
navigableKeySet в интерфейсе NavigableMap<K,​V>
Возвращает:
представление набора ключей этого отображения в виде navigable set

keySet

NavigableSet<K> keySet()

Возвращает представление набора ключей, содержащихся в этом отображении, в виде NavigableSet. Итератор набора возвращает ключи в порядке возрастания. Набор опирается на отображение, поэтому изменения в отображении отражаются в наборе, и наоборот. Набор поддерживает удаление элементов, что удаляет соответствующее отображение из отображения, посредством операций Iterator.remove, Set.remove, removeAll, retainAll, и clear. Он не поддерживает операции add или addAll.

Итераторы и разделители представления являются слабо согласованными.

Этот метод эквивалентен методу navigableKeySet.

Определено в:
keySet в интерфейсе Map<K,​V>
Определено в:
keySet в интерфейсе SortedMap<K,​V>
Возвращает:
представление набора ключей этого отображения в виде navigable set

descendingKeySet

NavigableSet<K> descendingKeySet()

Возвращает представление набора ключей, содержащихся в этом отображении, в обратном порядке, в виде NavigableSet. Итератор набора возвращает ключи в порядке убывания. Набор опирается на отображение, поэтому изменения в отображении отражаются в наборе, и наоборот. Набор поддерживает удаление элементов, что удаляет соответствующее отображение из отображения, посредством операций Iterator.remove, Set.remove, removeAll, retainAll, и clear. Он не поддерживает операции add или addAll.

Итераторы и разделители представления являются слабо согласованными.

Определено в:
descendingKeySet в интерфейсе NavigableMap<K,​V>
Возвращает:
представление набора ключей этого отображения в обратном порядке в виде navigable set

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html

Spec-Zone .ru
спецификации, руководства, описания, API