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

java.lang.Object

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

Type Parameters:: 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()`	Возвращает строковое представление этой пары отображения.

Методы, объявленные в классе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/AbstractMap.SimpleImmutableEntry.html