005-guava 集合-集合工具类-java.util.Collections中未包含的集合工具[Maps,Lists,Sets]，Iterables、Multisets、Multimaps、Tables

一、概述

　　工具类与特定集合接口的对应关系归纳如下：

集合接口	属于JDK还是Guava	对应的Guava工具类
Collection	JDK	`Collections2`：不要和java.util.Collections混淆
List	JDK	`Lists`
Set	JDK	`Sets`
SortedSet	JDK	`Sets`
Map	JDK	`Maps`
SortedMap	JDK	`Maps`
Queue	JDK	`Queues`
Multiset	Guava	`Multisets`
Multimap	Guava	`Multimaps`
BiMap	Guava	`Maps`
Table	Guava	`Tables`

二、使用

2.1、静态工厂方法-创建型工具类

　　guava 为创建基本类型集合提供上述工具类创建，为自建集合类型提供create方式创建，工具类如上

    @Test

    public void testNewInstance() {

        //jdk 7 之前

        List<String> list1 = new ArrayList<String>();

        //jdk 7 之后

        List<String> list2 = new ArrayList<>();

        //Guava的静态工厂方法

        ArrayList<String> list3 = Lists.newArrayList();

        ArrayList<String> list4 = Lists.newArrayList("a","b");

        ArrayList<String> list5 = Lists.newArrayListWithCapacity(100);

        // guava 集合创建

        Multiset<String> multiset = HashMultiset.create();

    }

　　Guava引入的新集合类型没有暴露原始构造器，也没有在工具类中提供初始化方法。而是直接在集合类中提供了静态工厂方法

2.2、工具类-Iterables

　　在可能的情况下，Guava提供的工具方法更偏向于接受Iterable而不是Collection类型。在Google，对于不存放在主存的集合——比如从数据库或其他数据中心收集的结果集，因为实际上还没有攫取全部数据，这类结果集都不能支持类似size()的操作 ——通常都不会用Collection类型来表示。

　　因此，很多你期望的支持所有集合的操作都在Iterables类中。大多数Iterables方法有一个在Iterators类中的对应版本，用来处理Iterator。

常规方法

`concat(Iterable<Iterable>)`	串联多个iterables的懒视图*	`concat(Iterable...)`
`frequency(Iterable, Object)`	返回对象在iterable中出现的次数	与Collections.frequency (Collection, Object)比较；Multiset
`partition(Iterable, int)`	把iterable按指定大小分割，得到的子集都不能进行修改操作	`Lists.partition(List, int)`；`paddedPartition(Iterable, int)`
`getFirst(Iterable, T default)`	返回iterable的第一个元素，若iterable为空则返回默认值	与Iterable.iterator(). next()比较;`FluentIterable.first()`
`getLast(Iterable)`	返回iterable的最后一个元素，若iterable为空则抛出NoSuchElementException	`getLast(Iterable, T default)`； `FluentIterable.last()`
`elementsEqual(Iterable, Iterable)`	如果两个iterable中的所有元素相等且顺序一致，返回true	与List.equals(Object)比较
`unmodifiableIterable(Iterable)`	返回iterable的不可变视图	与Collections. unmodifiableCollection(Collection)比较
`limit(Iterable, int)`	限制iterable的元素个数限制给定值	`FluentIterable.limit(int)`
`getOnlyElement(Iterable)`	获取iterable中唯一的元素，如果iterable为空或有多个元素，则快速失败	`getOnlyElement(Iterable, T default)`

示例

    @Test

    public void testIterables() {

        ArrayList<String> ab = Lists.newArrayList("a","b");

        ArrayList<String> bc = Lists.newArrayList("b","c");

        Iterable<String> concat = Iterables.concat(ab, bc);

        System.out.println(concat);//[a, b, b, c]

        Iterable<List<String>> lists = Iterables.paddedPartition(ab,1);

        System.out.println(lists);//[[a], [b]]

    }

其他操作方法

与Collection方法相似的工具方法

方法	类似的Collection方法	等价的FluentIterable方法
`addAll(Collection addTo, Iterable toAdd)`	Collection.addAll(Collection)
`contains(Iterable, Object)`	Collection.contains(Object)	`FluentIterable.contains(Object)`
`removeAll(Iterable removeFrom, Collection toRemove)`	Collection.removeAll(Collection)
`retainAll(Iterable removeFrom, Collection toRetain)`	Collection.retainAll(Collection)
`size(Iterable)`	Collection.size()	`FluentIterable.size()`
`toArray(Iterable, Class)`	Collection.toArray(T[])	`FluentIterable.toArray(Class)`
`isEmpty(Iterable)`	Collection.isEmpty()	`FluentIterable.isEmpty()`
`get(Iterable, int)`	List.get(int)	`FluentIterable.get(int)`
`toString(Iterable)`	Collection.toString()	`FluentIterable.toString()`

2.3、工具类-FluentIterable

除了上面提到的方法，FluentIterable还有一些便利方法用来把自己拷贝到不可变集合

ImmutableList
ImmutableSet	`toImmutableSet()`
ImmutableSortedSet	`toImmutableSortedSet(Comparator)`

2.4、工具类-LIsts、Sets、Maps

Lists

方法	描述
`partition(List, int)`	把List按指定大小分割
`reverse(List)`	返回给定List的反转视图。注: 如果List是不可变的，考虑改用`ImmutableList.reverse()`。

Sets

集合理论方法

