java.util

Интерфейсная Карта. Запись <K, V>

Все Известные Классы с реализацией:

AbstractMap. SimpleEntry, AbstractMap. SimpleImmutableEntry

Включение интерфейса:

Карта <K, V>

public static interface Map.Entry<K,V>

Запись карты (пара ключ/значение). Метод Map.entrySet возвращает представление набора карты, элементы которой имеют этот класс. Единственный способ получить ссылку на запись карты от iterator этого представления набора. Эти объекты Map.Entry допустимы только для продолжительности итерации; более формально поведение записи карты неопределено, если отступающая карта была изменена после того, как запись была возвращена iterator, кроме через работу setValue на записи карты.

С тех пор:

1.2

См. Также:

Map.entrySet()

Сводка метода

Методы

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

Деталь метода

getKey

K getKey()

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

Возвраты:

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

Броски:

IllegalStateException - реализации, но не обязаны, может выдать это исключение, если запись была удалена из отступающей карты.

getValue

V getValue()

Возвращает значение, соответствующее этой записи. Если отображение было удалено из отступающей карты (работой remove iterator), результаты этого вызова неопределены.

Возвраты:

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

Броски:

IllegalStateException - реализации, но не обязаны, может выдать это исключение, если запись была удалена из отступающей карты.

setValue

V setValue(V value)

Заменяет значение, соответствующее этой записи с указанным значением (дополнительная работа). (Записи через к карте.) Поведение этого вызова неопределено, если отображение было уже удалено из карты (работой remove iterator).

Параметры:

value - новое значение, которое будет сохранено в этой записи

Возвраты:

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

Броски:

UnsupportedOperationException - если работа put не поддерживается отступающей картой

ClassCastException - если класс указанного значения препятствует тому, чтобы это было сохранено в отступающей карте

NullPointerException - если отступающая карта не разрешает нулевые значения, и указанное значение является нулем

IllegalArgumentException - если некоторое свойство этого значения препятствует тому, чтобы это было сохранено в отступающей карте

IllegalStateException - реализации, но не обязаны, может выдать это исключение, если запись была удалена из отступающей карты.

равняется

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 в классе Object

Параметры:

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

Возвраты:

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

См. Также:

Object.hashCode(), HashMap

хэш-код

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 в классе Object

Возвраты:

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

См. Также:

Object.hashCode(), Object.equals(Object), equals(Object)