Rxjava 6

  在这篇文章中我们来了解一些辅助操作符，可以让我们更加地方便地处理Observable。

     一、Delay

    顾名思义，Delay操作符就是让发射数据的时机延后一段时间，这样所有的数据都会依次延后一段时间发射。在Rxjava中将其实现为Delay和DelaySubscription。不同之处在于Delay是延时数据的发射，而DelaySubscription是延时注册Subscriber。

    下面我们使用Delay和DelaySubscribtion操作符来延迟两个Observable数据的发射

点击( 此处 )折叠或打开

1. private Observable<Long> delayObserver() {
2.         return createObserver(2).delay(2000, TimeUnit.MILLISECONDS);
3.     }
4. 
   
5.     private Observable<Long> delaySubscriptionObserver() {
6.         return createObserver(2).delaySubscription(2000, TimeUnit.MILLISECONDS);
7.     }
8. 
   
9.     private Observable<Long> createObserver(int index) {
10.         return Observable.create(new Observable.OnSubscribe<Long>() {
11.             @Override
12.             public void call(Subscriber<? super Long> subscriber) {
13.                 log("subscrib:" + getCurrentTime());
14.                 for (int i = 1; i <= index; i++) {
15.                     subscriber.onNext(getCurrentTime());
16.                     try {
17.                         Thread.sleep(1000);
18.                     } catch (InterruptedException e) {
19.                         e.printStackTrace();
20.                     }
21.                 }
22.             }
23.         }).subscribeOn(Schedulers.newThread());
24.     }
25. 
    
26.     private long getCurrentTime() {
27.         return System.currentTimeMillis()/1000;
28.     }

   

     分别对其进行注册

点击( 此处 )折叠或打开

1. mLButton.setText("delay");
2.         mLButton.setOnClickListener(e -> {
3.             log("start subscrib:" + getCurrentTime());
4.             delayObserver().subscribe(i -> log("delay:" + (getCurrentTime() - i)));
5.         });
6.         mRButton.setText("delaySubscription");
7.         mRButton.setOnClickListener(e -> {
8.             log("start subscrib:" + getCurrentTime());
9.             delaySubscriptionObserver().subscribe(i -> log("delaySubscription:" + i));
10.         });

    运行结果如下。可以看到两个操作符都让我们达到了延迟2秒后再发射数据的目的

     二、Do

    Do操作符就是给Observable的生命周期的各个阶段加上一系列的回调监听，当Observable执行到这个阶段的时候，这些回调就会被触发。在Rxjava实现了很多的doxxx操作符。

    DoOnEach可以给Observable加上这样的样一个回调：Observable每发射一个数据的时候就会触发这个回调，不仅包括onNext还包括onError和onCompleted。

    DoOnNext则只有onNext的时候才会被触发。

    

    doOnSubscribe和doOnUnSubscribe则会在Subscriber进行订阅和反订阅的时候触发回调。当一个Observable通过OnError或者OnCompleted结束的时候，会反订阅所有的Subscriber。

    DoOnError会在OnError发生的时候触发回调，并将Throwable对象作为参数传进回调函数里；DoOnComplete会在OnCompleted发生的时候触发回调。

    DoOnTerminate会在Observable结束前触发回调，无论是正常还是异常终止；finallyDo会在Observable结束后触发回调，无论是正常还是异常终止。

    好了，介绍了这么多do的操作符，我们接下来创建两个Observable对象，并分别用上面的一系列do操作符进行注册回调

点击( 此处 )折叠或打开

1. private Observable<Integer> doOnEachObserver() {
2.         return Observable.just(1, 2, 3)
3.                 .doOnEach(notification -> log("doOnEach send " + notification.getValue() + " type:" + notification.getKind()))
4.                 .doOnNext(aInteger -> log("doOnNext send " + aInteger))
5.                 .doOnSubscribe(() -> log("on subscribe"))
6.                 .doOnUnsubscribe(() -> log("on unsubscribe\n"))
7.                 .doOnCompleted(() -> log("onCompleted"));
8. 
   
9.     }
10. 
    
11.     private Observable<Integer> doOnErrorObserver() {
12.         return createObserver()
13.                 .doOnEach(notification -> log("doOnEach send " + notification.getValue() + " type:" + notification.getKind()))
14.                 .doOnError(throwable -> log("OnError:" + throwable.getMessage()))
15.                 .doOnTerminate(() -> log("OnTerminate"))
16.                 .finallyDo(() -> log("finallyDo"));
17.     }
18. 
    
19.     private Observable<Integer> createObserver() {
20.         return Observable.create(new Observable.OnSubscribe<Integer>() {
21.             @Override
22.             public void call(Subscriber<? super Integer> subscriber) {
23.                 for (int i = 1; i <= 5; i++) {
24.                     if (i <= 3) {
25.                         subscriber.onNext(i);
26.                     } else {
27.                         subscriber.onError(new Throwable("num>3"));
28.                     }
29.                 }
30.             }
31.         });
32.     }

    分别进行订阅

点击( 此处 )折叠或打开

