RxJava操作符(05-结合操作)

转载请标明出处：

http://blog.csdn.net/xmxkf/article/details/51656736

本文出自:【openXu的博客】

目录：

• CombineLatest
• Join
• Merge
• StartWith
• Switch
• Zip
• 源码下载

结合操作就是将多个Observable发射的数据按照一定规则组合后发射出去，接下来看看RxJava中的结合操作符：

1. CombineLatest

  当两个Observables中的任何一个发射数据时，使用一个函数结合每个Observable发射的最近数据项，并且基于这个函数的结果发射出一个新的数据。

  好比工厂的流水线，下面一件产品需要两个流水线上的零件组合，流水线1的工人生产了一个零件，只有等流水线2的工人生产了另一个零件的时候，才能组合成一个产品；流水线2的工人速度快一些，很快生产了第二个零件，这时候流水线1的工人还没有生产第二个零件，流水线2的工人就会拿流水线1的第一个零件将就用着合成第二个产品。这个例子只是方便理解，我们假设零件可以复用。仔细看下图，应该就能明白这个步骤了：

    

  CombineLatest操作符能接受2~9个Observable或者一个Observable集合作为参数，当其中一个Observable要发射数据时，它会用传入的Func函数对每个Observable最近发射的数据进行组合后发射一个新的数据。这里有两个规则：

• 所有的Observable必须都发射过数据，如果其中一个Observable从来没发射过数据，将不会组合发射新的数据；
• 满足上面条件之后，当其中任何一个Observable要发射数据时，就会调用Func函数对所有Observable最近发射的数据进行组合（每个Observable贡献一个），然后发射出去。

    

示例代码：

//创建不同名称的Observable（每隔100ms发射一个数据 ）：
private Observable<String> getObservable(String name){
    return Observable.create(new Observable.OnSubscribe<String>() {
        @Override
        public void call(Subscriber<? super String> subscriber) {
            if(name.contains("-")){
                for (int i = 1; i <=3; i++) {
                    Log.v(TAG, name+i);
                    subscriber.onNext(name+i);
                    try {
                        Thread.sleep(100);
                    } catch (InterruptedException e) {
                        e.printStackTrace();
                    }
                }
                subscriber.onCompleted();
            }
        }
    }).subscribeOn(Schedulers.newThread());
}

Observable.combineLatest(getObservable("one->"), getObservable("two->"), getObservable("three->"),
        new Func3<String, String, String,String>() {
    //使用一个函数结合它们最近发射的数据，然后发射这个函数的返回值
    @Override
    public String call(String str1, String str2, String str3) {
        return str1+","+str2+","+str3;
    }
}).subscribe(new Action1<String>() {
    @Override
    public void call(String s) {
        Log.v(TAG, "combineLatest:"+s);
    }
});

输出：

one->1

two->1

three->1

combineLatest:one->1,two->1,three->1

one->2

combineLatest:one->2,two->1,three->1

two->2

combineLatest:one->2,two->2,three->1

three->2

combineLatest:one->2,two->2,three->2

one->3

combineLatest:one->3,two->2,three->2

two->3

combineLatest:one->3,two->3,three->2

three->3

combineLatest:one->3,two->3,three->3

从log可以看出，当one和two发射第一条数据的时候，并没有组合，因为要等所有的Observable都发射过数据，当three发射第一条数据的时候，Func会组合三个Observable最近发射的数据组合后发射。然后one要发射第二条数据了，Func会拿one的第二条、two的第一条、three的第一条组合；接下来应该是two要发射第二条数据，Func会拿one的第二条，two的第二条，three的第一条组合….

2. Join

  如果一个Observable发射了一条数据，只要在另一个Observable发射的数据定义的时间窗口内，就结合两个Observable发射的数据，然后发射结合后的数据。

    

  目标Observable和源Observable发射的数据都有一个有效时间限制，比如目标发射了一条数据（a）有效期为3s，过了2s后，源发射了一条数据（b），因为2s<3s，目标的那条数据还在有效期，所以可以组合为ab；再过2s，源又发射了一条数据（c）,这时候一共过去了4s，目标的数据a已经过期，所以不能组合了…

使用join操作符需要4个参数，分别是：

