Guava -- 集合类 和 Guava Cache

时间:2021-11-27 10:12:37

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();

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

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上使用asMapConcurrentMap视图查看缓存。

如:

ConcurrentMap<String, List<Integer>> map = localCache.asMap();
6. 更多详细用法:

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

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