学习官网：http://ifeve.com/google-guava/

目录

1. 基本工具

1.1 前置条件

1.2 排序: Guava强大的“流畅风格比较器”

2. 集合

2.1 新集合类型

2.2 集合工具类

---

1. 基本工具

让使用Java语言变得更舒适

1.1 前置条件

让方法中的条件检查更简单。Preconditions类提供了一系列检查参数的方法。 相似Bean Validation，并且Bean Validation注解在方法声明处，更加清晰。Preconditions可以用在方法内，使代码看起来更整洁。

Preconditions.checkArgument(boolean);

1.2 排序: Guava强大的“流畅风格比较器”

链式调用可以自己创建不同场景下适用的比较器，可以运用比较器获取想要的结果

可见：guava-Ordering排序器

2. 集合

Guava对JDK集合的扩展

2.1 新集合类型

1. Multiset

是一种Collection类型，并履行了Collection接口相关的契约 public interface Multiset<E> extends Collection<E> {}

Multiset<Integer> multiset = HashMultiset.create();// 创建 multiset.add(10); // multiset:[10] multiset.add(3);// 添加元素 // multiset:[3,10] multiset.add(6, 3);// 添加多个给定元素 // multiset:[3,6,6,6,10] multiset.remove(6);// 删除元素 // multiset:[3,6,6,10] multiset.remove(3, 2);// 删除多个给定元素 // multiset:[6,6,10] multiset.remove(6, 2); // multiset:[10] multiset.setCount(2, 2);// 设置给定元素在Multiset中的计数 // multiset:[2,2,10] Integer c = multiset.count(2);// 获取指定元素的个数 // 2

创建底层实现源码：

public static <E> HashMultiset<E> create() { return new HashMultiset<E>(); } private HashMultiset() { super(new HashMap<E, Count>()); }

Multiset<E>不是Map<E, Integer>，虽然Map可能是某些Multiset实现的一部分。准确来说Multiset是一种Collection类型，并履行了Collection接口相关的契约。关于Multiset和Map的显著区别还包括：

Multiset中的元素计数只能是正数。任何元素的计数都不能为负，也不能是0。elementSet()和entrySet()视图中也不会有这样的元素。multiset.size()返回集合的大小，等同于所有元素计数的总和。对于不重复元素的个数，应使用elementSet().size()方法。（因此，add(E)把multiset.size()增加1）multiset.iterator()会迭代重复元素，因此迭代长度等于multiset.size()。Multiset支持直接增加、减少或设置元素的计数。setCount(elem, 0)等同于移除所有elem。对multiset 中没有的元素，multiset.count(elem)始终返回0。

2. Multimap

可看作 “键-单个值映射”的集合（a -> 1 a -> 2）或者“键-值集合映射”的映射（a -> [1, 2, 4] b -> 3）。不会有任何键映射到空集合。

Multimap<Integer, Object> multimap = ArrayListMultimap.create(); multimap.put(2, "a");// 键-单个值 // {2=[a]} multimap.putAll(3, Lists.newArrayList("b", "d", "k"));// 键-值集合 // {2=[a], 3=[d, b, k]} Collection<Object> key2 = multimap.get(2);// 以集合形式返回键所对应的值 // key2:["a"] Collection<Object> key3 = multimap.get(3);// key3:["d","b","k"] multimap.remove(3, "k");// 删除键到值的映射 // {2=[a], 3=[d, b]} multimap.removeAll(2);// 清除键对应的所有值 // {3=[d, b]}

创建底层源码：

public static <K, V> ArrayListMultimap<K, V> create() { return new ArrayListMultimap<>(); } private ArrayListMultimap() { this(12, DEFAULT_VALUES_PER_KEY); } private ArrayListMultimap(int expectedKeys, int expectedValuesPerKey) { super(Platform.<K, Collection<V>>newHashMapWithExpectedSize(expectedKeys)); checkNonnegative(expectedValuesPerKey, "expectedValuesPerKey"); this.expectedValuesPerKey = expectedValuesPerKey; } static <K, V> Map<K, V> newHashMapWithExpectedSize(int expectedSize) { return Maps.newHashMapWithExpectedSize(expectedSize); } public static <K, V> HashMap<K, V> newHashMapWithExpectedSize(int expectedSize) { return new HashMap<>(capacity(expectedSize)); }

Multimap<K, V>不是Map<K,Collection<V>>

get(key)总是返回非null、但是可能空的集合。Multimap没有为相应的键花费内存创建了集合，而只是提供一个集合视图方便你为键增加映射值，如下实现：WrappedCollection

Collection<V> get(@Nullable K key); // (List<V>)类型转换，不是真正的List集合 public List<V> get(@Nullable K key) { return (List<V>) super.get(key); } // 生成一个修饰的集合，该集合与提供的键的多重映射中的值保持一致 public Collection<V> get(@Nullable K key) { Collection<V> collection = map.get(key); if (collection == null) { collection = createCollection(key); } return wrapCollection(key, collection); }

2.2 集合工具类

集合接口JDK/Guava对应的Guava工具类提供方法CollectionJDKCollections2 ListJDKLists

newArrayList();// 静态工厂方法 newArrayList(1, 4, 2);// 初始化起始元素 newArrayListWithExpectedSize(10);// 集合初始化大小的可读性：5+10+(10/2) newArrayListWithCapacity(10);// 集合初始化大小的可读性：10 reverse(list);// 反转list partition(list, 3);// 按指定大小分割

SetJDKSets SortedSetJDKSets MapJDKMapsnewHashMap(); newHashMapWithExpectedSize(10); uniqueIndex(list, func);// 根据func获取到list中每项唯一属性值生成map，见代码1SortedMapJDKMaps QueueJDKQueues MultisetGuavaMultisets MultimapGuavaMultimaps BiMapGuavaMaps TableGuavaTables 

代码1：

List<String> list = Lists.newArrayList("hi", "nihaoya", "hello"); ImmutableMap<Integer, String> uniqueIndexMap = Maps.uniqueIndex(list, new Function<String, Integer>() { @Nullable @Override public Integer apply(@Nullable String input) { return Objects.requireNonNull(input).length(); } });// uniqueIndexMap:{2:"hi",7:"nihaoya",5:"hello"}