JDK 源码分析:LinkedHashMap

概述

前文「 JDK源码分析-HashMap(1) 」分析了 HashMap 主要方法的实现原理(其他问题以后分析),本文分析下 LinkedHashMap。

先看一下 LinkedHashMap 的类继承结构图:

可以看到 LinkedHashMap 继承了 HashMap。

我们知道 HashMap 是无序的,即迭代器的顺序与插入顺序没什么关系。而 LinkedHashMap 在 HashMap 的基础上增加了顺序:分别为「插入顺序」和「访问顺序」。即遍历 LinkedHashMap 时,可以保持与插入顺序一致的顺序;或者与访问顺序一致的顺序。

LinkedHashMap 内部如何实现这两种顺序的呢?它是通过一个双链表来维持的。因此可以将 LinkedHashMap 理解为「双链表 + 散列表」,或者“有序的散列表”。

代码分析

节点类 Entry

LinkedHashMap 内部有一个嵌套类 Entry,它继承自 HashMap 中的 Node 类,如下:


static class Entry<K,V> extends HashMap.Node<K,V> {
Entry before, after;
Entry(int hash, K key, V value, Node next) {
super(hash, key, value, next);
}
}


static class Node<K,V> implements Map.Entry<K,V> {
final int hash;
final K key;
V value;
Node next;
Node(int hash, K key, V value, Node next) {
this.hash = hash;
this.key = key;
this.value = value;
this.next = next;
}
// …
}

该 Entry 类就是 LinkedHashMap 中的节点类。 可以看到,它在 Node 类的基础上又增加了 before 和 after 两个变量,它们保存的是节点的前驱和后继( 从字面意思也可以进行推测 ),从而来维护  LinkedHashMap 的顺序。

成员变量


/**
* The head (eldest) of the doubly linked list.
*/
transient LinkedHashMap.Entry<K,V> head;


/**
* The tail (youngest) of the doubly linked list.
*/
transient LinkedHashMap.Entry<K,V> tail;


/**
* The iteration ordering method for this linked hash map: true
* for access-order, false for insertion-order.
* LinkedHashMap 的迭代顺序:true 为访问顺序;false 为插入顺序。
*/
final boolean accessOrder;

构造器

构造器1:


/**
* Constructs an empty insertion-ordered LinkedHashMap instance
* with the default initial capacity (16) and load factor (0.75).
*/
public LinkedHashMap() {
super();
accessOrder = false;
}

这里的 super() 方法调用了 HashMap 的无参构造器。 该构造器方法构造了一个容量为 16(默认初始容量)、负载因子为 0.75(默认负载因子)的空 LinkedHashMap,其顺序为插入顺序。

构造器 2、3、4、5:


public LinkedHashMap(int initialCapacity) {
super(initialCapacity);
accessOrder = false;
}


public LinkedHashMap(int initialCapacity, float loadFactor) {
super(initialCapacity, loadFactor);
accessOrder = false;
}


public LinkedHashMap(Map<? extends K, ? extends V> m) {
super();
accessOrder = false;
putMapEntries(m, false);
}


public LinkedHashMap(int initialCapacity,
float loadFactor,
boolean accessOrder) {
super(initialCapacity, loadFactor);
this.accessOrder = accessOrder;
}

可以看到上面几个构造器都是通过调用父类(HashMap)的构造器方法初始化,对此不再进行分析。前面 4 个构造器的 accessOrder 变量默认值都为 false;最后一个稍微不一样,它的 accessOrder 可以在初始化时指定,即指定 LinkedHashMap 的顺序(插入或访问顺序)。

put 方法

LinkedHashMap 本身没有实现 put 方法 ,它通过调用父类(HashMap)的方法来进行读写操作。这里再贴下 HashMap 的 put 方法:


public V put(K key, V value) {
return putVal(hash(key), key, value, false, true);
}