我们提供了很多标准的集合运算（Set-Theoretic）方法，这些方法接受Set参数并返回SetView，可用于：

直接当作Set使用，因为SetView也实现了Set接口；
用copyInto(Set)拷贝进另一个可变集合；
用immutableCopy()对自己做不可变拷贝。

方法

union(Set, Set)

intersection(Set, Set)

difference(Set, Set)

symmetricDifference(Set, Set)

其他Set工具方法

方法	描述	另请参见
`cartesianProduct(List<Set>)`	返回所有集合的笛卡儿积	`cartesianProduct(Set...)`
`powerSet(Set)`	返回给定集合的所有子集

Maps

uniqueIndex

Maps.uniqueIndex(Iterable,Function)通常针对的场景是：有一组对象，它们在某个属性上分别有独一无二的值，而我们希望能够按照这个属性值查找对象——译者注：这个方法返回一个Map，键为Function返回的属性值，值为Iterable中相应的元素，因此我们可以反复用这个Map进行查找操作。

比方说，我们有一堆字符串，这些字符串的长度都是独一无二的，而我们希望能够按照特定长度查找字符串：

    class Person {

        private String name;

        private Integer age;

        public Person(String name, Integer age) {

            this.name = name;

            this.age = age;

        }

        @Override

        public String toString() {

            return "Person{" +

                    "name='" + name + '\'' +

                    ", age=" + age +

                    '}';

        }

    }

    @Test

    public void testMapsuniqueIndex() {

        ArrayList<Person> list = Lists.newArrayList(new Person("lhx", 22), new Person("zl", 20));

        // 得到以name为key，Person为值的一个map

        ImmutableMap<String, Person> uniqueIndex = Maps.uniqueIndex(list, p -> p.name);

        System.out.println(uniqueIndex);//{lhx=Person{name='lhx', age=22}, zl=Person{name='zl', age=20}}

        list.add(new Person("lhx", 32));

        // 报错 索引不唯一

        //ImmutableMap<String, Person> uniqueIndex2 = Maps.uniqueIndex(list, p -> p.name);

        //System.out.println(uniqueIndex2);

    }

如果索引值不是独一无二的，请参见下面的Multimaps.index方法。

difference

Maps.difference(Map, Map)用来比较两个Map以获取所有不同点。该方法返回MapDifference对象，把不同点的维恩图分解为：

`entriesInCommon()`	两个Map中都有的映射项，包括匹配的键与值
`entriesDiffering()`	键相同但是值不同值映射项。返回的Map的值类型为`MapDifference.ValueDifference`，以表示左右两个不同的值
`entriesOnlyOnLeft()`	键只存在于左边Map的映射项
`entriesOnlyOnRight()`	键只存在于右边Map的映射项

示例：

    @Test

    public void testMapsdifference() {

        Map<String, Integer> left = ImmutableMap.of("a", 1, "b", 2, "c", 3);

        Map<String, Integer> right = ImmutableMap.of("a", 1, "b", 3, "e", 5);

        MapDifference<String, Integer> diff = Maps.difference(left, right);

        Map<String, Integer> stringIntegerMap;

        //两个Map中都有的映射项，包括匹配的键与值

        stringIntegerMap = diff.entriesInCommon();

        System.out.println(stringIntegerMap);//{a=1}

        //键相同但是值不同值映射项。

        Map<String, MapDifference.ValueDifference<Integer>> differing = diff.entriesDiffering();

        System.out.println(differing);//{b=(2, 3)}

        //键只存在于左边Map的映射项

        stringIntegerMap = diff.entriesOnlyOnLeft();

        System.out.println(stringIntegerMap);//{c=3}

        //键只存在于右边Map的映射项

        stringIntegerMap = diff.entriesOnlyOnRight();

        System.out.println(stringIntegerMap);//{e=5}

    }

处理BiMap的工具方法

Guava中处理BiMap的工具方法在Maps类中，因为BiMap也是一种Map实现。

BiMap工具方法	相应的Map工具方法
`synchronizedBiMap(BiMap)`	Collections.synchronizedMap(Map)
`unmodifiableBiMap(BiMap)`	Collections.unmodifiableMap(Map)

2.5、工具类-Multisets、Multimaps、Tables

Multisets方法

方法	说明	和Collection方法的区别
`containsOccurrences(Multiset sup, Multiset sub)`	对任意o，如果sub.count(o)<=super.count(o)，返回true	Collection.containsAll忽略个数，而只关心sub的元素是否都在super中
`removeOccurrences(Multiset removeFrom, Multiset toRemove)`	对toRemove中的重复元素，仅在removeFrom中删除相同个数。	Collection.removeAll移除所有出现在toRemove的元素
`retainOccurrences(Multiset removeFrom, Multiset toRetain)`	修改removeFrom，以保证任意o都符合removeFrom.count(o)<=toRetain.count(o)	Collection.retainAll保留所有出现在toRetain的元素
`intersection(Multiset, Multiset)`	返回两个multiset的交集;	没有类似方法

Multisets中的其他工具方法还包括：

`copyHighestCountFirst(Multiset)`	返回Multiset的不可变拷贝，并将元素按重复出现的次数做降序排列
`unmodifiableMultiset(Multiset)`	返回Multiset的只读视图
`unmodifiableSortedMultiset(SortedMultiset)`	返回SortedMultiset的只读视图

Multimaps,Tables类似可以自行参看