一、概述

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、不可变集合优点

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

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

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