方法详细信息

• getKey

  K getKey()

  返回与此条目对应的键。

  结果

  与此条目对应的密钥

  异常

  IllegalStateException - 如果已从支持映射中删除条目，则实现可以（但不是必需）抛出此异常。

• getValue

  V getValue()

  返回与此条目对应的值。 如果映射已从支持映射中删除（通过迭代器的remove操作），则此调用的结果未定义。

  结果

  与此条目对应的值

  异常

  IllegalStateException - 如果已从支持映射中删除条目，则实现可以（但不是必需）抛出此异常。

• setValue

  V setValue​(V value)

  用指定的值替换此条目对应的值（可选操作）。 （写入映射。）如果映射已从映射中删除（通过迭代器的remove操作），则此调用的行为未定义。

  参数

  value - 要在此条目中存储的新值

  结果

  与条目对应的旧值

  异常

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

  ClassCastException - 如果指定值的类阻止它存储在支持映射中

  NullPointerException - 如果支持映射不允许空值，则指定的值为null

  IllegalArgumentException - 如果此值的某些属性阻止它存储在支持映射中

  IllegalStateException - 如果已从支持映射中删除条目，则实现可以（但不是必需）抛出此异常。

• equals

  boolean equals​(Object o)

  将指定对象与此条目进行比较以获得相等性。 如果给定对象也是映射条目，则返回true ，并且这两个条目表示相同的映射。 更正式地说，两个条目e1和e2表示相同的映射if

    (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

• hashCode

  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 ，根据e2的一般合同的Object.hashCode 。

  重写：

  hashCode类 Object

  结果

  此映射条目的哈希码值

  另请参见：

  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类型

  V - 地图值的类型

  结果

  一个比较器， 按键自然顺序比较Map.Entry 。

  从以下版本开始：

  1.8

  另请参见：

  Comparable

• comparingByValue

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

  返回一个比较器，按值自然顺序比较Map.Entry 。

  返回的比较器是可序列化的，并在比较具有空值的条目时抛出NullPointerException 。

  参数类型

  K - 地图键的类型

  V - 地图值的Comparable类型

  结果

  比较器按自然顺序比较Map.Entry的值。

  从以下版本开始：

  1.8

  另请参见：

  Comparable

• comparingByKey

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

  返回进行比较的比较Map.Entry通过使用特定的密钥Comparator 。

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

  参数类型

  K - 地图键的类型

  V - 地图值的类型

  参数

  cmp - 钥匙Comparator

  结果

  一个比较器，用键比较Map.Entry 。

  从以下版本开始：

  1.8

• comparingByValue

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

  返回进行比较的比较Map.Entry通过使用所述给定值Comparator 。

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

  参数类型

  K - 地图键的类型

  V - 地图值的类型

  参数

  cmp - 数值Comparator

  结果

  比较器，用于比较Map.Entry的值。

  从以下版本开始：

  1.8