RxJava学习入门

RxJava是什么

一个词:异步。java

RxJava 在 GitHub 主页上的自我介绍是 “a library for composing asynchronous and event-based programs using observable sequences for the Java VM”(一个在 Java VM 上使用可观测的序列来组成异步的、基于事件的程序的库)。这就是 RxJava ,归纳得很是精准。react

然而,对于初学者来讲,这太难看懂了。由于它是一个『总结』,而初学者更须要一个『引言』。android

其实, RxJava 的本质能够压缩为异步这一个词。说到根上,它就是一个实现异步操做的库,而别的定语都是基于这之上的。数据库

引入RxJava

在build.gradle在dependencies加入json

dependencies { compile 'io.reactivex:rxandroid:1.1.0' compile 'io.reactivex:rxjava:1.1.0' }

异步网络请求:

场景:异步网络请求一个User数据,并在TextView展现。api

日常代码:数组

TextView textView = ...;

Map<String, String> params = new HashMap<>();
params.put("user_id", userid);// 请求参数

UserHttp client = new UserHttp();
client.post("http://server.com/user", params, new CallBack<String>() { // 异步请求
     @Override
     protected void onSuccess(String result) { // 在UI线程回调
         // 返回的字符串(一般是一个json),解析成User对象
         User user = parse(result); 

          textView.setText(user.getName());
     }
});

大概就是这样子了吧,固然通常都会再封装一下。markdown

用RxJava大概是这样子:网络

TextView textView = ...;

Observable<String> observable = Observable.create(new Observable.OnSubscribe<String>() {
    @Override
    public void call(final Subscriber<? super String> subscriber) {// 下面subscribeOn(Schedulers.newThread()) 把这方法设定在新线程回调
        Map<String, String> params = new HashMap<>();
        params.put("user_id", userid);// 请求参数

        UserHttp client   = new UserHttp();
        Response response = client.post("http://kkmike999.com/user", params);// 同步请求

        if (response.status == 200) { // 请求成功
            String result = response.getResult();
            subscriber.onNext(result);
            subscriber.onCompleted();
        } else {
            // 请求失败
            subscriber.onError(new Throwable(response.getMessage()));
        }
    }
})
.subscribeOn(Schedulers.newThread()) // 设置call(...)方法,在新线程回调;

// 可封装得更美观 Observable<String> observable = UserHttp.create(userid);
observable
          .observeOn(AndroidSchedulers.mainThread())// 让下面onNext()、onError()、onComplete()在UI线程(主线程)回调
          .subscribe(new Subscriber<String>() {
              @Override
              public void onNext(String result) { // 上面 subscriber.onNext(result)在这里回调
                  // 返回的字符串(一般是一个json),解析成User对象
                  User user = parse(result);

                  textView.setText(user.getName());
              }

              @Override
              public void onError(Throwable e) {} // 上面subscriber.onError(new Throwable(msg))在这里回调

              @Override
              public void onCompleted() {}
});

虽然代码增多了,RxJava 好在哪?就好在简洁,好在那把什么复杂逻辑都能穿成一条线的简洁。数据结构

API 介绍和原理简析

RxJava 的异步实现,是经过一种扩展的观察者模式来实现的

RxJava 的观察者模式

RxJava 有四个基本概念:Observable (可观察者,即被观察者)、 Observer (观察者)、 subscribe (订阅)、事件。Observable 和 Observer 经过 subscribe() 方法实现订阅关系,从而 Observable 能够在须要的时候发出事件来通知 Observer。

与传统观察者模式不一样, RxJava 的事件回调方法除了普通事件 onNext() (至关于 onClick() / onEvent())以外,还定义了两个特殊的事件:onCompleted() 和 onError()。

  • onCompleted(): 事件队列完结。RxJava 不只把每一个事件单独处理,还会把它们看作一个队列。RxJava 规定,当不会再有新的 onNext() 发出时,须要触发 onCompleted() 方法做为标志。
  • onError(): 事件队列异常。在事件处理过程当中出异常时,onError() 会被触发,同时队列自动终止,不容许再有事件发出。
  • 在一个正确运行的事件序列中, onCompleted() 和 onError() 有且只有一个,而且是事件序列中的最后一个。须要注意的是,onCompleted() 和 onError() 两者也是互斥的,即在队列中调用了其中一个,就不该该再调用另外一个。

RxJava 的观察者模式大体以下图:

基本实现

基于以上的概念, RxJava 的基本实现主要有三点:

1) 建立 Observer

