Интерфейс 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>
ConcurrentMap поддерживающий операции NavigableMap, и рекурсивно так для его под-карт. Этот интерфейс является частью Java Collections Framework.
- С тех пор:
- 1.6
Краткое описание вложенных классов
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
NavigableSet |
descendingKeySet() |
Возвращает вид NavigableSet ключей, содержащихся в этой карте, в обратном порядке. |
ConcurrentNavigableMap |
descendingMap() |
Возвращает вид отображений, содержащихся в этой карте, в обратном порядке. |
ConcurrentNavigableMap |
headMap |
Возвращает представление части этой карты, ключи которой строго меньше toKey. |
ConcurrentNavigableMap |
headMap |
Возвращает представление части этой карты, ключи которой меньше (или равны, если inclusive истинно) toKey. |
NavigableSet |
keySet() |
Возвращает представление NavigableSet ключей, содержащихся в этой карте. |
NavigableSet |
navigableKeySet() |
Возвращает представление NavigableSet ключей, содержащихся в этой карте. |
ConcurrentNavigableMap |
subMap |
Возвращает представление части этой карты, ключи которой находятся в диапазоне от fromKey до toKey. |
ConcurrentNavigableMap |
subMap |
Возвращает представление части этой карты, ключи которой находятся в диапазоне от fromKey, включительно, до toKey, исключая. |
ConcurrentNavigableMap |
tailMap |
Возвращает представление части этой карты, ключи которой больше или равны fromKey. |
ConcurrentNavigableMap |
tailMap |
Возвращает представление части этой карты, ключи которой больше (или равны, если 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
Подробное описание методов
subMap
ConcurrentNavigableMap<K,V> subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)
NavigableMapfromKey до 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)
NavigableMapinclusive истинно) 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)
NavigableMapinclusive истинно) 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)
NavigableMapfromKey, включительно, до 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)
NavigableMaptoKey. Возвращаемое отображение основано на этом отображении, поэтому изменения в возвращаемом отображении отражаются в этом отображении, и наоборот. Возвращаемое отображение поддерживает все необязательные операции отображения, которые поддерживает это отображение. Возвращаемое отображение будет выбрасывать 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)
NavigableMapfromKey. Возвращаемое отображение поддерживается этим отображением, поэтому изменения в возвращаемом отображении отражаются в этом отображении и наоборот. Возвращаемое отображение поддерживает все необязательные операции отображения, которые поддерживает это отображение. Возвращаемое отображение сгенерирует 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> - Возвращает:
- представление отображения в обратном порядке
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, 2023, 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/21/docs/api/java.base/java/util/concurrent/ConcurrentNavigableMap.html