RxJava连接操作符

RxJava系列教程：

1. RxJava使用介绍 【视频教程】
2. RxJava操作符
  • Creating Observables(Observable的创建操作符) 【视频教程】
  • Transforming Observables(Observable的转换操作符) 【视频教程】
  • Filtering Observables(Observable的过滤操作符) 【视频教程】
  • Combining Observables(Observable的组合操作符) 【视频教程】
  • Error Handling Operators(Observable的错误处理操作符) 【视频教程】
  • Observable Utility Operators(Observable的辅助性操作符) 【视频教程】
  • Conditional and Boolean Operators(Observable的条件和布尔操作符) 【视频教程】
  • Mathematical and Aggregate Operators(Observable数学运算及聚合操作符) 【视频教程】
  • 其他如observable.toList()、observable.connect()、observable.publish()等等； 【视频教程】
3. RxJava Observer与Subcriber的关系 【视频教程】
4. RxJava线程控制（Scheduler） 【视频教程】
5. RxJava 并发之数据流发射太快如何办（背压（Backpressure）） 【视频教程】

---

RxJava连接操作符

目录

• RxJava连接操作符
  • • 目录
  • Publish
    • 示例代码
  • Connect
    • 示例代码
  • RefCount
    • 示例代码
  • Replay
    • 示例代码

ConnectableObservable 和它的子类以及它们的操作符：

• ConnectableObservable.connect() — 指示一个可连接的Observable开始发射数据
• Observable.publish() — 将一个Observable转换为一个可连接的Observable
• Observable.replay() — 确保所有的订阅者看到相同的数据序列，即使它们在Observable开始发射数据之后才订阅
• ConnectableObservable.refCount() — 让一个可连接的Observable表现得像一个普通的Observable

一个可连接的Observable与普通的Observable差不多，除了这一点：可连接的Observable在被订阅时并不开始发射数据，只有在它的connect()被调用时才开始。用这种方法，你可以等所有的潜在订阅者都订阅了这个Observable之后才开始发射数据。

---

Publish

Publish 操作符将普通的Observable转换为可连接的Observable（ConnectableObservable），ConnectableObservable是Observable的子类。 可连接的Observable (connectable Observable)与普通的Observable差不多，不过它并不会在被订阅时开始发射数据，而是直到使用了Connect操作符时才会开始，这样可以更灵活的控制发射数据的时机。

注意：如果一个ConnectableObservable已经开始发射数据，再对其进行订阅只能接受之后发射的数据，订阅之前已经发射过的数据就丢失了。

示例代码

Observable<Long> observable = Observable.interval(1, TimeUnit.SECONDS);
//使用publish操作符将普通Observable转换为可连接的Observable
        ConnectableObservable<Long> connectableObservable = observable.publish();

//第一个订阅者订阅，不会开始发射数据
        connectableObservable.subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("1.onCompleted");
            }
            @Override
public void onError(Throwable e) {
                System.out.println("1.onError");
            }
            @Override
public void onNext(Long value) {
                System.out.println("1.onNext value :"+ value);
            }
        });

//如果不调用connect方法，connectableObservable则不会发射数据
        connectableObservable.connect();
//第二个订阅者延迟2s订阅，这将导致丢失前面2s内发射的数据
        connectableObservable
                .delaySubscription(2, TimeUnit.SECONDS)// 0、1数据丢失
                .subscribe(new Subscriber<Long>() {
                    @Override
public void onCompleted() {
                        System.out.println("2.onCompleted");
                    }
                    @Override
public void onError(Throwable e) {
                        System.out.println("2.onError");
                    }
                    @Override
public void onNext(Long value) {
                        System.out.println("2.onNext value :"+ value);
                    }
                });
//eclipse下运行加上下面代码，Android Studio则不需要
        Thread.sleep(6000); 

输出结果如下：

1.onNext value :0
1.onNext value :1
1.onNext value :2
2.onNext value :2
1.onNext value :3
2.onNext value :3
1.onNext value :4
2.onNext value :4
1.onNext value :5
2.onNext value :5

无论connect方法何时调用，只要被调用后所有的订阅者都能发射数据。

Connect

RxJava中connect是ConnectableObservable接口的一个方法，使用publish操作符可以将一个普通的Observable转换为一个ConnectableObservable。

调用ConnectableObservable的connect方法会让它后面的Observable开始给发射数据给订阅者。

connect方法返回一个Subscription对象，可以调用它的unsubscribe方法让Observable停止发射数据给观察者。

即使没有任何订阅者订阅它，你也可以使用connect方法让一个Observable开始发射数据（或者开始生成待发射的数据）。这样，你可以将一个”冷”的Observable变为”热”的。

示例代码

Observable<Long> observable = Observable.interval(1, TimeUnit.SECONDS);
//使用publish操作符将普通Observable转换为可连接的Observable
        ConnectableObservable<Long> connectableObservable = observable.publish();
//开始发射数据,如果不调用connect方法，connectableObservable则不会发射数据
        Subscription subscription = connectableObservable.connect();

