【源代码】LruCache源代码剖析

上一篇分析了LinkedHashMap源代码,这个Map集合除了拥有HashMap的大部分特性之外。还拥有链表的特点,即能够保持遍历顺序与插入顺序一致。

另外。当我们将accessOrder设置为true时。能够使遍历顺序和訪问顺序一致,其内部双向链表将会依照最近最少訪问到最近最多訪问的顺序排列Entry对象,这能够用来做缓存。


这篇文章分析的LruCache并非jdk中的类,而是来自安卓,熟悉安卓内存缓存的必定对这个类不陌生。

LruCache内部维护的就是一个LinkedHashMap。
以下開始分析LruCache。
注:以下LruCache源代码来自support.v4包。

首先是这个类的成员变量:
 private final LinkedHashMap<K, V> map;
    /** Size of this cache in units. Not necessarily the number of elements. */
    private int size;//当前大小
    private int maxSize;//最大容量
    private int putCount;//put次数
    private int createCount;//create次数
    private int evictionCount;//回收次数
    private int hitCount;//命中次数
    private int missCount;//丢失次数
LinkedHashMap的初始化放在构造器中:
public LruCache(int maxSize) {
        if (maxSize <= 0) {
            throw new IllegalArgumentException("maxSize <= 0");
        }
        this.maxSize = maxSize;
        this.map = new LinkedHashMap<K, V>(0, 0.75f, true);
    }

这里将LinkedHashMap的accessOrder设置为true。

接下来看两个最重要的方法,put和get。

首先是put方法:

public final V put(K key, V value) {
        if (key == null || value == null) {//键值不同意为空
            throw new NullPointerException("key == null || value == null");
        }
        V previous;
        synchronized (this) {//线程安全
            putCount++;
            size += safeSizeOf(key, value);
            previous = map.put(key, value);
            if (previous != null) {//之前已经插入过同样的key
                size -= safeSizeOf(key, previous);//那么减去该entry的容量,由于发生覆盖
            }
        }
        if (previous != null) {
            entryRemoved(false, key, previous, value);//这种方法默认空实现
        }
        trimToSize(maxSize);//若容量超过maxsize,将会删除近期非常少訪问的entry
        return previous;
    }
put方法无非就是调用LinkedHashMap的put方法。可是这里在调用LinkedHashMap的put方法之前,推断了key和value是否为空,也就是说LruCache不同意空键值

除此之外,put操作被加锁了,所以是线程安全的

既然是缓存,那么必定可以动态删除一些不经常使用的键值对,这个工作是由trimToSize方法完毕的:
 public void trimToSize(int maxSize) {
        while (true) {//不断删除linkedHashMap头部entry,也就是近期最少訪问的条目。直到size小于最大容量
            K key;
            V value;
            synchronized (this) {//线程安全
                if (size < 0 || (map.isEmpty() && size != 0)) {
                    throw new IllegalStateException(getClass().getName()
                            + ".sizeOf() is reporting inconsistent results!");
                }
                if (size <= maxSize || map.isEmpty()) {//直到容量小于最大容量为止
                    break;
                }
                Map.Entry<K, V> toEvict = map.entrySet().iterator().next();//指向链表头
                key = toEvict.getKey();
                value = toEvict.getValue();
                map.remove(key);//删除最少訪问的entry
                size -= safeSizeOf(key, value);
                evictionCount++;
            }
            entryRemoved(true, key, value, null);
        }
    }

这种方法不断循环删除链表首部元素。也就是近期最少訪问的元素,直到容量不超过预先定义的最大值为止。
注:LruCache在android.util包中也有一个LruCache类,可是我发现这个类的trimToSize方法是错误的:
private void trimToSize(int maxSize) {
        while (true) {
            K key;
            V value;
            synchronized (this) {
                if (size < 0 || (map.isEmpty() && size != 0)) {
                    throw new IllegalStateException(getClass().getName()
                            + ".sizeOf() is reporting inconsistent results!");
                }
                if (size <= maxSize) {
                    break;
                }
            
                Map.Entry<K, V> toEvict = null;
                for (Map.Entry<K, V> entry : map.entrySet()) {
                    toEvict = entry;
                }
    
                if (toEvict == null) {
                    break;
                }
                key = toEvict.getKey();
                value = toEvict.getValue();
                map.remove(key);
                size -= safeSizeOf(key, value);
                evictionCount++;
            }
            entryRemoved(true, key, value, null);
        }
    }
这里的代码将会循环删除链表尾部,也就是近期訪问最多的元素,这是不对的!所以大家在做内存缓存的时候一定要注意,看trimToSize方法是否有问题。

接下来是get方法:
public final V get(K key) {
        if (key == null) {//不同意空键
            throw new NullPointerException("key == null");
        }
        V mapValue;
        synchronized (this) {//线程安全
            mapValue = map.get(key);//调用LinkedHashMap的get方法
            if (mapValue != null) {
                hitCount++;//命中次数加1
                return mapValue;//返回value
            }
            missCount++;//未命中
        }

        V createdValue = create(key);//默认返回为false
        if (createdValue == null) {
            return null;
        }
        synchronized (this) {
            createCount++;//假设创建成功,那么create次数加1
            mapValue = map.put(key, createdValue);//放到哈希表中
            if (mapValue != null) {
                // There was a conflict so undo that last put
                map.put(key, mapValue);
            } else {
                size += safeSizeOf(key, createdValue);
            }
        }
        if (mapValue != null) {
            entryRemoved(false, key, createdValue, mapValue);
            return mapValue;
        } else {
            trimToSize(maxSize);
            return createdValue;
        }
    }

get方法即依据key在LinkedHashMap中寻找相应的value,此方法也是线程安全的。

以上就是LruCache最重要的部分,以下再看下其它方法:
remove:
  public final V remove(K key) {
        if (key == null) {
            throw new NullPointerException("key == null");
        }
        V previous;
        synchronized (this) {
            previous = map.remove(key);//调用LinkedHashMap的remove方法
            if (previous != null) {
                size -= safeSizeOf(key, previous);
            }
        }
        if (previous != null) {
            entryRemoved(false, key, previous, null);
        }
        return previous;//返回value
    }

sizeof:这种方法用于计算每一个条目的大小,子类必须得复写这个类。
 protected int sizeOf(K key, V value) {//用于计算每一个条目的大小
        return 1;
    }
snapshot方法,返回当前缓存中全部的条目集合
 public synchronized final Map<K, V> snapshot() {
        return new LinkedHashMap<K, V>(map);
    }

总结:
1.LruCache封装了LinkedHashMap。提供了LRU缓存的功能;
2.LruCache通过trimToSize方法自己主动删除近期最少訪问的键值对。
3.LruCache不同意空键值;
4.LruCache线程安全。
5.继承LruCache时,必需要复写sizeof方法。用于计算每一个条目的大小。






posted @ 2017-07-18 18:44  lytwajue  阅读(141)  评论(0编辑  收藏  举报