Java 集合系列（4）： Iterable接口源码

package java.lang;

import java.util.Iterator;
import java.util.Objects;
import java.util.Spliterator;
import java.util.Spliterators;
import java.util.function.Consumer;

/**
 * 实现这个接口允许对象成为for-each循环语句的目标 
 * @since 1.5
 * @jls 14.14.2 The enhanced for statement
 */
public interface Iterable<T> {
    
    //返回T类型的元素上的一个迭代器 
    Iterator<T> iterator();

   
     /** 
     * 对这个Iterable的每一个元素执行给定的动作指导所有元素都被处理或者动作抛出一个异常 
     * 为止。除非被实现类指定，动作将以迭代的顺序执行（如果一个迭代的顺序被指定。）被动作 
     * 抛出的异常将被传递给调用者  
     * @since 1.8
     */
    default void forEach(Consumer<? super T> action) {
    	// 验证action是否为null，如果action为null，则抛出NullPointerException  
        Objects.requireNonNull(action);
        for (T t : this) {
            action.accept(t);
        }
    }

    /** 
     * 创建一个被这个Iterable接口描述的元素上Spliterator。 
     *  
     * 默认实现从iterable的Iterator中创建一个早期绑定的spliterator。这个spliterator 
     * 继承iterable的iterator的fail-fast性质。 
     *  
     * 默认实现应该总是被重写。被默认实现返回的spliterator拥有不好分解能力，是不依据指定 
     * 大小定制的，而且不报告任何spliterator的性质。实现类差不多总是能提供更好的实现。 
     * 
     * @since 1.8
     */  
    
    default Spliterator<T> spliterator() {
        return Spliterators.spliteratorUnknownSize(iterator(), 0);
    }
}