[精华翻译] Rxjava 2.x : What's different in 2.0

本文发表自简书 http://www.jianshu.com/p/f54a953e7099

本人读完了 RxJava 2.xWhat's different in 2.0 后,将值得重点注意的变化进行了翻译和归纳,如果错误请批评指正。

注意

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

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

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);
}

所以现在的操作符也接受 PublisherXSource:

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 分为了 SubjectsProcessors

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/PublishSubjectobserveOn(TestScheduler)代替

SerializedSubject

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

Other classes

rx.observables.GroupedObservableio.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.Subscriberorg.reactivestreams.Subscriber的重大变化是 SubscribersObservers 内部不在允许 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 基本思想没有变化,但因为官方对其进行了大量的重构,所以我们还是需要重新理解学习的。