Spec-Zone.ru › OpenJDK 24

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

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

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

C момента:
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, reversed

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

sequencedEntrySet, sequencedKeySet, sequencedValues

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

comparator, entrySet, firstKey, lastKey, putFirst, putLast, 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 равно true) toKey. Возвращаемое отображение поддерживается этим отображением, поэтому изменения в возвращаемом отображении отражаются в этом отображении, и наоборот. Возвращаемое отображение поддерживает все необязательные операции отображения, которые поддерживает это отображение.

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

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

tailMap

ConcurrentNavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
Описание скопировано из интерфейса: NavigableMap
Возвращает представление части этого отображения, ключи которого больше (или равны, если inclusive равно true) fromKey. Возвращаемое отображение поддерживается этим отображением, поэтому изменения в возвращаемом отображении отражаются в этом отображении, и наоборот. Возвращаемое отображение поддерживает все необязательные операции отображения, которые поддерживает это отображение.

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

Определено в:
tailMap в интерфейсе NavigableMap<K,V>
Параметры:
fromKey - нижняя граница ключей в возвращаемом отображении
inclusive - true, если нижняя граница должна быть включена в возвращаемое представление
Возвращает:
представление части этого отображения, ключи которого больше (или равны, если inclusive равно true) 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>
Возвращает:
представление этой карты в обратном порядке

navigableKeySet

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

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

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

keySet

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

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

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

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

descendingKeySet

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

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API