如果你只对Observable发射的第一项数据,或者满足某个条件的第一项数据感兴趣,你可以使用操作符。

    在某些实现中,First没有实现为一个返回Observable的过滤操作符,而是实现为一个在当时就发射原始Observable指定数据项的阻塞函数。在这些实现中,如果你想要的是一个过滤操作符,最好使用Take(1)或者ElementAt(0)

    在一些实现中还有一个Single操作符。它的行为与First类似,但为了确保只发射单个值,它会等待原始Observable终止(否则,不是发射那个值,而是以一个错误通知终止)。你可以使用它从原始Observable获取第一项数据,而且也确保只发射一项数据。

    在RxJava中,这个操作符被实现为firstfirstOrDefaulttakeFirst

    可能容易混淆,BlockingObservable也有名叫first和的操作符,它们会阻塞并返回值,不是立即返回一个Observable。

    还有几个其它的操作符执行类似的功能。

    first

    示例代码

    输出

    1. Next: 1
    2. Sequence complete.
    • Javadoc: )

    first(Func1)

    传递一个谓词函数给first,然后发射这个函数判定为true的第一项数据。

    • Javadoc: )

    firstOrDefault

    firstOrDefault

    firstOrDefaultfirst类似,但是在Observagle没有发射任何数据时发射一个你在参数中指定的默认值。

    传递一个谓词函数给firstOrDefault,然后发射这个函数判定为true的第一项数据,如果没有数据通过了谓词测试就发射一个默认值。

    • Javadoc )

    takeFirst

    takeFirst与类似,除了这一点:如果原始Observable没有发射任何满足条件的数据,first会抛出一个NoSuchElementExceptiontakeFist会返回一个空的Observable(不调用onNext()但是会调用onCompleted)。

    • Javadoc: )

    single

    single

    single操作符也与first类似,但是如果原始Observable在完成之前不是正好发射一次数据,它会抛出一个NoSuchElementException

    • Javadoc: )

    single的变体接受一个谓词函数,发射满足条件的单个值,如果不是正好只有一个数据项满足条件,会以错误通知终止。

    singleOrDefault

    single

    firstOrDefault类似,但是如果原始Observable发射超过一个的数据,会以错误通知终止。

    singleOrDefault(T,Func1)

    first系列的这几个操作符默认不在任何特定的调度器上执行。