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);
    }
}

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值