final V putVal(int hash, K key, V value, boolean onlyIfAbsent,
boolean evict) {
Node[] tab; Node p; int n, i;
if ((tab = table) == null || (n = tab.length) == 0)
n = (tab = resize()).length;
if ((p = tab[i = (n – 1) & hash]) == null)
// 新的 bin 节点
tab[i] = newNode(hash, key, value, null);
else {
Node e; K k;
// key 已存在
if (p.hash == hash &&
((k = p.key) == key || (key != null && key.equals(k))))
e = p;
// 散列冲突
else if (p instanceof TreeNode)
e = ((TreeNode)p).putTreeVal(this, tab, hash, key, value);
else {
// 遍历链表
for (int binCount = 0; ; ++binCount) {
// 将新节点插入到链表末尾
if ((e = p.next) == null) {
p.next = newNode(hash, key, value, null);
if (binCount >= TREEIFY_THRESHOLD – 1) // -1 for 1st
treeifyBin(tab, hash);
break;
}
if (e.hash == hash &&
((k = e.key) == key || (key != null && key.equals(k))))
break;
p = e;
}
}
if (e != null) { // existing mapping for key
V oldValue = e.value;
if (!onlyIfAbsent || oldValue == null)
e.value = value;
afterNodeAccess(e);
return oldValue;
}
}
++modCount;
if (++size > threshold)
resize();
afterNodeInsertion(evict);
return null;
}

这个方法哪个地方跟 LinkedHashMap 有联系呢?如何能保持 LinkedHashMap 的顺序呢?且看其中的 newNode() 方法,它在 HashMap 中的代码如下:


Node newNode(int hash, K key, V value, Node next) {
return new Node(hash, key, value, next);
}

但是,LinkedHashMap 重写了该方法:


// 新建一个 LinkedHashMap.Entry 节点
Node newNode(int hash, K key, V value, Node e) {
LinkedHashMap.Entry p =
new LinkedHashMap.Entry(hash, key, value, e);
// 将新节点连接到列表末尾
linkNodeLast(p);
return p;
}


// link at the end of list
private void linkNodeLast(LinkedHashMap.Entry p) {
LinkedHashMap.Entry last = tail;
tail = p;
// list 为空
if (last == null)
head = p;
else {
// 将新节点插入到 list 末尾
p.before = last;
last.after = p;
}
}

可以看到,每次插入新节点时,都会存到列表的末尾。原来如此,LinkedHashMap 的插入顺序就是在这里实现的。

此外,上文分析 HashMap 时提到两个回调方法:afterNodeAccess 和 afterNodeInsertion。它们 在 HashMap 中是空的:


// Callbacks to allow LinkedHashMap post-actions
void afterNodeAccess(Node p) { }
void afterNodeInsertion(boolean evict) { }

同样,LinkedHashMap 对它们进行了重写。先来分析 afterNodeAccess 方法:


void afterNodeAccess(Node e) { // move node to last
LinkedHashMap.Entry last;
// accessOrder 为 true 表示访问顺序
if (accessOrder && (last = tail) != e) {
// p 为访问的节点,b 为其前驱,a 为其后继
LinkedHashMap.Entry p =
(LinkedHashMap.Entry)e, b = p.before, a = p.after;
p.after = null;
// p 是头节点
if (b == null)
head = a;
else
b.after = a;
if (a != null)
a.before = b;
else
last = b;
if (last == null)
head = p;
else {
p.before = last;
last.after = p;
}
tail = p;
++modCount;
}
}

为了便于分析和理解,这里画出了两个操作示意图:

这里描述了进行该操作前后的两种情况。可以看到,该方法执行后,节点 p 被移到了 list 的末尾。

get 方法

LinkedHashMap 重写了 HashMap 的 get 方法,主要是为了维持访问顺序,代码如下:


public V get(Object key) {
Node e;
if ((e = getNode(hash(key), key)) == null)
return null;
// 若为访问顺序,将访问的节点移到列表末尾
if (accessOrder)
afterNodeAccess(e);
return e.value;
}

这里的 getNode 方法是父类的(HashMap)。若 accessOrder 为 true(即指定为访问顺序),则将访问的节点移到列表末尾。

LinkedHashMap 中重写的 afterNodeInsertion 方法:


void afterNodeInsertion(boolean evict) { // possibly remove eldest
LinkedHashMap.Entry first;
if (evict && (first = head) != null && removeEldestEntry(first)) {
K key = first.key;
removeNode(hash(key), key, null, false, true);
}
}


// LinkedHashMap 中默认的返回值为 false,即这里的 removeNode 方法不执行
protected boolean removeEldestEntry(Map.Entry eldest) {
return false;
}

