Iterators类提供了返回Iterator类型的对象或者对Iterator类型对象操作的方法。除了特别的说明,Iterators类中所有的方法都在Iterables类中有相应的基于Iterable方法对应。
性能说明:除非特别说明,所有在这个类中的迭代器都是懒惰的,这意味着在觉得必要的时候,需要提前得到迭代功能。
Iterators类可以通过emptyIterator()方法得到一个空的并且不可改变的List迭代器(EMPTY_LIST_ITERATOR);如下:
UnmodifiableListIterator<Object> objectUnmodifiableIterator = (UnmodifiableListIterator)Iterators.emptyIterator(); System.out.println(objectUnmodifiableIterator.hasNext()); System.out.println(objectUnmodifiableIterator.hasPrevious()); //System.out.println(objectUnmodifiableIterator.next()); //System.out.println(objectUnmodifiableIterator.previous()); objectUnmodifiableIterator.add("w");
输出结果如下:
false false Exception in thread "main" java.lang.UnsupportedOperationException at com.google.common.collect.UnmodifiableListIterator.add(UnmodifiableListIterator.java:43) at fresh.qunar.com.Test.main(Test.java:38) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) at java.lang.reflect.Method.invoke(Method.java:597) at com.intellij.rt.execution.application.AppMain.main(AppMain.java:120)
在输出的结果中抛出了一个异常,原因是Iterators.emptyIterator()返回的是一个空的并且不可改变的List迭代器,所以当向返回的objectUnmodifiableIterator中add一个元素的时候,抛出UnsupportedOperationException异常。
如果需要得到Iterator类型对象的不可改变的(Unmodifiable)副本,可以调用Iterators类中的unmodifiableIterator(final Iterator iterator)函数。
判断某个对象是否存在Iterator中可以用contains(Iterator< ?> iterator, Object element)实现,如果iterator中存在element,则返回true;否则返回false。
在Iterator中删除所有出现在elementsToRemove集合中的数据可以用removeAll(Iterator< ?> removeFrom, Collection< ?> elementsToRemove)方法实现。相反,如果需要保存出现在elementsToRetain集合中的所有数据,而其他的都删除可以用retainAll(Iterator< ?> removeFrom, Collection< ?> elementsToRetain)函数实现。
Iterators类中有partition(Iterator iterator, int size)和 paddedPartition(Iterator iterator, int size)两个函数,它们都是将iterator中的元素以数量为size分成Iterators.size(iterator) / size + (Iterators.size(iterator) % size == 0 ? 0 : 1)组,唯一的区别是partition当最后一组数量不是size个时,不会补充;而paddedPartition当最后一组数量不是size个时,会填充null,使得最后一组元素数量也为size个。如下:
Iterable<String> wyp = Splitter.on(",").split("w,y,p,h,a"); Iterator<String> iterator = wyp.iterator(); UnmodifiableIterator<List<String>> listUnmodifiableIterator = Iterators.partition(iterator, 3); while (listUnmodifiableIterator.hasNext()){ System.out.println(listUnmodifiableIterator.next()); }
输出的结果为:
[w, y, p] [h, a]
而如下代码:
Iterable wyp = Splitter.on(",").split("w,y,p,h,a"); Iterator iterator = wyp.iterator(); UnmodifiableIterator<List> listUnmodifiableIterator = Iterators.paddedPartition(iterator, 3); while (listUnmodifiableIterator.hasNext()) { System.out.println(listUnmodifiableIterator.next()); }
输出的结果为:
[w, y, p] [h, a,null]
需要注意的是:partition和paddedPartition函数返回的是iterator的视图,当listUnmodifiableIterator.hasNext()为false的时候,iterator的位置将移到最后,也就是Iterators.size(iterator)为0。
Iterators类提供了Iterator和Enumeration之间的转换,函数原型分别为:
public static UnmodifiableIterator forEnumeration(final Enumeration enumeration) public static Enumeration asEnumeration(final Iterator iterator)
更多的关于Iterators的实现,请参见Iterators源码