下面展示了可用于多个Observables的各种操作符
- startWith()---在数据序列的开头增加一项数据
- merge()---将多个Observable合并为一个
- mergeDelayError()---合并多个Observables,让没有错误的Observable都完成后再发射错误通知
- zip()---使用一个函数组合多个Observable发射的数据集合,然后在发射这个结果
- and(),then(),and when()---(rxjava-joins)通过模式和计划组合多个Observables发射的数据集合
- combineLatest()---当两个Observables中的任何一个发射了一个数据时,通过一个指定的函数组合每个Observable发射的最新数据(一共两个数据),然后发射这个函数的结果。
- join() and groupJoin()---无论何时,如果一个Observable发射了一个数据项,只要在另一个Observable发射的数据项定义的时间窗口内,就将两个Observable发射的数据合并发射。
- switchOnNext()---将一个发射Observables的Observable转换成另一个Observable,后者发射这些Observables最近发射的数据。
StartWith
在数据序列的开头插入一条指定的项
如果你想要一个Observable在发射数据之前先发射一个指定的数据序列，可以使用StartWith操作符。（如果你想一个Observable发射的数据末尾追加一个数据序列可以使用Concat操作符。）
你也可以传递一个Observable给startWith，它会将那个Observable的发射物插在原始Observable发射的数据序列之前，然后把这个当做自己的发射物集合。这可以看作是Concat的反转。
/**
* startWith操作符 解释：在源Observable输出之前插入指定数据项
*/
private static void test() {
Observable.just(7, 8, 9).startWith(11, 12)
.subscribe(new Observer<Integer>() {
@Override
public void onCompleted() {
System.out.println("onCompleted ");
}
@Override
public void onError(Throwable e) {
System.out.println("onError " + e.toString());
}
@Override
public void onNext(Integer t) {
System.out.println("onNext t = " + t);
}
});
}
Merge操作符
合并多个Observables的发射物
使用Merge操作符你可以将多个Observables的输出合并，就好像它们是一个单个的Observable一样。
Merge可能会让合并的Observables发射的数据交错（有一个类似的操作符Concat不会让数据交错，它会按顺序一个接着一个发射多个Observables的发射物）。
正如图例上展示的，任何一个原始Observable的onError通知会被立即传递给观察者，而且会终止合并后的Observable。
在很多ReactiveX实现中还有一个叫MergeDelayError的操作符，它的行为有一点不同，它会保留onError通知直到合并后的Observable所有的数据发射完成，在那时它才会把onError传递给观察者。
RxJava将它实现为merge, mergeWith和mergeDelayError。
/**
* Merge 解释：将2-9个Observables合并到一个Observable中进行发射，合并后的数据可能会是交错（无序）的（如果想要没有交错，
* 可以使用concat操作符） merge还可以传递一个Observable列表List，数组
* 甚至是一个发射Observable序列的Observable，merge将合并它们的输出作为单个Observable的输出
*/
private static void test1() {
Observable<String> letterObservable = Observable.just("A", "B", "C", "D", "E", "F", "G", "H");
Observable<Integer> numberObservable = Observable.just(1, 2, 3, 4, 5);
Observable.merge(letterObservable, numberObservable)
.subscribe(new Action1<Serializable>() {
@Override
public void call(Serializable value) {
System.out.println("value = " + value);
}
});
}
Zip操作符
通过一个函数将多个Observables的发射物结合到一起，基于这个函数的结果为每个结合体发射单个数据项。
Zip操作符返回一个Obversable，它使用这个函数按顺序结合两个或多个Observables发射的数据项，然后它发射这个函数返回的结果。它按照严格的顺序应用这个函数。它只发射与发射数据项最少的那个Observable一样多的数据。
RxJava将这个操作符实现为zip和zipWith。
zip的最后一个参数接受每个Observable发射的一项数据，返回被压缩后的数据，它可以接受一到九个参数：一个Observable序列，或者一些发射Observable的Observables。
zipWith
zipWith操作符总是接受两个参数，第一个参数是一个Observable或者一个Iterable。
zip和zipWith默认不在任何特定的操作符上执行。
/**
* Zip
* 结合两个或多个Observables发射的数据项，每个数据只能组合一次，而且都是有序的。
* 它只发射与发射数据项最少的那个Observable一样多的数据。
*
* 应用场景参考：http://blog.csdn.net/jdsjlzx/article/details/51724087
*/
private static void test2() {
Observable<String> letterObservable = Observable.just("A", "B", "C", "D", "E", "F", "G", "H");
Observable<Integer> numberObservable = Observable.just(1, 2, 3, 4, 5);
Observable.zip(letterObservable, numberObservable, new Func2<String, Integer, String>() {
@Override
public String call(String t1, Integer t2) {
return t1 + t2;
}
}).subscribe(new Action1<String>() {
@Override
public void call(String value) {
System.out.println("value = " + value);
}
});
}
CombineLatest操作符
当两个Observables中的任何一个发射了数据时，使用一个函数结合每个Observable发射的最近数据项，并且基于这个函数的结果发射数据。
CombineLatest操作符行为类似于zip，但是只有当原始的Observable中的每一个都发射了一条数据时zip才发射数据。CombineLatest则在原始的Observable中任意一个发射了数据时发射一条数据。当原始Observables的任何一个发射了一条数据时，CombineLatest使用一个函数结合它们最近发射的数据，然后发射这个函数的返回值。
RxJava将这个操作符实现为combineLatest，它接受二到九个Observable作为参数，或者单个Observables列表作为参数。它默认不在任何特定的调度器上执行。
/**
* CombineLatest
* 解释：combineLatest操作符把两个Observable产生的结果进行合并，合并的结果组成一个新的Observable。
* 这两个Observable中任意一个Observable产生的结果，都和另一个Observable最后产生的结果，按照一定的规则进行合并。
*/
private static void test3() {
Observable<String> letterObservable = Observable.just("A", "B", "C");
Observable<Integer> numberObservable = Observable.just(4, 5);
//letterObservable numberObservable谁在前谁在后都会对执行结果会有影响
Observable.combineLatest( numberObservable, letterObservable,new Func2<Integer, String, String>() {
@Override
public String call(Integer t1, String t2) {
System.out.println("combine t1 = " + t1 + " | t2 = " + t2);// t1的值一开始就是letterObservable中的最后一个值
return t1 + t2;
}
}).subscribe(new Action1<String>() {
@Override
public void call(String value) {
System.out.println("value = " + value);
}
});
}
withLatestFrom操作符
withLatestFrom操作符还在开发中，不是1.0版本的一部分。类似于combineLatest，但是只在单个原始Observable发射了一条数据时才发射数据。
Join操作符
任何时候，只要在另一个Observable发射的数据定义的时间窗口内，这个Observable发射了一条数据，就结合两个Observable发射的数据。
Join操作符结合两个Observable发射的数据，基于时间窗口（你定义的针对每条数据特定的原则）选择待集合的数据项。你将这些时间窗口实现为一些Observables，它们的生命周期从任何一条Observable发射的每一条数据开始。当这个定义时间窗口的Observable发射了一条数据或者完成时，与这条数据关联的窗口也会关闭。只要这条数据的窗口是打开的，它将继续结合其它Observable发射的任何数据项。你定义一个用于结合数据的函数。
/**
* Join 类似于combineLatest操作符，但是join操作符可以控制每个Observable产生结果的生命周期，在每个结果的生命周期内，
* 可以与另一个Observable产 生的结果按照一定的规则进行合并
*
* Join(Observable,Func1,Func1,Func2) 需要传递四个参数
*
* join操作符的用法如下： observableA.join(observableB, observableA产生结果生命周期控制函数，
* observableB产生结果生命周期控制函数， observableA产生的结果与observableB产生的结果的合并规则）
*
* 一句话概括：在observableA的生命周期内：observableB输出的数据项与observableA输出的数据项每个合并
*
* test4() 没有任何合并结果输出 分析:同一线程:observableA的生命周期已经执行完了,observableB还没出来,所以合并不了
*
*/
private static void test4() {
Observable<Integer> observableA = Observable.range(1, 5);
List<Integer> data = Arrays.asList(6, 7, 8, 9, 10);
Observable<Integer> observableB = Observable.from(data);
observableA.join(observableB, new Func1<Integer, Observable<Integer>>() {
@Override
public Observable<Integer> call(Integer value) {
//return Observable.just(value);
return Observable.just(value).delay(1, TimeUnit.SECONDS);
}
}, new Func1<Integer, Observable<Integer>>() {
@Override
public Observable<Integer> call(Integer value) {
return Observable.just(value);
}
}, new Func2<Integer, Integer, Integer>() {
@Override
public Integer call(Integer value1, Integer value2) {
System.out.println("left: " + value1 + " right:" + value2);
return value1 + value2;
}
}).subscribe(new Observer<Integer>() {
@Override
public void onCompleted() {
System.out.println("onCompleted");
}
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(Integer value) {
System.out.println("onNext value = " + value);
}
});
}
