前言

Rxjava由于其基于事件流的链式调用、逻辑简洁 & 使用简单的特点，深受各大 Android开发者的欢迎。

如果还不了解RxJava，请看文章：Android：这是一篇清晰 & 易懂的Rxjava 入门教程

RxJava 2.0已于2016 - 10.29正式发布，对 RxJava 1.0进行了1次重大升级：实际使用的API 及方法有很大的区别，但 RxJava 2.0 的使用思路和 RxJava 1.0 非常类似。同时，由于RxJava 2.0 跟 RxJava 1.0 不能共存在1个项目中，所以假如你在使用RxJava 1.0需要升级到RxJava 2.0，则需要做一些转变
今天，我将为大家带来 RxJava 2.0 相对于RxJava 1.0 的升级总结 & 从RxJava 1.0升级到RxJava 2.0需要注意的坑，希望大家会喜欢

Carson带你学RxJava系列文章，包括 原理、操作符、应用场景、背压等等，请关注看文章：Android：这是一份全面 & 详细的RxJava学习指南

1. 依赖包更改

由于RxJava 2.0 跟 RxJava 1.0 不能共存在1个项目中，所以依赖也不能共存，需要进行更换
改动如下

// 原本：`RxJava 1.0` 依赖
compile 'io.reactivex:rxandroid:1.2.0'
compile 'io.reactivex:rxjava:1.1.5'

// 更改：`RxJava 2.0` 依赖
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'
compile 'io.reactivex.rxjava2:rxjava:2.0.7'

// 注：RxJava2 与 RxJava1 不能共存，即依赖不能同时存在

2. 增加被观察者的新实现：Flowable

由于 RxJava 1.0 中的被观察者Observable不能很好地支持背压（Backpressure）
所以，在 RxJava 2.0 中 增加了被观察者的新实现 Flowable 来支持背压Backpressure

而被观察者的旧实现Observable不再支持背压Backpressure

Flowable的使用与 Observable非常类似，关于使用具体请看文章：Android RxJava 背压策略：图文 + 实例全面解析

3. 创建被观察者（Observable） & 观察者（Observer）方式的区别

在RxJava 2.0中，创建被观察者（Observable） & 观察者（Observer）的方式也与RxJava 1.0有些区别：

对于创建被观察者（Observable）

<-- RxJava 1.0 中 创建被观察者 -->
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();
    }
});

<-- RxJava 2.0 中 创建被观察者 -->
// 变化1：Observable.OnSubscribe接口名改成ObservableOnSubscribe 
Observable<Integer> observable=Observable.create(new ObservableOnSubscribe<Integer>() {

            // 变化2：复写的call（Subscriber）改成 subscribe （ObservableEmitter）    
            // 注：参数也发生了变化，即Subscriber -> ObservableEmitter = 发射器
           @Override
            public void subscribe(ObservableEmitter<Integer> e) throws Exception {
                // 可发出三种类型的事件：next事件、complete事件&error事件
                // 通过调用emitter.onNext(T value) 、onComplete()和onError(Throwable e)
                e.onNext(1);
                e.onNext(2);
                e.onError(new Exception("发生错误了"));
                e.onComplete();
            }
        });

对于创建观察者（Observer）

<-- RxJava 1.0 中 创建观察者（Observer） -->
// 方法1：采用 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!");
    }
};

// 方法2：采用 Subscriber 接口（实现了Observer接口的抽象类）
// 与Observer接口的区别：对 Observer接口进行了扩展：onStart()、unsubscribe()，但使用方式基本类似

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 2.0 中 创建观察者（Observer） -->
        Observer<Integer> observer= new Observer<Integer>() {

            // 变化1：增加回调方法onSubscribe()
            // 作用：最先调用该方法，即适合做初始化工作
            @Override
            public void onSubscribe(Disposable d) {
            // 传入的参数Disposable作用 类似于 Subsciption
            // 即相当于订阅关系的开关，即可切断 观察者和被观察者的订阅关系
            // 注：调用dispose() = 观察者无法接收事件，但被观察者还是会继续发送事件
            }

            @Override
            public void onNext(Integer value) {
            }

            @Override
            public void onError(Throwable e) {
            }
            // 变化2：onCompleted（）改成 onComplete（）
            @Override
            public void onComplete() {
            }
        }

