Guava -- 集合类 和 Guava Cache

Guava -- 集合类 和 Guava Caches

1. 什么是 Guava

Guava 是 google 推出的一个第三方 java 库，用来代替 jdk 的一些公共操作，给我印象特别深的就是 Collection 的扩展和本地缓存的扩展这两个方面了。所以今天也就主要来讲讲 guava 的 collection 和 caches 两方面。

2. 依赖

使用 guava 非常简单，可以直接通过 maven 导入依赖：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>28.0-jre</version>
</dependency>

3. Collection 集合

Guava 给我们提供了一套非常实用的集合工具类 api，减少了原生 java 代码的繁杂。这里简单举例一下：

1. 创建列表：

   List<TypeThatsTooLongForItsOwnGood> list = Lists.newArrayList();

2. 初始化列表也非常简单：

   List<String> theseElements = Lists.newArrayList("alpha", "beta", "gamma");

   对比原生 java 的操作，原生 java 操作就显得过于繁琐了。（先创建 list，再将元素 add 进 list）。

3. 还有创建 map 也非常简单：

   Map<KeyType, LongishValueType> map = Maps.newLinkedHashMap();

更多详细用法可以参考这两份资料，这里只做简单介绍：

• https://zhuanlan.zhihu.com/p/20637960
• https://github.com/kwf2030/guava-userguide-cn/tree/master/集合

4. Caches

guava caches 用来当本地缓存个人认为是一个非常不错的选择。

1. 创建 cache

举个例子：

​```java
private Cache<String, List<Integer>> localCache = CacheBuilder.newBuilder()
            .maximumSize(30)
            .expireAfterWrite(2, TimeUnit.MINUTES)
            .recordStats() 
            .build();
​```

各个参数解释：

• CacheBuilder.newBuilder().build(): 创建一个 Cache 缓存对象。
• maximumSize(30): 设置最大存储为 30 个对象。当存储超过 30 个对象时，最近最久未使用的 key-value 将被回收（LRU 算法）【基于内存占用大小的回收】
• exprieAfterWrite(2, TimeUnit.MINUTES): 设置过期时间，表示 add 到 Cache 中的对象将 2 mins 后过期。【基于时间的回收】
• recordStats() : 开启统计信息开关

2. 查询 or 保存数据

使用 get 方法将数据存入本地缓存中或查询数据。

Cache的get方法有两个参数，第一个参数是要从Cache中获取记录的key，第二个记录是一个Callable对象。当缓存中已经存在key对应的记录时，get方法直接返回key对应的记录。如果缓存中不包含key对应的记录，Guava会启动一个线程执行Callable对象中的call方法，call方法的返回值会作为key对应的值被存储到缓存中，并且被get方法返回。

举个例子：

localCache.get("key", () -> this.queryRedis(platformId, type))

表示将 redis 中查出来的数据放入本地缓存。

可以使用 getall() 方法批量查询

3. 缓存失效

guava 使缓存失效的方法

• invalidate(key)：废弃缓存中当前key对应的所有value值。
• invalidateAll()：废弃缓存中所有的value值。
• invalidateAll(Iterable<?> keys)：废弃传入key集合中对应的所有缓存中的value值。

举个例子：

localCache.invalidateAll() // 使所有缓存失效

4. 查询监控状态

可以对Cache的命中率、加载数据时间等信息进行统计。在构建Cache对象时，可以通过CacheBuilder的recordStats方法开启统计信息的开关。开关开启后Cache会自动对缓存的各种操作进行统计，调用Cache的stats方法可以查看统计后的信息。

localCache.stats();     // 获取统计信息

CacheStats 中的几个方法：

• requestCount()：返回Cache的lookup方法查找缓存的次数，不论查找的值是否被缓存。

• hitCount()：返回Cache的lookup方法命中缓存的次数。

• hitRate()：返回缓存请求的命中率，命中次数除以请求次数。

• missCount()：返回缓存请求的未命中的次数。

• missRate()：返回缓存请求未命中的比率，未命中次数除以请求次数。

• loadCount()：返回缓存调用load方法加载新值的次数。

• loadSuccessCount()：返回缓存加载新值的成功次数。

• loadExceptionCount()：返回缓存加载新值出现异常的次数。

• loadExceptionRate()：返回缓存加载新值出现异常的比率。

• totalLoadTime()：返回缓存加载新值所耗费的总时间。

• averageLoadPenalty()：缓存加载新值的耗费的平均时间，加载的次数除以加载的总时间。

• evictionCount()：返回缓存中条目被移除的次数。

• minus(CacheStats other)：返回一个新的表示当前CacheStats与传入CacheStats之间差异的CacheStats实例。

• plus(CacheStats other)：返回一个新的表示当前CacheStats与传入CacheStats之间总计的CacheStats实例。

5. asMap 方法

在任何Cache上使用asMap以ConcurrentMap视图查看缓存。

如：

ConcurrentMap<String, List<Integer>> map = localCache.asMap(); 

6. 更多详细用法：

• https://segmentfault.com/a/1190000011105644
• https://github.com/kwf2030/guava-userguide-cn/blob/master/缓存/缓存(Caches).md

5. guava 官方文档和中文文档

• 官方文档
• 中文文档

可以翻看官方文档的 wiki，很详细。这两个项目都托管在 GitHub 上。