java.util
介面 Map.Entry<K,V>

所有已知實作類別：

AbstractMap.SimpleEntry, AbstractMap.SimpleImmutableEntry

正在封閉介面：

Map<K,V>

public static interface Map.Entry<K,V>

映射項（鍵-值對）。Map.entrySet 方法返回映射的 collection 視圖，其中的元素屬於此類別。獲得映射項參考的唯一 方法是通過此 collection 視圖的迭代器來實作。這些 Map.Entry 物件僅 在迭代期間有效；更確切地講，如果在迭代器返回項之後修改了底層映射，則某些映射項的行為是不確定的，除了通過 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 操作），則此調用的結果是不確定的。

返回：

與此項對應的值

拋出：

IllegalStateException - 如果已經從底層映射中移除了該項，則實作可能，但不要求，拋出此異常。

setValue

V setValue(V value)

用指定的值替換與此項對應的值（可選操作）。（寫入該映射。）如果已經從映射中移除了映射關係（通過迭代器的 remove 操作），則此調用的行為是不確定的。

參數：

value - 要存儲在此項中的新值

返回：

與此項對應的舊值

拋出：

UnsupportedOperationException - 如果底層映射不支持 put 操作

ClassCastException - 如果指定值的類別不允許將該值存儲在底層映射中

NullPointerException - 如果底層映射不允許 null 值，並且指定的值為 null

IllegalArgumentException - 如果此值的某些方面不允許將其存儲在底層映射中

IllegalStateException - 如果已經從底層映射中移除了該項，則實作可能，但不要求，拋出此異常

equals

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 介面實作間可正確地工作。

覆寫：

類別 Object 中的 equals

參數：

o - 要與此映射項進行相等性比較的物件

返回：

如果指定的物件等於此映射項，則返回 true

另請參見：

Object.hashCode(), Hashtable

hashCode

int hashCode()

返回此映射項的雜湊碼值。映射項 e 的雜湊碼定義如下：

     (e.getKey()==null   ? 0 : e.getKey().hashCode()) ^
     (e.getValue()==null ? 0 : e.getValue().hashCode())
 

這確保 e1.equals(e2) 意味著對於任意兩個項 e1 和 e2 而言，e1.hashCode()==e2.hashCode()，這正是 Object.hashCode 的常規協定所要求的。

覆寫：

類別 Object 中的 hashCode

返回：

映射項的雜湊碼值

另請參見：

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