4. 简化订阅方法

对于简化订阅的方式， RxJava 1 主要采用 ActionX接口 & FuncX接口
在 RxJava 2 中，主要是对这一系列接口的名字 按照Java8的命名规则 进行了修改，而使用方法不变

4.1 ActionX 和 FuncX 改名

对于 ActionX接口名的更改

RxJava 1	RxJava 2
Action0	Action
Action1	Consumer（接收1个参数）
Action2	BiConsumer （接收2个参数）
ActionN	Consumer<Object[]> （接收多个参数）
Action3 - Action9	不再使用

对于 FuncX接口名的更改

RxJava 1	RxJava 2
Func	Function （用于变换对象）
Func2	BiFunction
Func3 - Func9	Function3 - Function9
FuncN	Function<Object[], R>

具体如下

示意图

示例

<-- 示例1 -->
   Disposable disposable = observable.subscribe(new Consumer<Integer>() {
            @Override
            public void accept(Integer integer) throws Exception {
                  //这里接收数据项
            }
        }, new Consumer<Throwable>() {
            @Override
            public void accept(Throwable throwable) throws Exception {
              //这里接收onError
            }
        }, new Action() {
            @Override
            public void run() throws Exception {
              //这里接收onComplete。
            }
        });

<-- 示例2 -->
flowable.subscribe(
        new Consumer<String>() {//相当于onNext
            @Override
            public void accept(String s) throws Exception {
            }
        }, new Consumer<Throwable>() {//相当于onError
            @Override
            public void accept(Throwable throwable) throws Exception {
            }
        }, new Action() {//相当于onComplete，注意这里是Action
            @Override
            public void run() throws Exception {
            }
        }, new Consumer<Subscription>() {//相当于onSubscribe
            @Override
            public void accept(Subscription subscription) throws Exception {
            }
        });

4.2 RxJava2的接口方法都允许抛出异常

即，接口方法里加上了 throws Exception

// Action接口
public interface Action {
    void run() throws Exception;
}

// Consumer接口
public interface Consumer<T> {
    void accept(T t) throws Exception;
}

// 注：
  // 1. 这意味着，在这些方法里调用会发生异常的方法不需要try-catch
  // 2. RxJava 2.0 不再支持 null 值，如果传入一个null会抛出 NullPointerException

5. 操作符的改变

对于操作符，RxJava 1.0与 RxJava 2.0 在命名 & 行为上大多数保持了一致
需要强调的是first（）、subscribeWith（）和 compose()操作符

5.1 first（）操作符

改动如下

RxJava 1.0	RxJava 2.0
first（）	改名为：firstElement（）
first(Func1)	弃用，改用为：filter(predicate).first()
firstOrDefault(T)	改名为：first（T）
firstOrDefault(Func1, T)	改名为：first（T）

示例

<-- RxJava 1.0 -->
Observable
          .concat(Observable.from(list))
          .first(new Func1<Data, Boolean>() {
                @Override
                public Boolean call(Data data) {
                    return DataUtils.isAvailable(data);
                }
            }).publish();

<-- RxJava 2.0 -->
Observable
          .concat(Observable.fromIterable(list))
          .filter(new Predicate<Data>() {

                @Override
                public boolean test(@NonNull Data data) throws Exception {
                    return DataUtils.isAvailable(data);
                }
            }).firstElement().toObservable().publish();

5.2 subscribeWith（）操作符

具体请看下图：

示意图

5.3 compose（）操作符

主要变动在于：

RxJava 1.0实现的是：rx.Observable.Transformer接口

