google cache接口

叁歲伎倆 2023-03-13 03:45 4阅读 0赞

介绍一个 google cache \[本地缓存\]，最近在做一些优化，优化的方面也包含了缓存，下面就先介绍一下 google cache 的 cache 接口。

#### Cache<K,V> 接口 ####

*  这个接口的实现应该是线程安全的，并且可以被多个并发线程安全访问

#### 方法 ####

##### getIfPresent(Object key) #####

*  如果这个 key 在缓存中，那么就可以通过调用该方法来命中缓存，返回返回缓存的 value
 *  如果这个 key 不在缓存中，那么就无法命中缓存，那么就会返回 null

##### get(K key, Callable<? extends V> valueLoader) throws ExecutionException #####

*  如果 key 在缓存中命中，则通过 valueLoader 返回该缓存的 value ，且在加在完成之前该缓存的可观察状态不会被修改。
 *  当加载缓存的时候，如果遇到一个受检异常，会抛出 ExecutionException
 *  当加载缓存的时候，如果遇到一个非受检异常，会抛出 UncheckedExecutionException
 *  当加载缓存的时候，如果遇到一个错误，会抛出 ExecutionError

##### getAllPresent #####

*  入参是一个 key 的集合，是 Iterable类型
 *  返回值是一个 ImmutableMap<K, V> 类型
 *  该方法会返回一个与缓存中的 key 关联的 map，返回的 map 中只会包含在缓存中存在的内容

##### put #####

*  入参是缓存的 key 和 value
 *  返回值是 void 类型
 *  该方法会根据 key 和 value 将数据存储在缓存中，如果缓存中该 key 已经存在对应的 value,那么该 key 对应的 value 会被最新的 value 所覆盖。

##### putAll #####

*  入参是一个 map 类型
 *  返回值是 void类型
 *  将所有映射从指定映射复制到缓存。对于指定映射中从键到值的每个映射，此调用的效果等效于对该映射调用一次 put（k，v）的效果。如果在操作进行过程中修改了指定的映射，则此操作的行为是不确定的。

##### invalidate(Object key) #####

*  入参是缓存的 key，是一个 object 类型
 *  返回值是 void 类型
 *  删除该 key 对应的缓存

##### invalidateAll(Iterable<?> keys) #####

*  入参是一个 Iterable类型，对应的是缓存的 key
 *  返回值是 void类型
 *  删除缓存中指定的 key 集合对应的缓存

##### invalidateAll() #####

*  没有入参
 *  返回值类型是 void
 *  清除缓存中的所有缓存项

##### size() #####

*  返回缓存中的缓存项的数量大小

##### stats() #####

*  没有入参
 *  返回值类型是 CacheStats
 *  返回此缓存的累积统计信息的当前快照。所有统计信息均初始化为零，并在缓存的整个生命周期内单调增加。

##### asMap() #####

*  没有入参
 *  返回值类型是 ConcurrentMap
 *  以线程安全映射的形式返回存储在此缓存中的条目的视图。对 map 的修改将直接影响缓存。
 *  返回的映射中的迭代器至少是弱一致性的：它们可以安全地并发使用，但是如果在创建迭代器后修改了缓存（包括通过逐出），则尚不确定哪个更改（如果有）将反映在其中该迭代器。

##### cleanUp() #####

*  没有入参
 *  返回值类型是 void 类型
 *  通过执行缓存所需要的任何未决的维护操作。 究竟哪些活动执行 - 如果有的话 - 是实现相关的

package com.google.common.cache;
    
    import com.google.common.annotations.Beta;
    import com.google.common.annotations.GwtCompatible;
    import com.google.common.collect.ImmutableMap;
    import com.google.common.util.concurrent.ExecutionError;
    import com.google.common.util.concurrent.UncheckedExecutionException;
    
    import java.util.Map;
    import java.util.concurrent.Callable;
    import java.util.concurrent.ConcurrentMap;
    import java.util.concurrent.ExecutionException;
    
    import javax.annotation.Nullable;
    
    @Beta
    @GwtCompatible
    public interface Cache<K, V> { 
    
      @Nullable
      V getIfPresent(Object key);
    
      V get(K key, Callable<? extends V> valueLoader) throws ExecutionException;
    
      ImmutableMap<K, V> getAllPresent(Iterable<?> keys);
    
      void put(K key, V value);
    
      void putAll(Map<? extends K,? extends V> m);
    
      void invalidate(Object key);
    
      void invalidateAll(Iterable<?> keys);
    
      void invalidateAll();
    
      long size();
    
      CacheStats stats();
    
      ConcurrentMap<K, V> asMap();
    
      void cleanUp();
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI5MzQzMjU_size_16_color_FFFFFF_t_70_pic_center]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTI5MzQzMjU_size_16_color_FFFFFF_t_70_pic_center]: /images/20230312/8f52502400c748a0b868134aaa4405e5.png