Observer 即观察者,它决定事件触发的时候将有怎样的行为。 RxJava 中的 Observer 接口的实现方式:

Observer<String> observer = new Observer<String>() {
    @Override
    public void onNext(String s) {
        Log.d(tag, "Item: " + s);
    }

    @Override
    public void onCompleted() {
        Log.d(tag, "Completed!");
    }

    @Override
    public void onError(Throwable e) {
        Log.d(tag, "Error!");
    }
};

除了 Observer 接口以外,RxJava 还内置了一个实现了 Observer 的抽象类:Subscriber。 Subscriber 对 Observer 接口进行了一些扩展,但他们的基本使用方式是彻底同样的:

Subscriber<String> subscriber = new Subscriber<String>() {
    @Override
    public void onNext(String s) {
        Log.d(tag, "Item: " + s);
    }

    @Override
    public void onCompleted() {
        Log.d(tag, "Completed!");
    }

    @Override
    public void onError(Throwable e) {
        Log.d(tag, "Error!");
    }
};

不只基本使用方式同样,实质上,在 RxJava 的 subscribe 过程当中,Observer 也老是会先被转换成一个 Subscriber 再使用。因此若是你只想使用基本功能,选择 Observer 和 Subscriber 是彻底同样的。它们的区别对于使用者来讲主要有两点:

  • onStart(): 这是 Subscriber 增长的方法。它会在 subscribe 刚开始,而事件还未发送以前被调用,能够用于作一些准备工做,例如数据的清零或重置。这是一个可选方法,默认状况下它的实现为空。须要注意的是,若是对准备工做的线程有要求(例如弹出一个显示进度的对话框,这必须在主线程执行), onStart() 就不适用了,由于它老是在 subscribe 所发生的线程被调用,而不能指定线程。要在指定的线程来作准备工做,可使用 doOnSubscribe() 方法,具体能够在后面的文中看到。
  • unsubscribe(): 这是 Subscriber 所实现的另外一个接口 Subscription 的方法,用于取消订阅。在这个方法被调用后,Subscriber 将再也不接收事件。通常在这个方法调用前,可使用 isUnsubscribed() 先判断一下状态。 unsubscribe() 这个方法很重要,由于在 subscribe() 以后, Observable 会持有 Subscriber 的引用,这个引用若是不能及时被释放,将有内存泄露的风险。因此最好保持一个原则:要在再也不使用的时候尽快在合适的地方(例如 onPause() onStop() 等方法中)调用 unsubscribe() 来解除引用关系,以免内存泄露的发生。

2) 建立 Observable

Observable 即被观察者,它决定何时触发事件以及触发怎样的事件。 RxJava 使用 create() 方法来建立一个 Observable ,并为它定义事件触发规则:

Observable observable = Observable.create(new Observable.OnSubscribe<String>() {
    @Override
    public void call(Subscriber<? super String> subscriber) {
        subscriber.onNext("Hello");
        subscriber.onNext("Hi");
        subscriber.onNext("Aloha");
        subscriber.onCompleted();
    }
});

能够看到,这里传入了一个 OnSubscribe 对象做为参数。OnSubscribe 会被存储在返回的 Observable 对象中,它的做用至关于一个计划表,当 Observable 被订阅的时候,OnSubscribe 的 call() 方法会自动被调用,事件序列就会依照设定依次触发(对于上面的代码,就是观察者Subscriber 将会被调用三次 onNext() 和一次 onCompleted())。这样,由被观察者调用了观察者的回调方法,就实现了由被观察者向观察者的事件传递,即观察者模式。

这个例子很简单:事件的内容是字符串,而不是一些复杂的对象;事件的内容是已经定好了的,而不像有的观察者模式同样是待肯定的(例如网络请求的结果在请求返回以前是未知的);全部事件在一瞬间被所有发送出去,而不是夹杂一些肯定或不肯定的时间间隔或者通过某种触发器来触发的。总之,这个例子看起来毫无实用价值。但这是为了便于说明,实质上只要你想,各类各样的事件发送规则你均可以本身来写。至于具体怎么作,后面都会讲到,但如今不行。只有把基础原理先说明白了,上层的运用才能更容易说清楚。

create() 方法是 RxJava 最基本的创造事件序列的方法。基于这个方法, RxJava 还提供了一些方法用来快捷建立事件队列,例如:

just(T…): 将传入的参数依次发送出来。