继承自Func1<Observable<T>, Observable<R>>

<-- RxJava 1.0 中的用法 -->
private static <T> Observable.Transformer<T, T> createIOSchedulers() {
        return new Observable.Transformer<T, T>() {
            @Override
            public Observable<T> call(Observable<T> tObservable) {
                return tObservable.subscribeOn(Schedulers.io())
                        .unsubscribeOn(AndroidSchedulers.mainThread())
                        .observeOn(AndroidSchedulers.mainThread());
            }
        };
    }

    public static <T> Observable.Transformer<JsonResult<T>,T> applySchedulers() {
        return createIOSchedulers（）;
    }

Action1<Integer> onNext = null;
String[] items = { "item1", "item2", "item3" };
Subscription subscription = Observable.from(items)
                                      .compose(RxUtil.<String>applySchedulers())
                                      .map(new Func1<String, Integer>() {
                                                  @Override public Integer call(String s) {
                                                      return Integer.valueOf(s);
                                                  }
                                              })
                                      .subscribe(onNext);

RxJava 2.0 实现的是io.reactivex.ObservableTansformer<Upstream, Downstream>

一个独立的接口

<-- RxJava 2.0 中的用法 -->
public static <T> ObservableTransformer<T, T> io2MainObservable() {
        return new ObservableTransformer<T, T>() {
            @Override
            public ObservableSource<T> apply(Observable<T> upstream) {
                return upstream.subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread());
            }
        };
    }

    public static <T> ObservableTransformer<T, T> applySchedulers() {
        return io2MainObservable（）;
    }

Consumer<Integer> onNext = null;
String[] items = { "item1", "item2", "item3" };
Disposable disposable = Observable.fromArray(items)
                                  .compose(RxUtil.<String>applySchedulers())
                                  .map(new Function<String, Integer>() {
                                              @Override public Integer apply(String s) throws Exception {
                                                  return Integer.valueOf(s);
                                              }
                                          })
                                  .subscribe(onNext);

6. 额外

6.1 新增Processor

作用类似于 Subject & 继承自 Flowable = 支持背压控制

而Subject则不支持背压控制

使用如下

//Processor
    AsyncProcessor<String> processor = AsyncProcessor.create();
    processor.subscribe(o -> Log.d("JG",o)); //three
    processor.onNext("one");
    processor.onNext("two");
    processor.onNext("three");
    processor.onComplete();

//Subject
    AsyncSubject<String> subject = AsyncSubject.create();
    subject.subscribe(o -> Log.d("JG",o));//three
    subject.onNext("one");
    subject.onNext("two");
    subject.onNext("three");
    subject.onComplete();

6.2 更改Single

Single的作用类似于 Observable = 发送数据，但区别在于订阅后只能接受到1次
改动如下

<-- 源码分析 -->
// 变动1：Single被重新设计为 Reactive-Streams架构，即SingleSubscriber 改为：SingleObserver
interface SingleObserver<T> {
    // 变动2：多了一个回调方法 onSubscribe（）
    void onSubscribe(Disposable d); 
    void onSuccess(T value);
    void onError(Throwable error);
}

<-- 具体使用 -->
Single<Long> single = Single.just(1l);

single.subscribe(new SingleObserver<Long>() {
    @Override
    public void onSubscribe(Disposable d) {
    }

    @Override
    public void onSuccess(Long value) {
        // 和onNext是一样的
    }

    @Override
    public void onError(Throwable e) {
    }
});

// 注：普通Observable对象可通过toSingle（）转换成Single对象
// 即，Observable.just(1).toSingle()

6.3 更改Completable

Completable的作用类似于 Observable = 发送数据，但区别在于订阅后只能接受 Complete 和 onError事件
改动如下

// 变动1：Completable被重新设计为 Reactive-Streams架构，即CompletableSubscriber 改为：CompletableObserver
interface CompletableObserver<T> {
    void onSubscribe(Disposable d);
    void onComplete();
    void onError(Throwable error);
}

