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

java.lang.Object

java.util.AbstractMap.SimpleImmutableEntry<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()

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

Возвращает:

значение хэш-кода для этой пары ключ-значение

См. также:

equals(java.lang.Object)

toString

public String toString()

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

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

© 1993, 2021, 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/17/docs/api/java.base/java/util/AbstractMap.SimpleImmutableEntry.html