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 代码的繁杂。这里简单举例一下：

创建列表：

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

初始化列表也非常简单：
```
List<String> theseElements = Lists.newArrayList("alpha", "beta", "gamma");
```
对比原生 java 的操作，原生 java 操作就显得过于繁琐了。（先创建 list，再将元素 add 进 list）。

还有创建 map 也非常简单：

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

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

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. 更多详细用法：

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

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