1. mLButton.setText("do");
2.         mLButton.setOnClickListener(e -> doOnEachObserver().subscribe(i -> log("do:" + i)));
3.         mRButton.setText("doOnError");
4.         mRButton.setOnClickListener(e -> doOnErrorObserver().subscribe(new Subscriber<Integer>() {
5.             @Override
6.             public void onCompleted() {
7.                 log("onCompleted");
8.             }
9. 
   
10.             @Override
11.             public void onError(Throwable e) {
12.                 log("subscriber onError:" + e.getMessage());
13.             }
14. 
    
15.             @Override
16.             public void onNext(Integer integer) {
17.                 log("subscriber onNext:" + integer);
18.             }
19.         }));

    运行结果如下所示。可以看到各个回调的监听都被依次触发。

     三、Meterialize

    Meterialize操作符将OnNext/OnError/OnComplete都转化为一个Notification对象并按照原来的顺序发射出来，而DeMeterialize则是执行相反的过程。

    下面我们使用这两个操作符来处理两个Observable对象

点击( 此处 )折叠或打开

1. private Observable<Notification<Integer>> meterializeObserver() {
2.         return Observable.just(1, 2, 3).materialize();
3.     }
4. 
   
5.     private Observable<Integer> deMeterializeObserver() {
6.         return eterializeObserver().dematerialize();
7.     }

    分别进行订阅

点击( 此处 )折叠或打开

1. mLButton.setText("meterialize");
2. mLButton.setOnClickListener(e -> meterializeObserver().subscribe(i -> log("meterialize:" + i.getValue() + " type" + i.getKind())));
3. mRButton.setText("deMeterialize");
4. mRButton.setOnClickListener(e -> deMeterializeObserver().subscribe(i->log("deMeterialize:"+i)));

    运行结果如下所示，可以看到onComplete也被meterialize包装后发射了出来，onError也同样。

     四、SubscribOn/ObserverOn

    这两个操作符在前面的例子中我们已经使用过多次了，使用起来十分方便。在android开发中，相信大家一定都遇到过不能在主线程修改UI的问题，所以不得不使用Handler、AsyncTask等来更新UI界面。使用SubscribOn和ObserverOn操作符，各种线程的问题都将变得十分地简单。

    SubscribOn用来指定Observable在哪个线程上运行，我们可以指定在IO线程上运行也可以让其新开一个线程运行，当然也可以在当前线程上运行。一般来讲会指定在各种后台线程而不是主线程上运行，就如同AsyncTask的doInBackground一样。

    ObserverOn用来指定观察者所运行的线程，也就是发射出的数据在那个线程上使用。在android中，如果我们要修改UI界面，观察者就必须在主线程上运行，就如同AsyncTask的onPostExecute。

     下面创建两个Observable并使用ObserverOn和SubscribOn使Observable和观察者运行在不同的线程上。

点击( 此处 )折叠或打开

1. private Observable<Integer> observerOnObserver() {
2.         return createObserver()
3.                 .observeOn(AndroidSchedulers.mainThread())
4.                 .subscribeOn(Schedulers.newThread());
5.     }
6. 
   
7.     private Observable<Integer> subscribeOnObserver() {
8.         return createObserver()
9.                 .subscribeOn(Schedulers.computation())
10.                 .observeOn(Schedulers.immediate());
11.     }
12. 
    
13.     private Observable<Integer> createObserver() {
14.         return Observable.create(new Observable.OnSubscribe<Integer>() {
15.             @Override
16.             public void call(Subscriber<? super Integer> subscriber) {
17.                 log("on subscrib:" + Thread.currentThread().getName());
18.                 subscriber.onNext(1);
19.                 subscriber.onCompleted();
20.             }
21.         });
22.     }

     分别进行订阅

点击( 此处 )折叠或打开

1. mLButton.setText("observerOn");
2. mLButton.setOnClickListener(e -> observerOnObserver().subscribe(i -> log("observerOn:" + Thread.currentThread().getName())));
3. mRButton.setText("subscribeOn");
4. mRButton.setOnClickListener(e -> subscribeOnObserver().subscribe(i -> log("subscribeOn:" + Thread.currentThread().getName())));

     运行结果如下

     

      五、TimeInterval\TimeStamp

     TimeInterval会拦截发射出来的数据，取代为前后两个发射两个数据的间隔时间。对于第一个发射的数据，其时间间隔为订阅后到首次发射的间隔。

     TimeStamp会将每个数据项给重新包装一下，加上了一个时间戳来标明每次发射的时间

     

     下面使用这两个操作符来处理两个Observable对象

点击( 此处 )折叠或打开

1. private Observable<TimeInterval<Integer>> timeIntervalObserver() {
2.         return createObserver().timeInterval();
3.     }
4. 
   
5.     private Observable<Timestamped<Integer>> timeStampObserver() {
6.         return createObserver().timestamp();
7.     }
8. 
   
9.     private Observable<Integer> createObserver() {
10.         return Observable.create(new Observable.OnSubscribe<Integer>() {
11.             @Override
12.             public void call(Subscriber<? super Integer> subscriber) {
13.                 for (int i = 0; i <= 3; i++) {
14.                     try {
15.                         Thread.sleep(1000);
16.                     } catch (InterruptedException e) {
17.                         e.printStackTrace();
18.                     }
19.                     subscriber.onNext(i);
20.                 }
21.                 subscriber.onCompleted();
22.             }
23.         }).subscribeOn(Schedulers.newThread());
24.     }

     分别进行订阅

