Класс AbstractMap.SimpleImmutableEntry<K,V>

java.lang.Object

java.util.AbstractMap.SimpleImmutableEntry<K,V>

Параметры типа:: K — тип ключей; V — тип значения

Все реализуемые интерфейсы:: Serializable, Map.Entry<K,V>

Внешний класс:: AbstractMap<K,V>

public static class AbstractMap.SimpleImmutableEntry<K,V> extends Object implements Map.Entry<K,V>, Serializable

Неизменяемая запись, хранящая ключ и значение. Этот класс не поддерживает метод setValue. Экземпляры этого класса не связаны ни с какой картой или представлением набора записей карты.

Примечание к API:

Экземпляры этого класса не обязательно являются неизменяемыми, поскольку ключ и значение могут быть изменяемыми. Экземпляр именно этого класса является неизменяемым, поскольку ссылки на ключ и значение нельзя изменить. Ссылка этого типа может быть изменяемой, так как подкласс может допускать изменение или создавать видимость возможности изменения.

Этот класс может быть удобен в методах, возвращающих потокобезопасные снимки отображений «ключ-значение». Альтернативы см. в методах Map::entry и Map.Entry::copyOf.

С версии:

1.6

См. также:

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

Конструктор	Описание
`SimpleImmutableEntry(Map.Entry<? extends K, ? extends V> entry)`	Создает запись, представляющую то же отображение, что и указанная запись.
`SimpleImmutableEntry(K key, V value)`	Создает запись, представляющую отображение указанного ключа в указанное значение.

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

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этой записью на равенство.
`K`	`getKey()`	Возвращает ключ, соответствующий этой записи.
`V`	`getValue()`	Возвращает значение, соответствующее этой записи.
`int`	`hashCode()`	Возвращает хеш-код этой записи карты.
`V`	`setValue(V value)`	Заменяет значение, соответствующее этой записи, указанным значением (необязательная операция).
`String`	`toString()`	Возвращает строковое представление этой записи карты.

Методы, объявленные в классе Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

SimpleImmutableEntry

public SimpleImmutableEntry(K key, V value)

Создает запись, представляющую отображение указанного ключа в указанное значение.

Параметры:: key — ключ, представленный этой записью; value — значение, представленное этой записью

SimpleImmutableEntry

public SimpleImmutableEntry(Map.Entry<? extends K, ? extends V> entry)

Создает запись, представляющую то же отображение, что и указанная запись.

Параметры:: entry — запись для копирования

Подробное описание методов

getKey

public K getKey()

Возвращает ключ, соответствующий этой записи.

Определен в:: getKey в интерфейсе Map.Entry<K,V>
Возвращает:: ключ, соответствующий этой записи

getValue

public V getValue()

Возвращает значение, соответствующее этой записи.

Определен в:: getValue в интерфейсе Map.Entry<K,V>
Возвращает:: значение, соответствующее этой записи

setValue

public V setValue(V value)

Заменяет значение, соответствующее этой записи, указанным значением (необязательная операция). Эта реализация просто выбрасывает UnsupportedOperationException, поскольку данный класс реализует неизменяемую запись карты.

Определен в:: setValue в интерфейсе Map.Entry<K,V>
Требования к реализации:: Реализация в этом классе всегда выбрасывает UnsupportedOperationException.
Параметры:: value — новое значение для сохранения в этой записи
Возвращает:: (Не возвращает значение)
Выбрасывает:: UnsupportedOperationException — всегда

equals

public boolean equals(Object o)

Сравнивает указанный объект с этой записью на равенство. Возвращает true, если переданный объект также является записью карты и обе записи представляют одно и то же отображение. Точнее, две записи e1 и e2 представляют одно и то же отображение, если

  (e1.getKey()==null ?
   e2.getKey()==null :
   e1.getKey().equals(e2.getKey()))
  &&
  (e1.getValue()==null ?
   e2.getValue()==null :
   e1.getValue().equals(e2.getValue()))

Это гарантирует, что метод equals корректно работает с различными реализациями интерфейса Map.Entry.

Определен в:

equals в интерфейсе Map.Entry<K,V>

Переопределяет:

equals в классе Object

Параметры:

o — объект для сравнения на равенство с этой записью карты

Возвращает:

true, если указанный объект равен этой записи карты

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этой записи карты. Хеш-код записи карты e определяется следующим образом:

  (e.getKey()==null   ? 0 : e.getKey().hashCode()) ^
  (e.getValue()==null ? 0 : e.getValue().hashCode())

Это гарантирует, что из e1.equals(e2) следует e1.hashCode()==e2.hashCode() для любых двух записей e1 и e2, как того требует общий контракт Object.hashCode().

Определен в:

hashCode в интерфейсе Map.Entry<K,V>

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код этой записи карты

См. также:

toString

public String toString()

Возвращает строковое представление этой записи карты. Эта реализация возвращает строковое представление ключа этой записи, за которым следует знак равенства ("="), а затем строковое представление значения этой записи.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этой записи карты

© 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.