Guava缓存器源码分析——LocalCache

  

 

    上图为缓存器所涉及的大致类图，与缓存器配置相关的参数都封装进了CacheBuilder中，与缓存器载入数据相关的操作都封装进了CacheLoader中，并将CacheLoader设计为抽象类，数据载入方法由用户自己实现。因此，用户可以有两种方式来创建缓存器：

    1、配置完参数后，直接创建

        Cache build() 

        build函数内部，通过调用new LocalCache.LocalManualCache(this)，创建的缓存器类型为 Cache，在使用缓存器时，需要实现Callable接口的call方法来实现数据载入，如下：

       yourCache.get(key, new Callable() {
              @Override
              public String call() throws Exception {
                     System.out.println("getKey()");
              }
       });

    2、配置参数并实现数据载入方法

       LoadingCache build( CacheLoader loader)

       CacheLoader为抽象类，有几个常用方法：

       1）V load(K key)  ：检索或计算key的关联值，返回的值不能为null。

       2）ListenableFuture reload(K key, V oldValue)  ：重新计算已存在的键值。

       3）Map loadAll(Iterable keys) ：检索或计算keys关联的所有值，这个方法会被getAll方法调用，如果返回结果中没有包含所有请求keys的关联值，返回结果仍会被缓存，但getAll会抛出异常；如果返回结果中包含请求keys之外的键值，这些键值会被缓存，但不会被getAll返回。一般我们都会重载load方法，但是当批量检索比单个检索更有优势时，可以重载这个方法。

        通过load方法来载入数据：              

       build(

              new CacheLoader() {

                      public Integer load(String key) throws Exception {

                           return loadKey(key);

                     }

              });

        build函数内部，通过调用new LocalCache.LocalLoadingCache(this, loader)，创建的缓存器类型为LoadingCache。

       

        除了缓冲器的构建，对缓存器的实际操作也都封装在LocalCache类中，Guava通过将LocalManualCache与LocalLoadingCache设计为LocalCache的静态内部类，并在LocalManualCache类中设置一个final修饰的LocalCache成员变量，在缓存器构建时完成对LocalCache成员变量的初始化，这样不管缓存器是Cache或LoadingCache类型，用户对缓存器的操作都可以转换为对LocalCache的操作。

       并且，由于LocalLoadingCache继承至LocalManualCache，两个类需要重载的方法，除了与数据载入相关的，其它都可交由LocalManualCache实现，重载方法的实现形式基本如下：

     @Override

    public void put(K key, V value) {

      localCache.put(key, value);

    }

     @Override

    @Nullable

    public V getIfPresent(Object key) {

      return localCache.getIfPresent(key);

    }

        LocalManualCache重载了getIfPresent、get、getAllPresent、put、invalidate、invalidateAll、size、asMap、stats、cleanUp方法。

        LocalLoadingCache重载了get、getUnchecked、getAll、refresh、apply方法。