Интерфейс 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>
ConcurrentMap поддерживающий NavigableMap операции, и рекурсивно для его навигационных подотображений. Этот интерфейс является членом Java Collections Framework.
- Since:
- 1.6
Краткое описание вложенных классов
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
NavigableSet<K> |
descendingKeySet() |
Возвращает отображение ключей в обратном порядке, содержащихся в этом отображении. |
ConcurrentNavigableMap<K, |
descendingMap() |
Возвращает отображение сопоставлений, содержащихся в этом отображении, в обратном порядке. |
ConcurrentNavigableMap<K, |
headMap |
Возвращает представление части этого отображения, ключи которого строго меньше toKey. |
ConcurrentNavigableMap<K, |
headMap |
Возвращает представление части этого отображения, ключи которого меньше (или равны, если inclusive истинно) toKey. |
NavigableSet<K> |
keySet() |
Возвращает представление ключей, содержащихся в этом отображении, в виде навигаемого множества. |
NavigableSet<K> |
navigableKeySet() |
Возвращает представление ключей, содержащихся в этом отображении, в виде навигаемого множества. |
ConcurrentNavigableMap<K, |
subMap |
Возвращает представление части этого отображения, ключи которого находятся в диапазоне от fromKey до toKey. |
ConcurrentNavigableMap<K, |
subMap |
Возвращает представление части этого отображения, ключи которого находятся в диапазоне от fromKey, включительно, до toKey, не включительно. |
ConcurrentNavigableMap<K, |
tailMap |
Возвращает представление части этого отображения, ключи которого больше или равны fromKey. |
ConcurrentNavigableMap<K, |
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
Подробное описание методов
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 равно 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)
NavigableMapinclusive равно 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)
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, 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