位于org.apache.commons.collections.map包中的LRUMap,利用LRU(least recently used)算法对最近使用的保留，最不经常使用的会被***，当Map满的时候。该MAP在处理cache时还是挺有用的。
public static void main(String[] args) {
Map lru = new LRUMap(3);
lru.put("1", 1);
lru.put("2", 2);
lru.get("1");
lru.put("3", 3);
lru.put("4", 4);
java.util.Iterator it = lru.keySet().iterator();
while(it.hasNext()){
System.out.println(it.next());
}
}
result:1 3 4
本文通过对Apache Commons Collections 项目中LRUMap这个集合类的源代码进行详细解读，为帮助大家更好的了解这个集合类的实现原理以及使用如何该集合类。
首先介绍一下LRU算法. LRU是由LeastRecently Used的首字母组成，表示最近最少使用的含义，一般使用在对象淘汰算法上。也是比较常见的一种淘汰算法。
LRUMap 则是实现的LRP算法的Map集合类，它继承于AbstractLinkedMap 抽象类。LRUMap的使用说明如下：
LRUMap的初始化时需要指定最大集合元素个数，新增的元素个数大于允许的最大集合个数时，则会执行LRU淘汰算法。所有的元素在LRUMap中会根据最近使用情况进行排序。最近使用的会放在元素的最前面(LRUMap是通过链表来存储元素内容). 所以LRUMap进行淘汰时只需要***链表最后一个即可（即header.after所指的元素对象）
那么那些操作会影响元素的使用情况：
1.put 当新增加一个集合元素对象，则表示该对象是最近被访问的
2.get 操作会把当前访问的元素对象作为最近被访问的，会被移到链接表头
注：当执行containsKey和containsValue操作时，不会影响元素的访问情况。
LRUMap也是非线程安全。在多线程下使用可通过Collections.synchronizedMap(Map)操作来保证线程安全。
LRUMap的一个简单使用示例：
publicstaticvoid main(String[] args) {
LRUMap lruMap = new LRUMap(2);
lruMap.put("a1", "1");
lruMap.put("a2", "2");
lruMap.get("a1");//mark as recent used
lruMap.put("a3", "3");
System.out.println(lruMap);
}
上面的示例，当增加”a3”值时，会淘汰最近最少使用的”a2”, 最后输出的结果为：
{a1=1, a3=3}
LRUMap类的关键代码说明如下：
1.get操作
public Object get(Object key) {
LinkEntry entry = (LinkEntry) getEntry(key);
if (entry == null) {
returnnull;
}
moveToMRU(entry); //执行LRU操作
return entry.getValue();
}
moveToMRU方法代码如下：
protectedvoidmoveToMRU(LinkEntryentry) {
if (entry.after != header) {
modCount++;
// remove 从链接中移除当前节点
entry.before.after = entry.after;
entry.after.before = entry.before;
// add first 把节点增加到链接头部
entry.after = header;
entry.before = header.before;
header.before.after = entry;
header.before = entry;
} elseif (entry == header) {
thrownew IllegalStateException("Can't move header to MRU" +
" (please report this tocommons-dev@jakarta.apache.org)");
}
}
2.put新增操作
由于继承的AbstractLinkedMap，所以put操作会调用addMapping 方法，完整代码如下：
protectedvoid addMapping(int hashIndex, int hashCode, Object key, Object value) {
if (isFull()) {
LinkEntry reuse = header.after;
boolean removeLRUEntry = false;
if (scanUntilRemovable) {
while (reuse != header && reuse != null) {
if (removeLRU(reuse)) {
removeLRUEntry = true;
break;
}
reuse = reuse.after;
}
if (reuse == null) {
thrownew IllegalStateException(
"Entry.after=null, header.after" + header.after + "header.before" + header.before +
" key=" + key + " value=" + value + " size=" + size + "maxSize=" + maxSize +
" Please check that your keys areimmutable, and that you have used synchronization properly." +
" If so, then please report this tocommons-dev@jakarta.apache.org as a bug.");
}
} else {
removeLRUEntry = removeLRU(reuse);
}
if (removeLRUEntry) {
if (reuse == null) {
thrownew IllegalStateException(
"reuse=null,header.after=" + header.after + "header.before" + header.before +
" key=" + key + " value=" + value + " size=" + size + "maxSize=" + maxSize +
" Please check that your keys areimmutable, and that you have used synchronization properly." +
" If so, then please report this tocommons-dev@jakarta.apache.org as a bug.");
}
reuseMapping(reuse, hashIndex, hashCode, key,value);
} else {
super.addMapping(hashIndex, hashCode, key, value);
}
} else {
super.addMapping(hashIndex, hashCode, key, value);
}
}
当集合的个数超过指定的最大个数时，会调用 reuseMapping函数，把要***的对象的key和value更新为新加入的值，并再次加入到链接表中，并重新排定次序。
reuseMapping函数代码如下：
protectedvoid reuseMapping(LinkEntry entry, int hashIndex, int hashCode, Object key, Object value) {
// find the entry before the entry specified in the hashtable
// remember that the parameters (except the first) referto the new entry,
// not the old one
try {
int removeIndex = hashIndex(entry.hashCode, data.length);
HashEntry[] tmp = data; // may protect against some sync
issues
HashEntry loop = tmp[removeIndex];
HashEntry previous = null;
while (loop != entry && loop != null) {
previous = loop;
loop = loop.next;
}
if (loop == null) {
thrownew IllegalStateException(
"Entry.next=null,data[removeIndex]=" + data[removeIndex] + " previous=" + previous +
" key=" + key + " value=" + value + " size=" + size + "maxSize=" + maxSize +
" Please check that your keys areimmutable, and that you have used synchronization properly." +
" If so, then please report this tocommons-dev@jakarta.apache.org as a bug.");
}
// reuse the entry
modCount++;
removeEntry(entry, removeIndex, previous);
reuseEntry(entry, hashIndex, hashCode, key, value);
addEntry(entry, hashIndex);
} catch (NullPointerException ex) {
thrownew IllegalStateException(
"NPE, entry=" + entry + "entryIsHeader=" + (entry==header) +
" key=" + key + " value=" + value + " size=" + size + "maxSize=" + maxSize +
" Please check that your keys are immutable, and that you have usedsynchronization properly." +
" If so, then please report this tocommons-dev@jakarta.apache.org as a bug.");
}
}
上面的代码中：
removeEntry 方法是***最近最少使用的节点在链接中的引用
reuseEntry方法则把该节点的key和value赋新加入的节点的key和value值
addEntry方法则把该节点加入到链接表，并保障相关的链接顺序
/**
* Adds an entryinto this map, maintaining insertion order.
* <p>
* Thisimplementation adds the entry to the data storage table and
* to the end of thelinked list.
*
* @param entry the entry to add
* @param hashIndex the index into the data array to store at
*/
protectedvoidaddEntry(HashEntryentry, int hashIndex) {
LinkEntry link = (LinkEntry) entry;
link.after = header;
link.before = header.before;
header.before.after = link;
header.before = link;
data[hashIndex] = entry;
}
LRUMap的主要源码实现就解读到这里，实现思路还是比较好理解的。
LRUMap的使用场景会比较多，例如可以很方便的帮我们实现基于内存的 LRU 缓存服务实现。
