Spec-Zone.ru › OpenJDK 17

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

Type Parameters:
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.

Since:
1.6

Краткое описание вложенных классов

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

Map.Entry<K,V>

Краткое описание методов

Модификатор и тип Метод Описание
NavigableSet<K> descendingKeySet()
Возвращает отображение ключей в обратном порядке, содержащихся в этом отображении.
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<K> navigableKeySet()
Возвращает представление ключей, содержащихся в этом отображении, в виде навигаемого множества.
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 равно 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, 2021, 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/17/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html

Spec-Zone.ru

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