Observable observable = Observable.just("Hello", "Hi", "Aloha");
// 将会依次调用:
// onNext("Hello");
// onNext("Hi");
// onNext("Aloha");
// onCompleted();

from(T[]) / from(Iterable

String[] words = {"Hello", "Hi", "Aloha"};
Observable observable = Observable.from(words);
// 将会依次调用:
// onNext("Hello");
// onNext("Hi");
// onNext("Aloha");
// onCompleted();

上面 just(T…) 的例子和 from(T[]) 的例子,都和以前的 create(OnSubscribe) 的例子是等价的。

3) Subscribe (订阅)

建立了 Observable 和 Observer 以后,再用 subscribe() 方法将它们联结起来,整条链子就能够工做了。代码形式很简单:

observable.subscribe(observer);
// 或者:
observable.subscribe(subscriber);

有人可能会注意到, subscribe() 这个方法有点怪:它看起来是『observalbe 订阅了 observer / subscriber』而不是『observer / subscriber 订阅了 observalbe』,这看起来就像『杂志订阅了读者』同样颠倒了对象关系。这让人读起来有点别扭,不过若是把 API 设计成 observer.subscribe(observable) / subscriber.subscribe(observable) ,虽然更加符合思惟逻辑,但对流式 API 的设计就形成影响了,比较起来明显是得不偿失的。

Observable.subscribe(Subscriber) 的内部实现是这样的(仅核心代码):

// 注意:这不是 subscribe() 的源码,而是将源码中与性能、兼容性、扩展性有关的代码剔除后的核心代码。
// 若是须要看源码,能够去 RxJava 的 GitHub 仓库下载。
public Subscription subscribe(Subscriber subscriber) {
    subscriber.onStart();
    onSubscribe.call(subscriber);
    return subscriber;
}

能够看到,subscriber() 作了3件事:

调用 Subscriber.onStart() 。这个方法在前面已经介绍过,是一个可选的准备方法。
调用 Observable 中的 OnSubscribe.call(Subscriber) 。在这里,事件发送的逻辑开始运行。从这也能够看出,在 RxJava 中, Observable 并非在建立的时候就当即开始发送事件,而是在它被订阅的时候,即当 subscribe() 方法执行的时候。
将传入的 Subscriber 做为 Subscription 返回。这是为了方便 unsubscribe().
整个过程当中对象间的关系以下图:

除了 subscribe(Observer) 和 subscribe(Subscriber) ,subscribe() 还支持不完整定义的回调,RxJava 会自动根据定义建立出 Subscriber 。形式以下:

Action1<String> onNextAction = new Action1<String>() {
    // onNext()
    @Override
    public void call(String s) {
        Log.d(tag, s);
    }
};
Action1<Throwable> onErrorAction = new Action1<Throwable>() {
    // onError()
    @Override
    public void call(Throwable throwable) {
        // Error handling
    }
};
Action0 onCompletedAction = new Action0() {
    // onCompleted()
    @Override
    public void call() {
        Log.d(tag, "completed");
    }
};

// 自动建立 Subscriber ,并使用 onNextAction 来定义 onNext()
observable.subscribe(onNextAction);
// 自动建立 Subscriber ,并使用 onNextAction 和 onErrorAction 来定义 onNext() 和 onError()
observable.subscribe(onNextAction, onErrorAction);
// 自动建立 Subscriber ,并使用 onNextAction、 onErrorAction 和 onCompletedAction 来定义 onNext()、 onError() 和 onCompleted()
observable.subscribe(onNextAction, onErrorAction, onCompletedAction);

简单解释一下这段代码中出现的 Action1 和 Action0。 Action0 是 RxJava 的一个接口,它只有一个方法 call(),这个方法是无参无返回值的;因为 onCompleted() 方法也是无参无返回值的,所以 Action0 能够被当成一个包装对象,将 onCompleted() 的内容打包起来将本身做为一个参数传入 subscribe() 以实现不完整定义的回调。这样其实也能够看作将 onCompleted() 方法做为参数传进了 subscribe(),至关于其余某些语言中的『闭包』。 Action1 也是一个接口,它一样只有一个方法 call(T param),这个方法也无返回值,但有一个参数;与 Action0 同理,因为 onNext(T obj) 和 onError(Throwable error) 也是单参数无返回值的,所以 Action1 能够将 onNext(obj) 和 onError(error) 打包起来传入 subscribe() 以实现不完整定义的回调。事实上,虽然 Action0 和 Action1 在 API 中使用最普遍,但 RxJava 是提供了多个 ActionX 形式的接口 (例如 Action2, Action3) 的,它们能够被用以包装不一样的无返回值的方法。

