Guava笔记

基本工具

使用和避免null

很多Guava工具类对Null值都采用快速失败操作，Null的含糊语义让人很不舒服，Null很少可以明确地表示某种语义。

Guava用Optional表示可能为null的T类型引用。一个Optional实例可能包含非null的引用（我们称之为引用存在），也可能什么也不包括（称之为引用缺失）。它从不说包含的是null值，而是用存在或缺失来表示。但Optional从不会包含null值引用。

创建Optional实例（以下都是静态方法）：

Optional.of(T)	创建指定引用的Optional实例，若引用为null则快速失败
Optional.absent()	创建引用缺失的Optional实例
Optional.fromNullable(T)	创建指定引用的Optional实例，若引用为null则表示缺失

用Optional实例查询引用（以下都是非静态方法）：

boolean isPresent()	如果Optional包含非null的引用（引用存在），返回true
T get()	返回Optional所包含的引用，若引用缺失，则抛出java.lang.IllegalStateException
T or(T)	返回Optional所包含的引用，若引用缺失，返回指定的值
T orNull()	返回Optional所包含的引用，若引用缺失，返回null
Set<T> asSet()	返回Optional所包含引用的单例不可变集，如果引用存在，返回一个只有单一元素的集合，如果引用缺失，返回一个空集合。

前置条件

Guava的Preconditions类提供前置条件判断方法，每个方法都有三个变种：

• 没有额外参数：抛出的异常中没有错误消息；
• 有一个Object对象作为额外参数：抛出的异常使用Object.toString() 作为错误消息；
• 有一个String对象作为额外参数，并且有一组任意数量的附加Object对象：这个变种处理异常消息的方式有点类似printf，但考虑GWT的兼容性和效率，只支持%s指示符。

private static void test1(int i, int j) {
	// i > j是判断的表达式，" "中是errorMessage
    checkArgument(i > j, "except i > j , but exactly %s > %s", j , i);
}

public static void main(String[] args) {
    test1(1, 3);
}

方法声明（不包括额外参数）	描述	检查失败时抛出的异常
checkArgument(boolean)	检查boolean是否为true，用来检查传递给方法的参数。	IllegalArgumentException
checkNotNull(T)	检查value是否为null，该方法直接返回value，因此可以内嵌使用checkNotNull。	NullPointerException
checkState(boolean)	用来检查对象的某些状态。	IllegalStateException
checkElementIndex(int index, int size)	检查index作为索引值对某个列表、字符串或数组是否有效。index>=0 && index	IndexOutOfBoundsException
checkPositionIndex(int index, int size)	检查index作为位置值对某个列表、字符串或数组是否有效。index>=0 && index<=size *	IndexOutOfBoundsException
checkPositionIndexes(int start, int end, int size)	检查[start, end]表示的位置范围对某个列表、字符串或数组是否有效	IndexOutOfBoundsException

Objects方法

Object.equals(o1, o2)可以避免对象为null出现异常的情况

public class HelloWord{
	public static void main(String[] args) {
		System.out.println("a".hashCode());
		System.out.println(Objects.hashCode("a"));
		System.out.println(Objects.hash("a"));
	}
}
输出结果：97
          97
          128

"a".hashCode()和Objects.hashCode("a")都是直接调用Object对象的hashCode方法

Objects.hash()可以传入多个对象作为参数，调用的Arrays.hashCode()方法

public static int hashCode(Object a[]) {
	if (a == null)
		return 0;

	int result = 1;

	for (Object element : a)
		result = 31 * result + (element == null ? 0 : element.hashCode());

	return result;
}

比较器

// 所有比较结果均为true返回0， 比较链遇到false直接返回-1
int res = ComparisonChain.start().compare(o1, o2)......result();

private static void test2() {
	System.out.println(ComparisonChain.start()
					   .compare(1, 1)
					   .compare("a", "a")
					   .result());
	System.out.println(ComparisonChain.start().
					   compare("a", "b")
					   .compare(1, 1)
					   .result());
}

输出：0
		-1

排序器「Ordering」

Guava库中实现Comparator的类，提供多种静态方法对对象进行排序