//第二个订阅者延迟2s订阅，这将导致丢失前面2s内发射的数据
        connectableObservable
                .delaySubscription(2, TimeUnit.SECONDS)// 0、1数据丢失
                .subscribe(new Subscriber<Long>() {
                    @Override
public void onCompleted() {
                        System.out.println("onCompleted");
                    }
                    @Override
public void onError(Throwable e) {
                        System.out.println("onError");
                    }
                    @Override
public void onNext(Long value) {
                        System.out.println("onNext value :"+ value);
                    }
                });

//5秒后取消订阅
        Observable.interval(1, TimeUnit.SECONDS)
        .take(5)
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted2");
                subscription.unsubscribe();//取消订阅
            }
            @Override
public void onError(Throwable e) {
                System.out.println("onError2");
            }
            @Override
public void onNext(Long along) {
                System.out.println("onNext2:"+along);
            }
        });

//eclipse下运行加上下面代码，Android Studio则不需要
        Thread.sleep(10000); 

输出结果如下：

onNext2:0
onNext2:1
onNext value :2
onNext2:2
onNext value :3
onNext2:3
onNext value :4
onNext2:4
onCompleted2

RefCount

RefCount操作符可以看做是Publish的逆向，它能将一个ConnectableObservable对象再重新转化为一个普通的Observable对象，如果转化后有订阅者对其进行订阅将会开始发射数据，后面如果有其他订阅者订阅，将只能接受后面的数据（这也是转化之后的Observable 与普通的Observable的一点区别 ）。

还有一个操作符叫share，它的作用等价于对一个Observable同时应用publish和refCount操作。

示例代码

//创建一个可连接的Observable
        ConnectableObservable<Long> connectableObservable = Observable.interval(1, TimeUnit.SECONDS).take(6)
                .publish();

        connectableObservable.subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted1.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError1: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext1: " + along);
            }
        });

        connectableObservable.delaySubscription(3, TimeUnit.SECONDS)
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted2.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError2: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext2: " + along);
            }
        });

//如果不调用connect方法，connectableObservable则不会发射数据
        connectableObservable.connect();

        System.out.println("------after refCount()------");

        Observable<Long> observable = connectableObservable.refCount();

        observable.subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted3.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError3: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext3: " + along);
            }
        });

        observable.delaySubscription(3, TimeUnit.SECONDS)
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted4.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError4: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext4: " + along);
            }
        });
        Thread.sleep(10000); 

输出结果如下：

------after refCount()------
onNext1: 0
onNext3: 0
onNext1: 1
onNext3: 1
onNext1: 2
onNext3: 2
onNext1: 3
onNext3: 3
onNext2: 3
onNext4: 3
onNext1: 4
onNext3: 4
onNext2: 4
onNext4: 4
onNext1: 5
onNext3: 5
onNext2: 5
onNext4: 5
onCompleted1.
onCompleted3.
onCompleted2.
onCompleted4.

由运行结果可以看出，RefCount操作符将一个Connectable Observable 对象重新转化为一个普通的Observable对象，这时候订阅者进行订阅将会触发数据的发射。

Replay

使用Replay操作符返回的ConnectableObservable 会缓存订阅者订阅之前已经发射的数据，这样即使有订阅者在其发射数据开始之后进行订阅也能收到之前发射过的数据。Replay操作符能指定缓存的大小或者时间，这样能避免耗费太多内存。

示例代码：

//创建一个可连接的Observable
        ConnectableObservable<Long> connectableObservable = Observable.interval(1, TimeUnit.SECONDS).take(5)
                .publish();
//如果不调用connect方法，connectableObservable则不会发射数据
        connectableObservable.connect();
        connectableObservable.delaySubscription(3, TimeUnit.SECONDS)//延时订阅
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted1.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError1: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext1: " + along);
            }
        });

//创建一个可连接的Observable
        ConnectableObservable<Long> connectableObservable2 = Observable.interval(1, TimeUnit.SECONDS).take(6)
                .replay(1);//这里不在使用publish，replay(1)缓存1个数据

//如果不调用connect方法，connectableObservable则不会发射数据
        connectableObservable2.connect();
        connectableObservable2.delaySubscription(3, TimeUnit.SECONDS)//延时订阅
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted2.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError2: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext2: " + along);
            }
        });

//创建一个可连接的Observable
        ConnectableObservable<Long> connectableObservable3 = Observable.interval(1, TimeUnit.SECONDS).take(6)
                .replay(3, TimeUnit.SECONDS);//这里不在使用publish，replay(3, TimeUnit.SECONDS)缓存3s内的数据

//如果不调用connect方法，connectableObservable则不会发射数据
        connectableObservable3.connect();
        connectableObservable3.delaySubscription(3, TimeUnit.SECONDS)//延时订阅
        .subscribe(new Subscriber<Long>() {
            @Override
public void onCompleted() {
                System.out.println("onCompleted3.");
            }

            @Override
public void onError(Throwable e) {
                System.out.println("onError3: " + e.getMessage());
            }

            @Override
public void onNext(Long along) {
                System.out.println("onNext3: " + along);
            }
        });

输出结果如下：

onNext3: 0
onNext3: 1
onNext3: 2

onNext2: 2

onNext1: 3
onNext2: 3
onNext3: 3
onNext1: 4
onNext2: 4
onNext3: 4
onNext1: 5
onCompleted1.
onNext3: 5
onNext2: 5
onCompleted2.
onCompleted3.