• 源Observable所要组合的目标Observable
• 一个函数，接受从源Observable发射来的数据，并返回一个Observable，这个Observable的生命周期决定了源Observable发射出来数据的有效期
• 一个函数，接受从目标Observable发射来的数据，并返回一个Observable，这个Observable的生命周期决定了目标Observable发射出来数据的有效期
• 一个函数，接受从源Observable和目标Observable发射来的数据，并返回最终组合完的数据。

Rxjava还实现了groupJoin，基本和join相同，只是最后组合函数的参数不同。

    

示例代码：

//目标Observable
Observable<Integer> obs1 = Observable.create(new Observable.OnSubscribe<Integer>() {
    @Override
    public void call(Subscriber<? super Integer> subscriber) {
        for (int i = 1; i < 5; i++) {
            subscriber.onNext(i);
            try {
                Thread.sleep(1000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
    }
});
//join
Observable.just("srcObs-")
        .join(obs1,
        //接受从源Observable发射来的数据，并返回一个Observable，
        //这个Observable的生命周期决定了源Observable发射出来数据的有效期
        new Func1<String, Observable<Long>>() {
            @Override
            public Observable<Long> call(String s) {
                return Observable.timer(3000, TimeUnit.MILLISECONDS);
            }
        },
        //接受从目标Observable发射来的数据，并返回一个Observable，
        //这个Observable的生命周期决定了目标Observable发射出来数据的有效期
        new Func1<Integer, Observable<Long>>() {
            @Override
            public Observable<Long> call(Integer integer) {
                return Observable.timer(2000, TimeUnit.MILLISECONDS);
            }
        },
        //接收从源Observable和目标Observable发射来的数据，并返回最终组合完的数据
        new Func2<String,Integer,String>() {
            @Override
            public String call(String str1, Integer integer) {
                return str1 + integer;
            }
        })
.subscribe(new Action1<String>() {
    @Override
    public void call(String o) {
        Log.v(TAG,"join:"+o);
    }
});

//groupJoin
Observable.just("srcObs-").groupJoin(obs1,
        new Func1<String, Observable<Long>>() {
            @Override
            public Observable<Long> call(String s) {
                return Observable.timer(3000, TimeUnit.MILLISECONDS);
            }
        },
        new Func1<Integer, Observable<Long>>() {
            @Override
            public Observable<Long> call(Integer integer) {
                return Observable.timer(2000, TimeUnit.MILLISECONDS);
            }
        },
        new Func2<String,Observable<Integer>, Observable<String>>() {
            @Override
            public Observable<String> call(String s, Observable<Integer> integerObservable) {
                return integerObservable.map(new Func1<Integer, String>() {
                    @Override
                    public String call(Integer integer) {
                        return s+integer;
                    }
                });
            }
        })
        .subscribe(new Action1<Observable<String>>() {
            @Override
            public void call(Observable<String> stringObservable) {
                stringObservable.subscribe(new Action1<String>() {
                    @Override
                    public void call(String s) {
                        Log.v(TAG,"groupJoin:"+s);
                    }
                });
            }
        });

输出：

join:srcObs-1

join:srcObs-2

join:srcObs-3

groupJoin:srcObs-1

groupJoin:srcObs-2

groupJoin:srcObs-3

分析：源Observable只发射了一条“srcObs-”的数据，有效期为3s，目标Observable每隔1s发射一条数据，每条数据有效期为2s。在“srcObs-”有效期间，obs1一共发射了三条数据，都能结合，最后“srcObs-”过期了，obs1发射的数据就舍弃了，所以一共输出三条。

3. Merge

  使用Merge操作符你可以将多个Observables的输出合并，就好像它们是一个单个的Observable一样。Merge可能会让合并的Observables发射的数据交错（有一个类似的操作符Concat不会让数据交错，它会按顺序一个接着一个发射多个Observables的发射物）。

Merge操作符有两种：

• merge：任何一个原始Observable的onError通知会被立即传递给观察者，而且会终止合并后的Observable。
  
      
• mergeDelayError： mergeDelayError操作符会保留onError通知直到合并后的Observable所有的数据发射完成，在那时它才会把onError传递给观察者。
  
      

示例代码：

/*
 * merge:当其中一个Observable发生onError时，就会终止发射数据，并将OnError传递给观察者
 */
Observable<Integer> odds = Observable.just(1, 3, 5);
Observable<Integer> evens = Observable.just(2, 4, 6);
Observable.merge(odds, evens)
        .subscribe(new Subscriber<Integer>() {
            @Override
            public void onNext(Integer item) {
                Log.v(TAG, "merge Next: " + item);
            }
            @Override
            public void onError(Throwable error) {
                Log.e(TAG, "merge Error: " + error.getMessage());
            }
            @Override
            public void onCompleted() {
                Log.v(TAG, "merge Sequence complete.");
            }
        });

/*
 * mergeDelayError:当发生onError时，会等待其他Observable将数据发射完，然后才将onError发送个观察者
 */
Observable.mergeDelayError(Observable.create(new Observable.OnSubscribe<Integer>() {
    @Override
    public void call(Subscriber<? super Integer> subscriber) {
        for (int i = 0; i < 5; i++) {
            if (i == 3) {
                subscriber.onError(new Throwable("第一个发射onError了"));
            }
            subscriber.onNext(i);
        }
    }
}), Observable.create(new Observable.OnSubscribe<Integer>() {
    @Override
    public void call(Subscriber<? super Integer> subscriber) {
        for (int i = 10; i < 15; i++) {
            subscriber.onNext(i);
        }
        subscriber.onCompleted();
    }
})).subscribe(new Subscriber<Integer>() {
    @Override
    public void onNext(Integer item) {
        Log.v(TAG, "mergeDelayError Next: " + item);
    }
    @Override
    public void onError(Throwable error) {
        Log.e(TAG, "mergeDelayError Error: " + error.getMessage());
    }
    @Override
    public void onCompleted() {
        Log.v(TAG, "mergeDelayError Sequence complete.");
    }
});

输出：

merge Next: 1

merge Next: 3

merge Next: 5

merge Next: 2

merge Next: 4

merge Next: 6

merge Sequence complete.

mergeDelayError Next: 0

mergeDelayError Next: 1

mergeDelayError Next: 2

mergeDelayError Next: 3

mergeDelayError Next: 4

mergeDelayError Next: 10

mergeDelayError Next: 11

mergeDelayError Next: 12

mergeDelayError Next: 13

mergeDelayError Next: 14

mergeDelayError Error: 第一个发射onError了

4. StartWith

  startWith操作符可以在Observable在发射数据之前先发射一个指定的数据序列。它可以接受一个Iterable或者多个Observable作为函数的参数。

  如果我们传递一个Observable给startWith，它会将这个Observable的数据插在原始Observable发射的数据序列之前。（如果你想一个Observable发射的数据末尾追加一个数据序列可以使用Concat操作符。）

    

示例代码：

/*
 * 插入一个Observable
 */
Observable<Integer> obs1 = Observable.just(1, 2, 3);
Observable<Integer> obs2 = Observable.just(4, 5, 6);
obs1.startWith(obs2).subscribe(new Action1<Integer>() {
    @Override
    public void call(Integer integer) {
        Log.v(TAG, "onNext:"+integer);
    }
});

/*
 * 插入数据序列（最多接受9个参数）
 */
Observable<String> obs3 = Observable.just("c","d","e");
obs3.startWith("a", "b").subscribe(new Action1<String>() {
    @Override
    public void call(String s) {
        Log.v(TAG, "onNext:"+s);
    }
});

输出：

onNext:4

onNext:5

onNext:6

onNext:1

onNext:2

onNext:3

onNext:a

onNext:b

onNext:c

onNext:d

onNext:e

5. Switch

  将一个发射多个Observables的Observable转换成另一个单独的Observable，后者发射那些Observables最近发射的数据项。

   Switch订阅一个发射多个Observables的Observable。它每次观察那些Observables中的一个，Switch返回的这个Observable取消订阅前一个发射数据的Observable，开始发射最近的Observable发射的数据。

  注意：当原始Observable发射了一个新的Observable时（不是这个新的Observable发射了一条数据时），它将取消订阅之前的那个Observable。这意味着，在后来那个Observable产生之后，前一个Observable发射的数据将被丢弃（就像图例上的那个黄色圆圈一样）。

    

示例代码：

Observable.switchOnNext(Observable.create(
        new Observable.OnSubscribe<Observable<Long>>() {
            @Override
            public void call(Subscriber<? super Observable<Long>> subscriber) {
                for (int i = 1; i < 3; i++) {
                    //每隔1s发射一个小Observable。小Observable每1s发射一个整数
                    //第一个小Observable将发射6个整数，第二个将发射3个整数
                    subscriber.onNext(Observable.interval(1000, TimeUnit.MILLISECONDS).take(i==1?6:3));
                    try {
                        Thread.sleep(1000);
                    } catch (InterruptedException e) {
                        e.printStackTrace();
                    }
                }
            }
        }
)).subscribe(new Action1<Long>() {
    @Override
    public void call(Long s) {
        Log.v(TAG, "onNext:"+s);
    }
});

输出：

onNext:0

onNext:0

onNext:1

onNext:2

从Log可以看出，第一个Observable每隔1s发射一个数据，总共发射6条数据；第二个Observable正好在第一个Observable发射1的时候产生了，这时候将不再订阅第一个Observable，所以第一个Observable只发射了一个0，后面的5个数据都被舍弃了。

6. Zip

  通过一个函数将多个Observables的发射物结合到一起，基于这个函数的结果为每个结合体发射单个数据项。

    

  Zip操作符返回一个Obversable，它使用这个函数按顺序结合两个或多个Observables发射的数据项，然后它发射这个函数返回的结果。它按照严格的顺序发射数据。它只发射与发射数据项最少的那个Observable一样多的数据。

RxJava将这个操作符实现为zip（static）和zipWith(非static)：

• zip

  • Javadoc: zip(Iterable,FuncN)
  • Javadoc: zip(Observable,FuncN)
  • Javadoc: zip(Observable,Observable,Func2) (最多可以有九个Observables参数)

  zip的最后一个参数接受每个Observable发射的一项数据，返回被压缩后的数据，它可以接受一到九个参数：一个Observable序列，或者一些发射Observable的Observables。

    

• zipWith

  • Javadoc: zipWith(Observable,Func2)
  • Javadoc: zipWith(Iterable,Func2)

  zipWith和zip的区别是zipWith不是static的，它必须由一个Observable对象调用，zipWith操作符总是接受两个参数，第一个参数是一个Observable或者一个Iterable。

    

示例代码：

Observable obs1 = Observable.just(1,2,3,4);
Observable obs2 = Observable.just(10,20,30,40);
/*
 * zip(Observable,FuncN):
 * ①.能接受1~9个Observable作为参数，或者单个Observables列表作为参数；
 *    Func函数的作用就是从每个Observable中获取一个数据进行结合后发射出去；
 * ②.小Observable的每个数据只能组合一次，如果第二个小Observable发射数据的时候，
 *    第一个还没有发射，将要等待第一个发射数据后才能组合；
 */
Observable.zip(obs1, obs2,
        new Func2<Integer, Integer, String>() {
            //使用一个函数结合每个小Observable的一个数据（每个数据只能组合一次），然后发射这个函数的返回值
            @Override
            public String call(Integer int1, Integer int2) {
                return int1+"-"+int2;
            }
        }).subscribe(new Action1<String>() {
    @Override
    public void call(String s) {
        Log.v(TAG, "zip:"+s);
    }
});

/*
 * zipWith(Observable,Func2):
 * ①.zipWith不是static的，必须由一个Observable对象调用
 * ②.如果要组合多个Observable，可以传递Iterable
 */
obs1.zipWith(obs2, new Func2<Integer, Integer, String>() {
    //使用一个函数结合每个小Observable的一个数据（每个数据只能组合一次），然后发射这个函数的返回值
    @Override
    public String call(Integer int1, Integer int2) {
        return int1+"-"+int2;
    }
}).subscribe(new Action1<String>() {
    @Override
    public void call(String s) {
        Log.v(TAG, "zipWith:"+s);
    }
});

输出：

zip:1-10

zip:2-20

zip:3-30

zip:4-40

zipWith :1-10

zipWith :2-20

zipWith :3-30

zipWith :4-40

有问题请留言，有帮助请点赞(^__^)

源码下载：

https://github.com/openXu/RxJavaTest