List strings = Arrays.asList("apple", null, "banana", "cat", null);
Ordering<@Nullable Comparable> ordering = Ordering.natural().nullsLast();
strings.sort(ordering);

System.out.println(strings);
// 输出: [apple, banana, cat, null, null]

• natural()：自然排序，根据对象的自然顺序进行排序，例如对于字符串，按照字典顺序进行排序；对于数字，按照数值大小进行排序。
• nullsLast()：用于将空对象放在排序的最后。如果排序的对象中存在空对象，通过调用nullsLast()方法，空对象将被放在排序结果的最后。

当阅读链式调用产生的排序器时，应该从后往前读，因为每次链式调用都是用后面的方法包装了前面的排序器。在一个链中最多使用三个方法，以免造成理解困难

异常

void propagateIfInstanceOf( Throwable, Class) throws X	Throwable类型为X才抛出
void propagateIfPossible( Throwable)	Throwable类型为Error或RuntimeException才抛出
void propagateIfPossible( Throwable, Class) throws X	Throwable类型为X, Error或RuntimeException才抛出

集合

不可变集合

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

• 当对象被不可信的库调用时，不可变形式是安全的；
• 不可变对象被多个线程调用时，不存在线程安全问题；
• 不可变集合不需要考虑变化，因此可以节省时间和空间。所有不可变的集合都比它们的可变形式有更好的内存利用率（分析和测试细节）；
• 不可变对象因为有固定不变，可以作为常量来安全使用。

重要提示：所有Guava不可变集合的实现都不接受null值。我们对Google内部的代码库做过详细研究，发现只有5%的情况需要在集合中允许null元素，剩下的95%场景都是遇到null值就快速失败。

如果你需要在不可变集合中使用null，请使用JDK中的Collections.unmodifiableXXX方法。

构造方式：

1. 使用of方法：使用静态的of方法，可以快速创建不可变集合。
   例如，使用ImmutableList.of()可以创建一个空的不可变列表；使用ImmutableList.of("a", "b", "c")可以创建一个包含元素的不可变列表。类似地，还有ImmutableSet.of()和ImmutableMap.of()等方法。
2. 使用copyOf方法：使用copyOf方法可以将现有的集合复制为不可变集合。
   例如，使用ImmutableList.copyOf(list)可以将现有的列表复制为一个不可变列表。
3. 使用Builder模式：对于复杂的集合构造，可以使用Builder模式来构建不可变集合。
   例如，使用ImmutableList.builder().add("a").add("b").add("c").build()可以创建一个包含元素的不可变列表。
4. 使用Builder的from方法：使用Builder的from方法可以根据现有的集合创建不可变集合。
   例如，使用ImmutableList.builder().addAll(list).build()可以根据现有的列表创建一个不可变列表。

所有不可变集合都有一个asList()方法提供ImmutableList视图，来帮助你用列表形式方便地读取集合元素。例如，你可以使用sortedSet.asList().get(k)从ImmutableSortedSet中读取第k个最小元素。

asList()返回的ImmutableList通常是——并不总是——开销稳定的视图实现，而不是简单地把元素拷贝进List。也就是说，asList返回的列表视图通常比一般的列表平均性能更好，比如，在底层集合支持的情况下，它总是使用高效的contains方法。

可变集合接口	属于JDK还是Guava	不可变版本
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

MultiSet

可以多次添加相等的元素，并且可以统计重复元素的个数

可以用两种方式看待Multiset：

• 没有元素顺序限制的ArrayList
• Map，键为元素，值为计数

// 1.使用HashMultiset（基于哈希表的实现）
Multiset<@Nullable Object> hashMultiset = HashMultiset.create();
// 2.使用TreeMultiset（基于红黑树的实现），可以对元素进行排序
TreeMultiset treeMultiset = TreeMultiset.create();
// 3.使用LinkedHashMultiset（基于链表的实现），保留元素的插入顺序
LinkedHashMultiset<@Nullable Object> linkedHashMultiset = LinkedHashMultiset.create();
// 4.使用EnumMultiset（基于枚举类型的实现），适用于枚举类型的元素
EnumMultiset enumMultiset = EnumMultiset.create(MyEnum.class);
// 5.
ConcurrentHashMultiset