注:正如前面所提到的,Observer 和 Subscriber 具备相同的角色,并且 Observer 在 subscribe() 过程当中最终会被转换成 Subscriber 对象,所以,从这里开始,后面的描述我将用 Subscriber 来代替 Observer ,这样更加严谨。

4) 场景示例

下面举两个例子:

为了把原理用更清晰的方式表述出来,本文中挑选的都是功能尽量简单的例子,以致于有些示例代码看起来会有『多此一举』『明明不用 RxJava 能够更简便地解决问题』的感受。当你看到这种状况,不要以为是由于 RxJava 太啰嗦,而是由于在过早的时候举出真实场景的例子并不利于原理的解析,所以我刻意挑选了简单的情景。

a. 打印字符串数组

将字符串数组 names 中的全部字符串依次打印出来:

String[] names = ...;
Observable.from(names)
    .subscribe(new Action1<String>() {
        @Override
        public void call(String name) {
            Log.d(tag, name);
        }
    });

b. 由 id 取得图片并显示

由指定的一个 drawable 文件 id drawableRes 取得图片,并显示在 ImageView 中,并在出现异常的时候打印 Toast 报错:

int drawableRes = ...;
ImageView imageView = ...;
Observable.create(new OnSubscribe<Drawable>() {
    @Override
    public void call(Subscriber<? super Drawable> subscriber) {
        Drawable drawable = getTheme().getDrawable(drawableRes));
        subscriber.onNext(drawable);
        subscriber.onCompleted();
    }
}).subscribe(new Observer<Drawable>() {
    @Override
    public void onNext(Drawable drawable) {
        imageView.setImageDrawable(drawable);
    }

    @Override
    public void onCompleted() {
    }

    @Override
    public void onError(Throwable e) {
        Toast.makeText(activity, "Error!", Toast.LENGTH_SHORT).show();
    }
});

正如上面两个例子这样,建立出 Observable 和 Subscriber ,再用 subscribe() 将它们串起来,一次 RxJava 的基本使用就完成了。很是简单。

线程控制 —— Scheduler (一)

在不指定线程的状况下, RxJava 遵循的是线程不变的原则,即:在哪一个线程调用 subscribe(),就在哪一个线程生产事件;在哪一个线程生产事件,就在哪一个线程消费事件。若是须要切换线程,就须要用到 Scheduler (调度器)。

1) Scheduler 的 API (一)

在RxJava 中,Scheduler ——调度器,至关于线程控制器,RxJava 经过它来指定每一段代码应该运行在什么样的线程。RxJava 已经内置了几个 Scheduler ,它们已经适合大多数的使用场景:

  • Schedulers.immediate(): 直接在当前线程运行,至关于不指定线程。这是默认的 Scheduler。
  • Schedulers.newThread(): 老是启用新线程,并在新线程执行操做。
  • Schedulers.io(): I/O 操做(读写文件、读写数据库、网络信息交互等)所使用的 Scheduler。行为模式和 newThread() 差很少,区别在于 io() 的内部实现是是用一个无数量上限的线程池,能够重用空闲的线程,所以多数状况下 io() 比 newThread() 更有效率。不要把计算工做放在 io() 中,能够避免建立没必要要的线程。
  • Schedulers.computation(): 计算所使用的 Scheduler。这个计算指的是 CPU 密集型计算,即不会被 I/O 等操做限制性能的操做,例如图形的计算。这个 Scheduler 使用的固定的线程池,大小为 CPU 核数。不要把 I/O 操做放在 computation() 中,不然 I/O 操做的等待时间会浪费 CPU。

另外, Android 还有一个专用的 AndroidSchedulers.mainThread(),它指定的操做将在 Android 主线程运行。
有了这几个 Scheduler ,就可使用 subscribeOn() 和 observeOn() 两个方法来对线程进行控制了。 * subscribeOn(): 指定 subscribe() 所发生的线程,即 Observable.OnSubscribe 被激活时所处的线程。或者叫作事件产生的线程。 * observeOn(): 指定 Subscriber 所运行在的线程。或者叫作事件消费的线程。

文字叙述总归难理解,上代码:

Observable.just(1, 2, 3, 4)
    .subscribeOn(Schedulers.io()) // 指定 subscribe() 发生在 IO 线程
    .observeOn(AndroidSchedulers.mainThread()) // 指定 Subscriber 的回调发生在主线程
    .subscribe(new Action1<Integer>() {
        @Override
        public void call(Integer number) {
            Log.d(tag, "number:" + number);
        }
    });

