[精华翻译] Rxjava 2.x : What's d

本人学习完了 RxJava 2.x ：What's different in 2.0 后，将值得重点注意的变化进行了翻译和归纳，适合正在使用 1.x 的同学快速了解 2.x , 如有错误之处欢迎批评指正。

注意

• RxJava 1.x 和 2.x 是两个独立的分支，不相互兼容 ，也不能同时使用
• RxJava 1.x 官方支持到 March 31, 2018
• 如果项目里的第三方库引用了 1.x 的话，同样不能使用 2.x

Maven仓库依赖地址和包名的变更 ：

• Maven 仓库地址在 io.reactivex.rxjava2:rxjava:2.x.y 下
• 类在包名为 io.reactivex 下
• JavaDoc 在 http://reactivex.io/RxJava/2.x/javadoc/

Nulls

Rxjava 2.x 不再接受 null，下面的情况会立即抛出 NullPointerException

Observable.just(null);

Single.just(null);

Observable.fromCallable(() -> null)
    .subscribe(System.out::println, Throwable::printStackTrace);

Observable.just(1).map(v -> null)
    .subscribe(System.out::println, Throwable::printStackTrace);

也就是说 Observable<Null> 也不被允许，作为代替，我们可以定义一个Observable<Object>传入一个不相关的值，如下：

enum Irrelevant { INSTANCE; }

Observable<Object> source = Observable.create((ObservableEmitter<Object> emitter) -> {
   System.out.println("Side-effect 1");
   emitter.onNext(Irrelevant.INSTANCE);

   System.out.println("Side-effect 2");
   emitter.onNext(Irrelevant.INSTANCE);

   System.out.println("Side-effect 3");
   emitter.onNext(Irrelevant.INSTANCE);
});

source.subscribe(e -> { /* Ignored. */ }, Throwable::printStackTrace);

Observable and Flowable

Rxjava 2.x 一个大的改进就是解决了 1.x 中不支持 backpressure 问题
解决方案是将过去的 Observable 重新设计为：

• 不支持 backpressure 的 io.reactivex.Observable :
  现在 Observable会将没有消费的数据保存在内存中直到OutOfMemoryError而不会抛出MissBackpressureException
• 支持 backpressure 的 io.reactivex.Flowable
  在 Flowable.create()创建时指定背压策略 : 如BackpressureStrategy.DROP

两种类型的使用场景

Observable:

• 流需要处理的元素不超过1K 或者不会产生 OOME
• 响应 Mouse Touch 相关GUI操作的事件

Flowable:

• 流的超过10K个元素的流
• 一系列可能阻塞消费的操作（解析文件、网络请求、数据库操作...）

Single Completable Maybe

2.x 整个架构都按照 Reactive-Streams 规范设计, 所以现在的基本消费者类型改为了接口

Single: 只关心调用成功后对数据的处理

onSubscribe (onSuccess | onError)?

Completable：只关心是否调用成功

onSubscribe (onComplete | onError)?.

Maybe：可能出现无数据或只有一个数据的情况，所以onSuccess()和onComplete()只会调用其中一个

onSubscribe (onSuccess | onError | onComplete)?

Base reactive interfaces

与 Reactive-Streams 中 Flowable extends Publisher<T> 风格一样，其他基本响应类也有类似的基础接口

interface ObservableSource<T> {
    void subscribe(Observer<? super T> observer);
}

interface SingleSource<T> {
    void subscribe(SingleObserver<? super T> observer);
}

interface CompletableSource {
    void subscribe(CompletableObserver observer);
}

interface MaybeSource<T> {
    void subscribe(MaybeObserver<? super T> observer);
}

所以现在的操作符也接受 Publisher 和 XSource:

Flowable<R> flatMap(Function<? super T, ? extends Publisher<? extends R>> mapper);

Observable<R> flatMap(Function<? super T, ? extends ObservableSource<? extends R>> mapper);

Subjects and Processors

同样是为了解决 backpressure 问题把 Subjects 分为了 Subjects 和 Processors

io.reactivex.subjects.AsyncSubject
io.reactivex.subjects.BehaviorSubject
io.reactivex.subjects.PublishSubject
io.reactivex.subjects.ReplaySubject io.reactivex.subjects.UnicastSubject
不支持 backpressure , 属于 Observable 系列