点击( 此处 )折叠或打开

1. mLButton.setText("timeInterval");
2. mLButton.setOnClickListener(e -> timeIntervalObserver().subscribe(i -> log("timeInterval:" + i.getValue()+"-"+i.getIntervalInMilliseconds())));
3. mRButton.setText("timeStamp");
4. mRButton.setOnClickListener(e -> timeStampObserver().subscribe(i -> log("timeStamp:" + i.getValue()+"-"+i.getTimestampMillis())));

     运行结果如下所示。

      六、Timeout

     Timeout操作符给Observable加上超时时间，每发射一个数据后就重置计时器，当超过预定的时间还没有发射下一个数据，就抛出一个超时的异常。

     Rxjava将Timeout实现为很多不同功能的操作符，比如说超时后用一个备用的Observable继续发射数据等。

     下面我们创建一个Observable，逐渐加大间隔地发射数据，并使用timeout加上超时的限制。

点击( 此处 )折叠或打开

1. private Observable<Integer> timeoutObserver() {
2.         return createObserver().timeout(200, TimeUnit.MILLISECONDS);
3.     }
4. 
   
5.     private Observable<Integer> timeoutobserverObserver() {
6.         return createObserver().timeout(200, TimeUnit.MILLISECONDS, Observable.just(5, 6));
7.     }
8. 
   
9.     private Observable<Integer> createObserver() {
10.         return Observable.create(new Observable.OnSubscribe<Integer>() {
11.             @Override
12.             public void call(Subscriber<? super Integer> subscriber) {
13.                 for (int i = 0; i <= 3; i++) {
14.                     try {
15.                         Thread.sleep(i * 100);
16.                     } catch (InterruptedException e) {
17.                         e.printStackTrace();
18.                     }
19.                     subscriber.onNext(i);
20.                 }
21.                 subscriber.onCompleted();
22.             }
23.         });
24.     }

     分别进行订阅

点击( 此处 )折叠或打开

1. mLButton.setText("timeout");
2.         mLButton.setOnClickListener(e -> timeoutObserver().subscribe(new Subscriber<Integer>() {
3.             @Override
4.             public void onCompleted() {
5. 
   
6.             }
7. 
   
8.             @Override
9.             public void onError(Throwable e) {
10.                 log(e);
11.             }
12. 
    
13.             @Override
14.             public void onNext(Integer integer) {
15.                 log("timeout:" + integer);
16.             }
17.         }));
18.         mRButton.setText("timeoutobserver");
19.         mRButton.setOnClickListener(e -> timeoutobserverObserver().subscribe(i -> log(i)));

     运行结果如下

     七、Using

     Using操作符创建一个在Observable生命周期内存活的资源，也可以这样理解：我们创建一个资源并使用它，用一个Observable来限制这个资源的使用时间，当这个Observable终止的时候，这个资源就会被销毁。

Using需要使用三个参数，分别是：

     1.创建这个一次性资源的函数

     2.创建Observable的函数

     3.释放资源的函数

     下面我们定义了一个Animal类，并使用Using来控制其创建和释放。

点击( 此处 )折叠或打开

1. private Observable<Long> usingObserver() {
2.         return Observable.using(() -> new Animal(), i -> Observable.timer(5000,TimeUnit.MILLISECONDS), o -> o.relase());
3.     }
4. 
   
5.     private class Animal {
6.         Subscriber subscriber = new Subscriber() {
7.             @Override
8.             public void onCompleted() {
9. 
   
10.             }
11. 
    
12.             @Override
13.             public void onError(Throwable e) {
14. 
    
15.             }
16. 
    
17.             @Override
18.             public void onNext(Object o) {
19.                 log("animal eat");
20.             }
21.         };
22. 
    
23.         public Animal() {
24.             log("create animal");
25.             Observable.interval(1000, TimeUnit.MILLISECONDS)
26.                     .subscribe(subscriber);
27.         }
28. 
    
29.         public void relase() {
30.             log("animal released");
31.             subscriber.unsubscribe();
32.         }
33.     }

     对其进行订阅

点击( 此处 )折叠或打开

1. Observable<Long> observable = usingObserver();
2.         Subscriber subscriber = new Subscriber() {
3.             @Override
4.             public void onCompleted() {
5.                 log("onCompleted");
6.             }
7. 
   
8.             @Override
9.             public void onError(Throwable e) {
10.                 log("onError");
11.             }
12. 
    
13.             @Override
14.             public void onNext(Object o) {
15.                 log("onNext"+o);
16.             }
17.         };
18.         mLButton.setText("using");
19.         mLButton.setOnClickListener(e -> observable.subscribe(subscriber));
20.         mRButton.setText("unSubscrib");
21.         mRButton.setOnClickListener(e -> subscriber.unsubscribe());

     运行结果如下。在订阅了几秒之后，对其进行反订阅，Observable就会终止从而触发Animal的释放。