KeyValueHolder类源码理解

---

前言

本文章帮助大家对KeyValueHolder类的理解。

---

一、概述

KeyValueHolder意为键值持有器。顾名思义，此类可以表示“键值对”对象，其提供读取键、值、判断、哈希码。但它不能修改值，且键、值均非空。

它属于值类型。

二、源码理解

包

package java.util;

KeyValueHolder类

final class KeyValueHolder<K,V> implements Map.Entry<K,V> { /*...*/ }

final且非public类，无法继承，仅本包可用。使用类时传入泛型K、V，为键、值的类型。实现了Map.Entry接口，使此类具有的映射容器的项的表现。参考Map.Entry接口。

KeyValueHolder变量

key

final K key;

非public常量。表示键。

value

final V value;

非public常量。表示值。

KeyValueHolder方法

KeyValueHolder

KeyValueHolder(K k, V v) { /*...*/ }

非public构造函数，将键、值设为k、v。若k或v为空，则抛出NullPointerException异常。

getKey

public K getKey() { /*...*/ }

实现Map.Entry接口的K getKey()方法，参考Map.Entry.getKey方法。

返回键。

getValue

public V getValue() { /*...*/ }

实现Map.Entry接口的V getValue()方法，参考Map.Entry.getValue方法。

返回值。

setValue

public V setValue(V value)  { throw new UnsupportedOperationException("not supported"); }

实现Map.Entry接口的V setValue(V value)方法，参考Map.Entry.setValue方法。

设置值。仅抛出UnsupportedOperationException异常，不做其它处理。

equals

public boolean equals(Object o) { /*...*/ }

重写Object类的boolean equals(Object obj)方法，参考Object.equals方法。

判断此对象与o的键值对是否相等。相等的条件为：o也实现了映射容器的项接口且它们键、值均相等（equals）。

hashCode

public int hashCode() { /*...*/ }

重写Object类的int hashCode()方法，参考Object.hashCode方法。

返回此对象键、值的哈希码的异或。

toString

public String toString() { /*...*/ }

重写Object类的String toString()方法，参考Object.toString方法。

将此对象键值对“转换”为字符串，返回key + "=" + value。

---

总结

新人源码理解，望大家多多指点。