compact1, compact2, compact3

java.util

Interface Map.Entry<K,V>

所有已知实现类：

AbstractMap.SimpleEntry， AbstractMap.SimpleImmutableEntry

Enclosing interface:

Map < K， V >

public static interface Map.Entry<K,V>

Map输入（键-值对）。的 Map.entrySet方法返回一个Map的集合视图，它的元素是这类。获得一个参考Map进入只有方式是从这个集合视图迭代器。这些 Map.Entry对象为迭代的持续有效的只有；更正式，如果支持Map已经入境后被返回的迭代器修改Map进入的行为是未定义的，除了通过 setValue操作在Map入口。

从以下版本开始：

一点二

另请参见：

Map.entrySet()

方法摘要

Modifier and Type	Method and Description
static <K extends Comparable<? super K>,V> Comparator<Map.Entry<K,V>>	comparingByKey() 返回一个比较器，比较 Map.Entry自然秩序的关键。
static <K,V> Comparator<Map.Entry<K,V>>	comparingByKey(Comparator<? super K> cmp) 返回一个比较器，比较 Map.Entry重点使用给定的 Comparator。
static <K,V extends Comparable<? super V>> Comparator<Map.Entry<K,V>>	comparingByValue() 返回一个比较器，比较 Map.Entry在自然秩序中的价值。
static <K,V> Comparator<Map.Entry<K,V>>	comparingByValue(Comparator<? super V> cmp) 返回一个比较器，比较 Map.Entry利用给出的 Comparator价值。
boolean	equals(Object o) 将指定的对象与此项的相等性进行比较。
K	getKey() 返回对应于此项的键。
V	getValue() 返回对应于此项的值。
int	hashCode() 返回此Map项的哈希代码值。
V	setValue(V value) 用指定的值替换对应于此项的值（可选操作）。

方法详细信息

getKey

K getKey()

返回对应于此项的键。

结果

此条目对应的键

异常

IllegalStateException -实现可能，但不要求，如果入口已经从支持Map删除抛出该异常。

getValue

V getValue()

返回对应于此项的值。如果映射已从支持Map删除（由迭代器的 remove操作），这个调用的结果是不确定的。

结果

此条目对应的值

异常

IllegalStateException -实现可能，但不要求，如果入口已经从支持Map删除抛出该异常。

setValue

V setValue(V value)

用指定的值替换对应于此项的值（可选操作）。（写在Map上。）如果映射已经从Map上移除此调用的行为是未定义的（由迭代器的 remove操作）。

参数

value -被存储在这项新的价值

结果

旧值对应的条目

异常

UnsupportedOperationException -如果 put操作不受支持的Map支持

ClassCastException -如果指定值的类可以防止它被存储在支持Map

NullPointerException如果支持Map不允许空值，并指定的值为空

如果这个值 IllegalArgumentException财产防止它被存储在支持Map

IllegalStateException -实现可能，但不要求，如果入口已经从支持Map删除抛出该异常。

equals

boolean equals(Object o)

将指定的对象与此项的相等性进行比较。返回 true如果给定的对象也是一个映射项和两项表示相同的映射。更正式地说，两项 e1和 e2如果

（E1。getkey() = =零？E2。getkey() = =零：E1。getkey()。等于（E2。getkey()））&（E1。getvalue() = =零？E2。getvalue() = =零：E1。getvalue()。等于（E2。getvalue()））

这保证了 equals方法正常工作在 Map.Entry接口的不同实现表示相同的映射。

重写：

equals 方法重写，继承类 Object

参数

o对象是和映射项比较相等性

结果

true指定对象是否等于映射项

另请参见：

Object.hashCode()， HashMap

hashCode

int hashCode()

返回此Map项的哈希代码值。一个Map进入 e哈希码被定义为：

（E getkey() = =零？0：大肠getkey() ^ hashcode()）。（E getvalue() = =零？0：大肠getvalue() hashcode()）。

这确保 e1.equals(e2)意味着 e1.hashCode()==e2.hashCode()任何两项 e1和 e2，由 Object.hashCode一般合同要求。

重写：

hashCode 方法重写，继承类 Object

结果

此Map条目的哈希代码值

另请参见：

Object.hashCode()， Object.equals(Object)， equals(Object)

comparingByKey

static <K extends Comparable<? super K>,V> Comparator<Map.Entry<K,V>> comparingByKey()

返回一个比较器，比较 Map.Entry自然秩序的关键。

返回的比较器可序列化和投NullPointerException比较时，一个空键进入。

参数类型

K - Comparable型然后Map键

VMap的值的类型

结果

一个比较器比较 Map.Entry自然秩序的关键。

从以下版本开始：

一点八

另请参见：

Comparable

comparingByValue

static <K,V extends Comparable<? super V>> Comparator<Map.Entry<K,V>> comparingByValue()

返回一个比较器，比较 Map.Entry在自然秩序中的价值。

返回的比较器可序列化和投NullPointerException时比较有空值的输入。

参数类型

KMap的键的类型

VMap的价值 Comparable型

结果

一个比较器比较 Map.Entry在自然秩序中的价值。

从以下版本开始：

一点八

另请参见：

Comparable

comparingByKey

static <K,V> Comparator<Map.Entry<K,V>> comparingByKey(Comparator<? super K> cmp)

返回一个比较器，比较 Map.Entry重点使用给定的 Comparator。

如果指定的比较器也可序列化序列化返回的比较器。

参数类型

KMap的键的类型

VMap的值的类型

参数

cmp的关键 Comparator

结果

一个比较器比较 Map.Entry的关键。

从以下版本开始：

一点八

comparingByValue

static <K,V> Comparator<Map.Entry<K,V>> comparingByValue(Comparator<? super V> cmp)

返回一个比较器，比较 Map.Entry利用给出的 Comparator价值。

如果指定的比较器也可序列化序列化返回的比较器。

参数类型

KMap的键的类型

VMap的值的类型

参数

cmp -价值 Comparator

结果

一个比较器比较 Map.Entry的价值。

从以下版本开始：

一点八