Guava - 强大的集合工具Iterables

一、简介

Guava提供了一些java.util.Collections中没有提供的关于Iterable的公共操作,
而这些操作都封装在了工具类 - Iterables中.

为什么提供了Iterables?

只要可能，Guava更愿意提供实用的工具类来接受Iterable而不是Collection.
Iterable实际并不存储在主内存中,并且在不实际获取所有元素的情况下无法支持size()之类的操作。

因此，可以在Iterables中找到许多我们可能希望看到的支持所有集合的操作。

Iterables类中的绝大多数操作都是惰性的:它们只在绝对必要的时候才推进支持迭代。本身返回Iterables的方法将返回延迟计算的视图，而不是显式地在内存中构造一个集合.

二、常用方法

1、合并方法 - concat()

Iterables提供了将多个Iterable<? extends T>合并为一个Iterable<T>的方法.
它会将传入的一个或者多个Iterable<? extends T>连接起来并且返回一个延时的视图.

实验代码:

        List<Integer> list1 = Lists.newArrayListWithCapacity(0);
        list1.add(null);
        list1.add(1);
        list1.add(2);

        List<Integer> list2 = Lists.newArrayListWithCapacity(0);
        list2.add(2);
        list2.add(3);
        list2.add(4);

        Iterable<Integer> testIterable = Iterables.concat(list1, list2);
        System.out.println("==========测试concat()方法===================" + testIterable);

实验结果:

==========测试concat()方法===================[null, 1, 2, 2, 3, 4]

2、统计对象频率方法 - frequency()

Iterables的frequency()可以统计出指定的对象在Iterable中出现的次数

实验代码:

        System.out.println("==========测试concat()方法===================" + testIterable);

        //测试iterables对象出现次数方法
        System.out.println("==========测试frequency()方法===================" + Iterables.frequency(testIterable, 1));
        System.out.println("==========测试frequency()方法===================" + Iterables.frequency(testIterable, 11));

实验结果:

==========测试concat()方法===================[null, 1, 2, 2, 3, 4]
==========测试frequency()方法===================1
==========测试frequency()方法===================0

通过源码以及实验结果表明,当存在指定对象时,返回指定对象的出现次数,如果指定对象不存在,返回0.

3、分区方法 - partition()

Iterables提供了对指定Iterable<T>通过指定分区大小进行分区.并返回Iterable<List<T>>.
需要注意的是:Iterable不能为NULL并且指定的分区大小必须大于0.

实验代码:

        System.out.println("==========测试concat()方法===================" + testIterable);
        //测试partition方法
        System.out.println("==========测试partition()方法===================" + Iterables.partition(testIterable, 2));

实验结果:

==========测试concat()方法===================[null, 1, 2, 2, 3, 4]
==========测试partition()方法===================[[null, 1], [2, 2], [3, 4]]

可以发现Iterable中的元素已经变为了List节点

4、获取首个节点方法 - getFirst()

Iterables的IgetFirst(Iterable<? extends T> iterable, @Nullable T defaultValue)方法可以获取指定迭代器的首位节点,如果Iterable为空,则返回指定的defaultValue.

实验代码:

        //测试getFirst方法 - 如果为空将返回设定的默认值
        System.out.println("==========测试iterable不为空 - getFirst()方法===================" + Iterables.getFirst(testIterable, 2));
        System.out.println("==========测试iterable为空 - getFirst()方法==================" + Iterables.getFirst(testIterable1, 2));
        System.out.println("==========测试iterable为空 - getFirst()方法==================" + Iterables.getFirst(testIterable1, null));

实验代码:

==========测试iterable不为空 - getFirst()方法===================null
==========测试iterable为空 - getFirst()方法==================2
==========测试iterable为空 - getFirst()方法==================null

5、获取末尾节点方法 - getLast()

Iterables提供了获取指定Iterable末尾节点的方法 - getLast(Iterable<? extends T> iterable, @Nullable T defaultValue),如果Iterable不为empty,返回末尾节点,否则返回默认节点；如果为NULL抛出NPE.

实验代码:

         //测试getLast方法 - 如果为空抛出NoSuchElementException
        System.out.println("==========测试iterable不为空 - getLast()方法===================" + Iterables.getLast(testIterable, 2));
        System.out.println("==========测试iterable为空 - getLast()方法==================" + Iterables.getLast(testIterable1, 2));
        System.out.println("==========测试iterable为null - getLast()方法==================" + Iterables.getLast(testIterable6, 2));

实验结果:

==========测试iterable不为空 - getLast()方法===================4
==========测试iterable为空 - getLast()方法==================2
Exception in thread "main" java.lang.NullPointerException
    at com.google.common.collect.Iterables.getLast(Iterables.java:796)
    at com.toxic.anepoch.guava.parsing.powerfuleUtils.Test.main(Test.java:65)

6、获取不可变的Iterable方法 - unmodifiableIterable()

当我们想将对应的Iterable变为不可变的Iterable时,可以使用Iterables.unmodifiableIterable()方法,它将返回指定iterable的不可变视图

实验代码:

        //测试返回一个不可修改的视图
        System.out.println("==========测试返回不可变视图unmodifiableIterable()方法==================" + Iterables.unmodifiableIterable(testIterable));

实验结果:

==========测试返回不可变视图unmodifiableIterable()方法==================[null, 1, 2, 2, 3, 4]

7、获取首位起，指定大小的Iterable方法 - limit()

当我们想类似limit操作的时候,Iterables也提供了对应的limit()方法

实验代码:

         //测试返回一个limit的视图
        System.out.println("==========测试返回不可变视图limit()方法==================" + Iterables.limit(testIterable, 3));

实验结果:

==========测试返回不可变视图limit()方法==================[null, 1, 2]

8、获取单个节点的Iterable节点方法 - getOnlyElement()

getOnlyElement()方法返回指定Iterable唯一元素,
如果iterable是空则返回指定的默认值；
如果只有一个元素,则返回当前元素,否则抛出非法参数异常

实验代码:

        //测试返回唯一元素,方法实现为如果iterable是空则返回指定的默认值,如果只有一个元素,则返回当前元素,否则抛出非法参数异常
        System.out.println("==========测试返回唯一元素getOnlyElement()方法==================" + Iterables.getOnlyElement(testIterable5, 3));
        System.out.println("==========测试返回唯一元素getOnlyElement()方法==================" + Iterables.getOnlyElement(testIterable3, 3));

实验结果:

==========测试返回唯一元素getOnlyElement()方法==================2
Exception in thread "main" java.lang.IllegalArgumentException: expected one element but was: <2, 4, 3>
    at com.google.common.collect.Iterators.getOnlyElement(Iterators.java:322)
    at com.google.common.collect.Iterators.getOnlyElement(Iterators.java:335)
    at com.google.common.collect.Iterables.getOnlyElement(Iterables.java:306)
    at com.toxic.anepoch.guava.parsing.powerfuleUtils.Test.main(Test.java:79)

三、加强型流利的Iterable类 - FluentIterable

......未完待续