removeNode 方法是父类 HashMap 中的。


final Node removeNode(int hash, Object key, Object value,
boolean matchValue, boolean movable
) {
Node[] tab; Node p; int n, index;
// table 不为空,且给的的 hash 值所在位置不为空
if ((tab = table) != null && (n = tab.length) > 0 &&
(p = tab[index = (n – 1) & hash]) != null) {
Node node = null, e; K k; V v;
// 给定 key 对应的节点,在数组中第一个位置
if (p.hash == hash &&
((k = p.key) == key || (key != null && key.equals(k))))
node = p;
// 给定的 key 所在位置为红黑树或链表
else if ((e = p.next) != null) {
if (p instanceof TreeNode)
node = ((TreeNode)p).getTreeNode(hash, key);
else {
do {
if (e.hash == hash &&
((k = e.key) == key ||
(key != null && key.equals(k)))) {
node = e;
break;
}
p = e;
} while ((e = e.next) != null);
}
}
// 删除节点
if (node != null && (!matchValue || (v = node.value) == value ||
(value != null && value.equals(v)))) {
if (node instanceof TreeNode)
((TreeNode)node).removeTreeNode(this, tab, movable);
else if (node == p)
tab[index] = node.next;
else
p.next = node.next;
++modCount;
–size;
// 删除节点后的操作
afterNodeRemoval(node);
return node;
}
}
return null;
}

afterNodeRemoval 方法在 HashMap 中的实现也是空的:

void afterNodeRemoval(Node p) { }

LinkedHashMap 重写了该方法:


void afterNodeRemoval(Node e) { // unlink
LinkedHashMap.Entry p =
(LinkedHashMap.Entry)e, b = p.before, a = p.after;
p.before = p.after = null;
if (b == null)
head = a;
else
b.after = a;
if (a == null)
tail = b;
else
a.before = b;
}

该方法就是双链表删除一个节点的操作。

代码演练

LinkedHashMap 用法

我们知道 HashMap 是无序的,例如:


Map map = new HashMap();
map.put(“bush”, “a”);
map.put(“obama”, “b”);
map.put(“trump”, “c”);
map.put(“lincoln”, “d”);
System.out.println(map);


// 输出结果(无序):
// {obama=b, trump=c, lincoln=d, bush=a}

而若换成 LinkedHashMap,则可以保持插入的顺序:


Map map = new LinkedHashMap();
map.put(“bush”, “a”);
map.put(“obama”, “b”);
map.put(“trump”, “c”);
map.put(“lincoln”, “d”);
System.out.println(map);


// 输出结果(插入顺序):
// {bush=a, obama=b, trump=c, lincoln=d}

指定 LinkedHashMap 的顺序为访问顺序:


Map map = new LinkedHashMap(2, 0.75f, true);
map.put(“bush”, “a”);
map.put(“obama”, “b”);
map.put(“trump”, “c”);
map.put(“lincoln”, “d”);
System.out.println(map);


map.get(“obama”);
System.out.println(map);


// 输出结果(插入顺序):
// {bush=a, obama=b, trump=c, lincoln=d}


// 访问 obama 后,obama 移到了末尾
// {bush=a, trump=c, lincoln=d, obama=b}

实现 LRU 缓存


private static class LRUCache<K, V> extends LinkedHashMap<K, V> {
private int capacity;

public LRUCache(int capacity) {
super(16, 0.75f, true);
this.capacity = capacity;
}

@Override
protected boolean removeEldestEntry(Map.Entry eldest) {
return size() > capacity;
}
}

使用举例:


LRUCache<String, String> lruCache = new LRUCache(2);
lruCache.put(“bush”, “a”);
lruCache.put(“obama”, “b”);
lruCache.put(“trump”, “c”);
System.out.println(lruCache);


// 输出结果:

// {obama=b, trump=c}

这里定义的 LRUCache 类中,对 removeEldestEntry 方法进行了重写,当缓存中的容量大于 2,时会把最早插入的元素 “bush” 删除。因此只剩下两个值。

小结

1. LinkedHashMap 继承自 HashMap,其结构可以理解为「双链表 + 散列表」;

2. 可以维护两种顺序:插入顺序或访问顺序;

3. 可以方便的实现 LRU 缓存;

4. 线程不安全。

Stay hungry, stay foolish.