转载

RxJava 教程第二部分：事件流基础之检查数据

Inspection 检查数据是否符合某一条件

前面一节介绍了如何过滤掉我们不关心的数据。有时候我们需要了解该数据流中的数据是否符合某一条件。本节来介绍一些检查数据流中数据的函数。

all

all 函数用来判断 observable 中发射的所有数据是否都满足一个条件。

public final Observable<java.lang.Boolean> all(Func1<? super T,java.lang.Boolean> predicate)

Observable<Integer> values = Observable.create(o -> {     o.onNext(0);     o.onNext(10);     o.onNext(10);     o.onNext(2);     o.onCompleted(); });     SubscriptionevenNumbers = values     .all(i -> i % 2 == 0)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

true Completed

all 函数返回的是一个发射一个布尔值的 Observable，而不是直接返回一个布尔值。原因在于我们并不知道源 Observable 何时才结束数据流的发射，只有当源 Observable 发射结束的时候， all 函数才知道结果是否都满足条件。只要遇到一个不满足条件的数据，all 函数就立刻返回 false。只有当源 Observable 结束发射并且所发射的所有数据都满足条件的时候才会产生 true。在 observable 内返回结果可以方便的实现非阻塞操作。在下个示例中可以看到 all 在遇到不满足的数据的时候就立刻结束了。

Observable<Long> values = Observable.interval(150, TimeUnit.MILLISECONDS).take(5);   Subscriptionsubscription = values     .all(i -> i<3) // Will fail eventually     .subscribe(         v -> System.out.println("All: " + v),         e -> System.out.println("All: Error: " + e),         () -> System.out.println("All: Completed")     ); Subscriptionsubscription2 = values     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

0 1 2 All: false All: Completed 3 4 Completed

如果源 Observable 出现了错误，则 all 操作就没有意义了，all 会直接发射一个 error 然后结束。

Observable<Integer> values = Observable.create(o -> {     o.onNext(0);     o.onNext(2);     o.onError(new Exception()); });   Subscriptionsubscription = values     .all(i -> i % 2 == 0)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

Error: java.lang.Exception

如果源 Observable 在出错之前就发射了一个不满足条件的数据，则源 Observable 的错误对 all 没有影响（ all 遇到不满足条件的数据就结束了，结束的Observable 无法再继续发射数据了）。

Observable<Integer> values = Observable.create(o -> {     o.onNext(1);     o.onNext(2);     o.onError(new Exception()); });   Subscriptionsubscription = values     .all(i -> i % 2 == 0)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

false Completed

exists

如果源 exists 发射的数据中有一个满足条件，则 exists 就返回 true。 exists 和 all 一样也是返回一个 Observable 而不是直接返回布尔值。

RxJava 教程第二部分：事件流基础之检查数据

Observable<Integer> values = Observable.range(0, 2);   Subscriptionsubscription = values     .exists(i -> i > 2)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

false Completed

上面示例中只发射了 0 和1 两个数据，而这两个数据都不满足大于2的条件，所以返回结果为 false。如果我们多发射几个数据，则就会满足条件了。

Observable<Integer> values = Observable.range(0, 4);

结果：

true Completed

isEmpty

顾名思义，判断一个 Observable 是否是空的，也就是没有发射任何数据就结束了。

RxJava 教程第二部分：事件流基础之检查数据

Observable<Long> values = Observable.timer(1000, TimeUnit.MILLISECONDS);   Subscriptionsubscription = values     .isEmpty()     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

false Completed

只要源 Observable 发射了一个数据，isEmpty 就立刻返回 false，只有当源 Observable 完成了并且没有发射数据，isEmpty 才返回 true。

contains

contains 使用 Object.equals 函数来判断源 Observable 是否发射了相同的数据。只要遇到相同的数据，则 contains 就立刻返回。

RxJava 教程第二部分：事件流基础之检查数据

Observable<Long> values = Observable.interval(100, TimeUnit.MILLISECONDS);   Subscriptionsubscription = values     .contains(4L)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

true Completed

注意上面使用的是 contains(4L)，而不是 contains(4)，由于 values 是 Observable

类型的，所以需要使用 Long 类型而不能是 Integer 类型。

如果使用 contains(4) 则什么都不会打印出来，由于 values 是一个无限的数据流，所以 contains 一直在等待一个相同的数据发射出来，但是在 values 里面是没有一样的数据的，导致 contains 一直等待下去。

defaultIfEmpty

如果你不想单独处理没有发射任何数据的情况（需要用 isEmpty 函数来检查是否为空），则可以使用 defaultIfEmpty 函数来强制一个空的 Observable 发射一个默认数据。

RxJava 教程第二部分：事件流基础之检查数据

Observable<Integer> values = Observable.empty();   Subscriptionsubscription = values     .defaultIfEmpty(2)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

2 Completed

只有当 onCompleted 事件发生了，并且 Observable 没有发射任何数据的时候，才会使用默认值；否则不会使用默认值。如果发生了错误，则还会有错误的结果。

Observable<Integer> values = Observable.error(new Exception());   Subscriptionsubscription = values     .defaultIfEmpty(2)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

Error: java.lang.Exception

elementAt

从特定的位置选择一个数据发射。

RxJava 教程第二部分：事件流基础之检查数据

Observable<Integer> values = Observable.range(100, 10);   Subscriptionsubscription = values     .elementAt(2)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

102 Completed

该函数和访问数组或者集合类似，如果 Observable 发射的数据个数没有这么多，则会抛出 java.lang.IndexOutOfBoundsException 。可以使用一个默认值（elementAtOrDefault）来避免抛出 java.lang.IndexOutOfBoundsException。

Observable<Integer> values = Observable.range(100, 10);   Subscriptionsubscription = values     .elementAtOrDefault(22, 0)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

0 Completed

sequenceEqual

本节最后这个操作函数是用来比较两个 Observable 发射的数据是否是一样的，同样位置的数据是一样的。要求两个 Observable 发射的数据个数是一样的并且每个位置上的数据也是一样的。该函数内部用 Object.equals 来比较数据，当然你也可以自己指定一个比较函数。

Observable<String> strings = Observable.just("1", "2", "3"); Observable<Integer> ints = Observable.just(1, 2, 3);   Observable.sequenceEqual(strings, ints, (s,i) -> s.equals(i.toString())) //Observable.sequenceEqual(strings, ints)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：

true Completed

上面使用了自定义的比较函数，所以结果是一样的。如果不指定自定义的比较函数的话，使用默认的 Object.equals 来比较，则返回的结果就是 False 了。

如果一个源 Observable 出现了错误，则比较结果的 Observable 也会出现错误并结束。

Observable<Integer> values = Observable.create(o -> {     o.onNext(1);     o.onNext(2);     o.onError(new Exception()); });   Observable.sequenceEqual(values, values)     .subscribe(         v -> System.out.println(v),         e -> System.out.println("Error: " + e),         () -> System.out.println("Completed")     );

结果：