Интерфейс 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() | Возвращает обратный порядок |
ConcurrentNavigableMap<K,V> | descendingMap() | Возвращает представление в обратном порядке сопоставлений, содержащихся в этой карте. |
ConcurrentNavigableMap<K,V> | headMap(K toKey) | Возвращает представление части этой карты, ключи которой строго меньше |
ConcurrentNavigableMap<K,V> | headMap(K toKey,
boolean inclusive) | Возвращает представление части этой карты, ключи которой меньше (или равны, если |
NavigableSet<K> | keySet() | Возвращает |
NavigableSet<K> | navigableKeySet() | Возвращает |
ConcurrentNavigableMap<K,V> | subMap(K fromKey,
boolean fromInclusive,
K toKey,
boolean toInclusive) | Возвращает представление части этой карты, ключи которой находятся в диапазоне от |
ConcurrentNavigableMap<K,V> | subMap(K fromKey,
K toKey) | Возвращает представление части этой карты, ключи которой находятся в диапазоне от |
ConcurrentNavigableMap<K,V> | tailMap(K fromKey) | Возвращает представление части этой карты, ключи которой больше или равны |
ConcurrentNavigableMap<K,V> | tailMap(K fromKey,
boolean inclusive) | Возвращает представление части этой карты, ключи которой больше (или равны, если |
Методы, объявленные в интерфейсе 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> - Возвращает:
- представление этого отображения в обратном порядке
navigableKeySet
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