Класс 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/AbstractMap.SimpleImmutableEntry.html