上面这段代码中,因为 subscribeOn(Schedulers.io()) 的指定,被建立的事件的内容 一、二、三、4 将会在 IO 线程发出;而因为 observeOn(AndroidScheculers.mainThread()) 的指定,所以 subscriber 数字的打印将发生在主线程 。事实上,这种在 subscribe() 以前写上两句 subscribeOn(Scheduler.io()) 和 observeOn(AndroidSchedulers.mainThread()) 的使用方式很是常见,它适用于多数的 『后台线程取数据,主线程显示』的程序策略。

而前面提到的由图片 id 取得图片并显示的例子,若是也加上这两句:

int drawableRes = ...;
ImageView imageView = ...;
Observable.create(new OnSubscribe<Drawable>() {
    @Override
    public void call(Subscriber<? super Drawable> subscriber) {
        Drawable drawable = getTheme().getDrawable(drawableRes));
        subscriber.onNext(drawable);
        subscriber.onCompleted();
    }
})
.subscribeOn(Schedulers.io()) // 指定 subscribe() 发生在 IO 线程
.observeOn(AndroidSchedulers.mainThread()) // 指定 Subscriber 的回调发生在主线程
.subscribe(new Observer<Drawable>() {
    @Override
    public void onNext(Drawable drawable) {
        imageView.setImageDrawable(drawable);
    }

    @Override
    public void onCompleted() {
    }

    @Override
    public void onError(Throwable e) {
        Toast.makeText(activity, "Error!", Toast.LENGTH_SHORT).show();
    }
});

那么,加载图片将会发生在 IO 线程,而设置图片则被设定在了主线程。这就意味着,即便加载图片耗费了几十甚至几百毫秒的时间,也不会形成丝毫界面的卡顿。

2) Scheduler 的原理 (一)

RxJava 的 Scheduler API 很方便,也很神奇(加了一句话就把线程切换了,怎么作到的?并且 subscribe() 不是最外层直接调用的方法吗,它居然也能被指定线程?)。然而 Scheduler 的原理须要放在后面讲,由于它的原理是如下一节《变换》的原理做为基础的。

好吧这一节其实我屁也没说,只是为了让你安心,让你知道我不是忘了讲原理,而是把它放在了更合适的地方。

变换

终于要到牛逼的地方了,无论你激动不激动,反正我是激动了。

RxJava 提供了对事件序列进行变换的支持,这是它的核心功能之一,也是大多数人说『RxJava 真是太好用了』的最大缘由。所谓变换,就是将事件序列中的对象或整个序列进行加工处理,转换成不一样的事件或事件序列。概念说着老是模糊难懂的,来看 API。

1) API

首先看一个 map() 的例子:

Observable.just("images/logo.png") // 输入类型 String
    .map(new Func1<String, Bitmap>() {
        @Override
        public Bitmap call(String filePath) { // 参数类型 String
            return getBitmapFromPath(filePath); // 返回类型 Bitmap
        }
    })
    .subscribe(new Action1<Bitmap>() {
        @Override
        public void call(Bitmap bitmap) { // 参数类型 Bitmap
            showBitmap(bitmap);
        }
    });

这里出现了一个叫作 Func1 的类。它和 Action1 很是类似,也是 RxJava 的一个接口,用于包装含有一个参数的方法。 Func1 和 Action 的区别在于, Func1 包装的是有返回值的方法。另外,和 ActionX 同样, FuncX 也有多个,用于不一样参数个数的方法。FuncX 和 ActionX 的区别在 FuncX 包装的是有返回值的方法。

能够看到,map() 方法将参数中的 String 对象转换成一个 Bitmap 对象后返回,而在通过 map() 方法后,事件的参数类型也由 String 转为了 Bitmap。这种直接变换对象并返回的,是最多见的也最容易理解的变换。不过 RxJava 的变换远不止这样,它不只能够针对事件对象,还能够针对整个事件队列,这使得 RxJava 变得很是灵活。我列举几个经常使用的变换:

map(): 事件对象的直接变换,具体功能上面已经介绍过。它是 RxJava 最经常使用的变换。 map() 的示意图:

flatmap

这是一个颇有用但很是难理解的变换,所以我决定花多些篇幅来介绍它。 首先假设这么一种需求:假设有一个数据结构『学生』,如今须要打印出一组学生的名字。实现方式很简单:

Student[] students = ...;
Subscriber<String> subscriber = new Subscriber<String>() {
    @Override
    public void onNext(String name) {
        Log.d(tag, name);
    }
    ...
};
Observable.from(students)
    .map(new Func1<Student, String>() {
        @Override
        public String call(Student student) {
            return student.getName();
        }
    })
    .subscribe(subscriber);

很简单。那么再假设:若是要打印出每一个学生所须要修的全部课程的名称呢?(需求的区别在于,每一个学生只有一个名字,但却有多个课程。)首先能够这样实现:

Student[] students = ...;
Subscriber<Student> subscriber = new Subscriber<Student>() {
    @Override
    public void onNext(Student student) {
        List<Course> courses = student.getCourses();
        for (int i = 0; i < courses.size(); i++) {
            Course course = courses.get(i);
            Log.d(tag, course.getName());
        }
    }
    ...
};
Observable.from(students)
    .subscribe(subscriber);

依然很简单。那么若是我不想在 Subscriber 中使用 for 循环,而是但愿 Subscriber 中直接传入单个的 Course 对象呢(这对于代码复用很重要)?用 map() 显然是不行的,由于 map() 是一对一的转化,而我如今的要求是一对多的转化。那怎么才能把一个 Student 转化成多个 Course 呢?

这个时候,就须要用 flatMap() 了:

Student[] students = ...;
Subscriber<Course> subscriber = new Subscriber<Course>() {
    @Override
    public void onNext(Course course) {
        Log.d(tag, course.getName());
    }
    ...
};
Observable.from(students)
    .flatMap(new Func1<Student, Observable<Course>>() {
        @Override
        public Observable<Course> call(Student student) {
            return Observable.from(student.getCourses());
        }
    })
    .subscribe(subscriber);

从上面的代码能够看出, flatMap() 和 map() 有一个相同点:它也是把传入的参数转化以后返回另外一个对象。但须要注意,和 map() 不一样的是, flatMap() 中返回的是个 Observable 对象,而且这个 Observable 对象并非被直接发送到了 Subscriber 的回调方法中。 flatMap() 的原理是这样的:1. 使用传入的事件对象建立一个 Observable 对象;2. 并不发送这个 Observable, 而是将它激活,因而它开始发送事件;3. 每个建立出来的 Observable 发送的事件,都被汇入同一个 Observable ,而这个 Observable 负责将这些事件统一交给 Subscriber 的回调方法。这三个步骤,把事件拆成了两级,经过一组新建立的 Observable 将初始的对象『铺平』以后经过统一路径分发了下去。而这个『铺平』就是 flatMap() 所谓的 flat。

flatMap() 示意图:

3) 延伸:doOnSubscribe()

然而,虽然超过一个的 subscribeOn() 对事件处理的流程没有影响,但在流程以前倒是能够利用的。

在前面讲 Subscriber 的时候,提到过 Subscriber 的 onStart() 能够用做流程开始前的初始化。然而 onStart() 因为在 subscribe() 发生时就被调用了,所以不能指定线程,而是只能执行在 subscribe() 被调用时的线程。这就致使若是 onStart() 中含有对线程有要求的代码(例如在界面上显示一个 ProgressBar,这必须在主线程执行),将会有线程非法的风险,由于有时你没法预测 subscribe() 将会在什么线程执行。

而与 Subscriber.onStart() 相对应的,有一个方法 Observable.doOnSubscribe() 。它和 Subscriber.onStart() 一样是在 subscribe() 调用后并且在事件发送前执行,但区别在于它能够指定线程。默认状况下, doOnSubscribe() 执行在 subscribe() 发生的线程;而若是在 doOnSubscribe() 以后有 subscribeOn() 的话,它将执行在离它最近的 subscribeOn() 所指定的线程。

进度条示例代码:

ProgressDialog progress = ...;

    ...
    .observeOn(AndroidSchedulers.mainThread()) // 规定Subscriber在主线程回调
    .doOnSubscribe(new Action0() { //  主线程
        @Override
        public void call() {
            progress.show();
        }
    })
    .doOnCompleted(new Action0() { // 主线程
        @Override
        public void call() {
            progress.dismiss();
        }
    })
    .subscribe(new Subscriber<List<String>>() { // 主线程
        @Override
        public void onNext(List<String> strings) {...}
        @Override
        public void onComplete() {...}
    }

参考连接

给 Android 开发者的 RxJava 详解

RxJava快速入门 - 简书

相关文章
相关标签/搜索