Класс 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, 2023, 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/21/docs/api/java.base/java/util/AbstractMap.SimpleImmutableEntry.html