io.reactivex.processors.AsyncProcessor
io.reactivex.processors.BehaviorProcessor io.reactivex.processors.PublishProcessor io.reactivex.processors.ReplayProcessor io.reactivex.processors.UnicastProcessor
支持 backpressure ，属于 Flowable 系列

TestSubject

1.x 的 TestSubject 已被丢弃，现在通过 TestScheduler , PublishProcessor/PublishSubject 和 observeOn(TestScheduler)代替

SerializedSubject

SerializedSubject
由 Subject.toSerialized() 和 FlowableProcessor.toSerialized() 代替

Other classes

rx.observables.GroupedObservable 由io.reactivex.observables.GroupedObservable<T> 和io.reactivex.flowables.GroupedFlowable<T>代替

Functional interfaces

functional 接口 默认定义了 throws Exception
不需要再内部try-catch

Actions Functions

符合 java8 命名规范

• Func -> Function , Action0/Action1/Action2 -> Action/Consumer/BiConsumer
• 删除了 Action3-9/Func3-9
  由 Action<Object[]>/Function<Object[],R>代替

Subscriber Subscription

• Reactive-Streams 规范中已经定义了 Subscriber 接口
  所以以前的 Subscriber 类的职能现在由 Subscriber 接口的实现类代替:
  DefaultSubscriber, ResourceSubscriber,DisposableSubscriber（以及它们的XObserver 变体）
  因为以上继承了Disposable 所以也支持通过 dispose() 来断开对信号的监听

ResourceSubscriber<Integer> subscriber = new ResourceSubscriber<Integer>() {
    @Override
    public void onStart() {
        request(Long.MAX_VALUE);
    }

    @Override
    public void onNext(Integer t) {
        System.out.println(t);
    }

    @Override
    public void onError(Throwable t) {
        t.printStackTrace();
    }

    @Override
    public void onComplete() {
        System.out.println("Done");
    }
};

Flowable.range(1, 10).delay(1, TimeUnit.SECONDS).subscribe(subscriber);

subscriber.dispose();

• CompositeSubscription -> CompositeDisposable
• subscribe() 不返回值
• subscribWith() 返回 CompositeDisposable
• onCompleted() -> onComplete()
• request() 决定 subscriber最大接受多少个事件

Schedulers

• 默认不变的线程:computation io newThread trampoline
• 移除:immediate -> tranmpoline
• 移除: test() -> new TestScheduler()
• 启动 Scheduler 无需再 createWorker
• new() 现在接受 TimeUnit 参数

Entering the reactive world

现在调用 Observalble.create() 更安全

Leaving the reactive world

从响应式流中离开的方式：

List<Integer> list = Flowable.range(1, 100).toList().blockingGet(); // toList() returns Single

Integer i = Flowable.range(100, 100).blockingLast();

另一个关于 rx.Subscriber 和 org.reactivestreams.Subscriber的重大变化是
Subscribers 和 Observers 内部不在允许 throws 任何东西除了致命异常（参见 Exceptions.throwIfFatal()）,所以下面的代码现在不合法：

Subscriber<Integer> subscriber = new Subscriber<Integer>() {
    @Override
    public void onSubscribe(Subscription s) {
        s.request(Long.MAX_VALUE);
    }

    public void onNext(Integer t) {
        if (t == 1) {
            throw new IllegalArgumentException();
        }
    }

    public void onError(Throwable e) {
        if (e instanceof IllegalArgumentException) {
            throw new UnsupportedOperationException();
        }
    }

    public void onComplete() {
        throw new NoSuchElementException();
    }
};

Flowable.just(1).subscribe(subscriber);

(Observer, SingleObserver, MaybeObserver and CompletableObserver 同理)

如果必须要这样 throws 可以选择使用 safeSubscribe()或 subscribe(Consumer<T>, Consumer<Throwable>, Action)的相关 Consumer 重载

Operator differences

关于操作符的调整主要是为了适配以上的变化，调整命名/参数/返回值
详见官方 Wiki 表格

总结

总的来说，我认为RxJava 2.x 主要做了三点更新

• 对 backpressure 问题进行了修正（产生了大量关联的修正）
• 按照 Reactive-Streams 规范对整个架构进行了重新设计
• 一些的其它零散更新

虽然 ReactiveX 基本思想没有变化，但因为官方对其进行了大量的重构，所以我们还是需要重新理解学习的。