一、概述

Guava 是一组来自Google的核心Java库，包括新的集合类型（如多映射和多集）、不可变集合、图库和并发、I/O、哈希、原语、字符串等实用程序！它广泛用于Google中的大多数Java项目，也被许多其他公司广泛使用。

Guava 开发要求：

JRE风格需要JDK 1.8或更高版本。

如果您需要支持Android，请使用Android风格。您可以在Android目录中找到Android Guava源代码。

guava github 开源地址：GitHub - google/guava: https://github.com/google/guava

官网用户手册：https://github.com/google/guava/wiki

guava 的Maven groupID是com.google.Guava，其artifact ID是guava。Guava提供了两种不同的"风格"：一种用于（Java 8+）JRE，另一种用于Android或任何希望与Android兼容的库。这些口味在Maven版本字段中指定为32.1.2-jre或32.1.2-安卓。

com.google.guava 依赖：

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>32.1.2-jre</version>
  <!-- or, for Android: -->
  <version>32.1.2-android</version>
</dependency>

二、使用Guava

Guava项目包含我们在基于Java的项目中依赖的几个Google核心库：集合、缓存、原语支持、并发库、通用注释、字符串处理、I/O等。这些工具中的每一个确实每天都被谷歌人用于生产服务。

但浏览Javadoc并不总是学习如何最好地利用库的最有效方法。

基本使用：

使用和避免null:null可能是模棱两可的，可能会导致令人困惑的错误，有时只是令人不快。许多Guava公用事业拒绝并在空值上快速失败，而不是盲目接受它们。
先决条件：更容易地测试方法的先决条件。
通用对象方法：简化object方法的实现，如hashCode（）和toString（）。
Ordering：Guava强大的"流畅比较器"类。
Throwables：简化传播和检查异常和错误。

Collections：Guava对JDK收藏生态系统的扩展。这些是番石榴最成熟和最受欢迎的部分。

不可变集合，用于防御编程、常量集合和提高的效率。
新的集合类型，用于JDK集合不能很好地处理的用例：多集合、多映射、表、双向映射等。
强大的收集实用程序，用于java.util.Collections中未提供的常见操作。
扩展实用程序：编写集合装饰器？实现迭代器？我们可以让这变得更容易。

图：用于建模图结构数据的库，即实体及其之间的关系。主要功能包括：

图：其边是匿名实体的图，没有自己的标识或信息。
ValueGraph：其边具有关联的非唯一值的图。
网络：其边是唯一对象的图。
支持可变和不可变、有向和无向的图以及其他几个属性。

缓存：本地缓存，处理得当，并支持各种过期行为。
功能习语 ：谨慎使用，Guava的功能习语可以显著简化代码。
并发：强大、简单的抽象，使编写正确的并发代码变得更容易

ListenableFuture：Futures，完成时回调。
服务：启动和关闭的东西，为您处理困难的状态逻辑。

String ：一些非常有用的字符串实用程序：拆分、连接、填充等。
Primitive ：JDK不提供的对基本体类型（如int和char）的操作，包括某些类型的无符号变体。
范围：Guava强大的API，用于处理可比较类型的范围，包括连续和离散。
I/O ：简化了Java 5和6的I/O操作，特别是在整个I/O流和文件上。
哈希：用于比Object.hashCode（）提供的更复杂哈希的工具，包括Bloom过滤器。
EventBus ：在组件之间发布订阅样式的通信，而不要求组件彼此显式注册。
Math ：JDK未提供的优化、经过彻底测试的数学实用程序。
反射：用于Java反射功能的Guava实用程序。

三、不可变集合

1、例子

public static final ImmutableSet<String> COLOR_NAMES = ImmutableSet.of(
  "red",
  "orange",
  "yellow",
  "green",
  "blue",
  "purple");

class Foo {
  final ImmutableSet<Bar> bars;
  Foo(Set<Bar> bars) {
    this.bars = ImmutableSet.copyOf(bars); // defensive copy!
  }
}

2、不可变集合优点

不可变对象具有许多优点，包括：

不受信任的库可以安全使用。
线程安全：可以由许多线程使用，没有竞争条件的风险。
不需要支持突变，并且可以通过该假设节省时间和空间。所有不可变集合实现都比其可变同级更节省内存。（分析）
可以用作常量，预期它将保持固定。

3、不可变集合使用

ImmutableXXX集合可以通过几种方式创建：

使用copyOf方法，例如ImmutableSet.copyOf（set）
使用of方法，例如，ImmutableSet.of（"a"，"b"，"c"）或ImmutablesMap.of（（"a"，1，"b"，2）
例如，使用生成器，

public static final ImmutableSet<Color> GOOGLE_COLORS =
ImmutableSet.<Color>builder()
.addAll(WEBSAFE_COLORS)
.add(new Color(0, 191, 255))
.build();

Guava 为 java jdk 每种标准集合类型提供了简单易用的不可变版本，包括 Guava 自己的集合变体，为 java 提供的不可变版本都是继承 java jdk 的接口而来，所以操作上基本无异。下面接口的实现类也都有对应的不可变版本。

|------------------------|---------------|-----------------------------|
| Interface | JDK or Guava? | Immutable Version |
| Collection | JDK | ImmutableCollection |
| List | JDK | ImmutableList |
| Set | JDK | ImmutableSet |
| SortedSet/NavigableSet | JDK | ImmutableSortedSet |
| Map | JDK | ImmutableMap |
| SortedMap | JDK | ImmutableSortedMap |
| Multiset | Guava | ImmutableMultiset |
| SortedMultiset | Guava | ImmutableSortedMultiset |
| Multimap | Guava | ImmutableMultimap |
| ListMultimap | Guava | ImmutableListMultimap |
| SetMultimap | Guava | ImmutableSetMultimap |
| BiMap | Guava | ImmutableBiMap |
| ClassToInstanceMap | Guava | ImmutableClassToInstanceMap |
| Table | Guava | ImmutableTable |