<-- 具体使用 -->
Completable<Long> Completable = Completable.just(1l);
Completable.subscribe(new CompletableObserver<Long>() {
    @Override
    public void onSubscribe(Disposable d) {
    }

    @Override
    public void onComplete(Long value) {

    }

    @Override
    public void onError(Throwable e) {
    }
});

// 注：普通Observable对象可通过toCompletable()转换成Completable对象
// 即，Observable.just(1).toCompletable()

7. 使用建议

对于学习 & 在项目中使用RxJava的版本选择，我给出以下建议：

示意图

8. 总结

本文主要讲解了RxJava 2.0相对于 RxJava 1.0的变动
Carson带你学RxJava系列文章：

入门
Carson带你学Android：这是一篇清晰易懂的Rxjava入门教程
 Carson带你学Android：面向初学者的RxJava使用指南
 Carson带你学Android：RxJava2.0到底更新了什么？
原理
Carson带你学Android：图文解析RxJava原理
 Carson带你学Android：手把手带你源码分析RxJava
使用教程：操作符
Carson带你学Android：RxJava操作符教程
 Carson带你学Android：RxJava创建操作符
 Carson带你学Android：RxJava功能性操作符
 Carson带你学Android：RxJava过滤操作符
 Carson带你学Android：RxJava组合/合并操作符
 Carson带你学Android：RxJava变换操作符
 Carson带你学Android：RxJava条件/布尔操作符
实战
Carson带你学Android：什么时候应该使用Rxjava？(开发场景汇总)
Carson带你学Android：RxJava线程控制(含实例讲解)
Carson带你学Android：图文详解RxJava背压策略
 Carson带你学Android：RxJava、Retrofit联合使用汇总(含实例教程)
Carson带你学Android：优雅实现网络请求嵌套回调
 Carson带你学Android：网络请求轮询(有条件)
Carson带你学Android：网络请求轮询(无条件)
Carson带你学Android：网络请求出错重连(结合Retrofit)
Carson带你学Android：合并数据源
 Carson带你学Android：联想搜索优化
 Carson带你学Android：功能防抖
 Carson带你学Android：从磁盘/内存缓存中获取缓存数据
 Carson带你学Android：联合判断

欢迎关注Carson_Ho的简书

不定期分享关于安卓开发的干货，追求短、平、快，但却不缺深度。

Carson带你学Android：RxJava2.0到底更新了什么？

Carson带你学Android：RxJava2.0到底更新了什么？

前言

目录

1. 依赖包更改

2. 增加被观察者的新实现：Flowable

3. 创建被观察者（Observable） & 观察者（Observer）方式的区别

4. 简化订阅方法

4.1 ActionX 和 FuncX 改名

4.2 RxJava2的接口方法都允许抛出异常

5. 操作符的改变

5.1 first（）操作符

5.2 subscribeWith（）操作符

5.3 compose（）操作符

6. 额外

6.1 新增Processor

6.2 更改Single

6.3 更改Completable

7. 使用建议

8. 总结

欢迎关注Carson_Ho的简书

请点赞！因为你的鼓励是我写作的最大动力！

Carson带你学Android：RxJava2.0到底更新了什么？

前言

目录

1. 依赖包更改

2. 增加被观察者的新实现：Flowable

3. 创建被观察者（Observable） & 观察者（Observer） 方式的区别

4. 简化订阅方法

4.1 ActionX 和 FuncX 改名

4.2 RxJava2的接口方法都允许抛出异常

5. 操作符的改变

5.1 first（）操作符

5.2 subscribeWith（）操作符

5.3 compose（）操作符

6. 额外

6.1 新增Processor

6.2 更改Single

6.3 更改Completable

7. 使用建议

8. 总结

欢迎关注Carson_Ho的简书

请点赞！因为你的鼓励是我写作的最大动力！

3. 创建被观察者（Observable） & 观察者（Observer）方式的区别