集合扩展工具类

有时候你需要实现自己的集合扩展。也许你想要在元素被添加到列表时增加特定的行为，或者你想实现一个Iterable，其底层实际上是遍历数据库查询的结果集。Guava提供了若干工具方法，以便让类似的工作变得更简单。

Forwarding Decorators

针对所有类型的集合接口，Guava都提供了Forwarding抽象类以简化装饰者模式的使用。
Forwarding抽象类定义了一个抽象方法：delegate()，你可以覆盖这个方法来返回被装饰对象。所有其他方法都会直接委托给delegate()。
通过创建ForwardingXXX的子类并实现delegate()方法，可以选择性地覆盖子类的方法来增加装饰功能，而不需要自己委托每个方法。
此外，很多集合方法都对应一个”标准方法[standardxxx]“实现，可以用来恢复被装饰对象的默认行为，比如standardAdd

示例:

class AddLoggingList<E> extends ForwardingList<E> {  
    final List<E> delegate; // backing list  
    @Override  
    protected List<E> delegate() {  
        return delegate;  
    }  
    @Override  
    public void add(int index, E elem) {  
        log(index, elem);  
        super.add(index, elem);  
    }  
    @Override  
    public boolean add(E elem) {  
        return standardAdd(elem); // implements in terms of add(int, E)  
    }  
    @Override  
    public boolean addAll(Collection<? extends E> c) {  
        return standardAddAll(c); // implements in terms of add  
    }  
}  

目前提供了Forwarding包装类的接口有:
ForwardingCollection、ForwardingList、ForwardingSet、ForwardingSortedSet、ForwardingMap、ForwardingSortedMap、ForwardingConcurrentMap、ForwardingMapEntry、ForwardingQueue、ForwardingIterator、ForwardingListIterator、ForwardingMultiset、ForwardingMultimap、ForwardingListMultimap、ForwardingSetMultimap

PeekingIterator

Iterators提供一个Iterators.peekingIterator(Iterator)方法，来把Iterator包装为PeekingIterator，这是Iterator的子类，它能让你提前查看下一次调用next()返回的元素
注意：Iterators.peekingIterator返回的PeekingIterator不支持在peek()操作之后调用remove()方法。

示例：复制一个List，并去除连续的重复元素。

List<E> result = Lists.newArrayList();
PeekingIterator<E> iter = Iterators.peekingIterator(source.iterator());
while (iter.hasNext()) {
    E current = iter.next();
    while (iter.hasNext() && iter.peek().equals(current)) {
        // skip this duplicate element
        iter.next();
    }
    result.add(current);
}

AbstractIterator

AbstractIterator可以让你更方便地实现自己的Iterator

public static Iterator<String> skipNulls(final Iterator<String> in) {  
    return new AbstractIterator<String>() {  
        protected String computeNext() {  
            while (in.hasNext()) {  
                String s = in.next();  
                if (s != null) {  
                    return s;  
                }  
            }  
            return endOfData();  
        }  
    };  
}  

返回目录