Guava Cache 入门

Guava Cache

Guava Cache 来自于 Google 开源的 Guava 类库，是一个实现比较完善的本地缓存。

使用

先声明一个 CacheBuilder 对象，并设置缓存的相关参数，然后调用其 build 方法获得一个 Cache 接口的实例。

两种创建方式：

1. 使用 CacheLoader 创建，适用于在创建时加载指定缓存。

 LoadingCache<Integer, String> cache = CacheBuilder.newBuilder()
                // 设置并发级别为8，并发级别是指可以同时写缓存的线程数
                .concurrencyLevel(8)
                // 设置写缓存后8秒钟过期
                .expireAfterWrite(8, TimeUnit.SECONDS)
                // 设置缓存容器的初始容量为10
                .initialCapacity(10)
                // 设置缓存最大容量为100，超过100之后会按照LRU最近最少使用算法来移除缓存
                .maximumSize(100)
                // 设置要统计缓存的命中率
                .recordStats()
                // 设置缓存的移除通知
                .removalListener(notification -> log.info("{} was removed, cause is {}", notification.getKey(), notification.getCause()))
                .build(
                        // 指定CacheLoader，在缓存不存在时通过CacheLoader的实现自动加载缓存
                        new CacheLoader<Integer, String>() {
                            @Override
                            public String load(Integer key) {
                                log.info("load data: {}", key);
                                return key + ":cache-value";
                            }
                        });

2. 使用 Callable 创建，适用于在缓存汇总获取不到数据时，动态加载数据到缓存

        Cache<String, String> cache = CacheBuilder.newBuilder()
                .maximumSize(100)
                .build();

        cache.get("test", () -> "test-value");

缓存数据删除

被动删除

1. 基于数据大小删除
   当缓存容量达到指定大小时，就会把不常用的键值对从 cache 中移除。通过 CacheBuilder.maximumSize(size) 方法进行设置。

2. 基于过期时间删除

   • expireAfterWrite(long duration, TimeUnit unit) ：某个 key 被创建后，再隔多长时间后删除
   • expireAfterAccess(long duration, TimeUnit unit) ：某个 key 最后一次访问后，，再隔多长时间后删除

3. 基于引用删除
   基于 Java 的垃圾回收机制，判断缓存的数据引用的关系，如果没有被引用，则移除对应数据。

主动删除

• void invalidate(Object key) ：将某个 key 的缓存直接置为无效
• void invalidateAll(Iterable<?> keys) ：将一批 keys 的缓存直接置为无效
• void invalidateAll() ：删除所有缓存数据

更新锁定

当请求查询某个 key 时，如果不存在则从数据源中读取，然后再写入到缓存中。如果并发量大，可能会有多个请求同时从数据源中读取数据，Guava Cache 可以在 CacheLoader 的 load 方法中加以控制，对同一个 key ，只让一个请求去数据源中读取数据，而其他请求阻塞等待结果。同时，还可以通过 refreshAfterWrite 定时刷新数据的配置项，使得阻塞的请求在一个固定的时间段内未获得新值就直接返回旧值。

参考

GitHub 代码
深入分布式缓存：从原理到实践