RxJava 笔记

一、什么是 RxJava
https://github.com/ReactiveX/RxJava
RxJava is a Java VM implementation of Reactive Extensions:
a library for composing asynchronous and event-based programs by using observable sequences.
(RxJava是一个java虚拟机实现的Reactive扩展：使用可观测的序列来组成异步的、基于事件的程序的库)

二、基本概念
简单的来说：RxJava是响应式程序设计的一种实现，是一种扩展的观察者模式，它继承观察者模式，支持序列数据或者事件。

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

与传统观察者模式不同， RxJava 的事件回调方法除了普通事件 onNext() 之外，还定义了两个特殊的事件：onCompleted() 和 onError()。
onCompleted(): 事件队列完结。RxJava 不仅把每个事件单独处理，还会把它们看做一个队列。RxJava 规定，当不会再有新的 onNext() 发出时，需要触发 onCompleted() 方法作为标志。
onError(): 事件队列异常。在事件处理过程中出异常时，onError() 会被触发，同时队列自动终止，不允许再有事件发出。
在一个正确运行的事件序列中, onCompleted() 和 onError() 有且只有一个，并且是事件序列中的最后一个。
注意：onCompleted() 和 onError() 二者是互斥的，即在队列中调用了其中一个，就不应该再调用另一个。

三、RxJava 的使用
(1) 创建 Observer
(2) 创建 Observable
(3) Subscribe (订阅)

// 创建 Observable
Observer<Integer> observer = new Observer<Integer>() {
    protected Disposable disposable;

    @Override
    public void onSubscribe(Disposable d) {
        this.disposable = d;
        System.out.println("onSubscribe: " + d.getClass());
    }

    @Override
    public void onNext(Integer t) {

        System.out.println("onNext: " + t);

        //切断的操作，让Observer观察者不再接收上游事件
        //disposable.dispose();
        disposable.isDisposed();
    }

    @Override
    public void onError(Throwable e) {
        System.out.println(e);
    }

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

// 创建 Observer
Observable<Integer> observable = Observable.create(new ObservableOnSubscribe<Integer>() {
    @Override
    public void subscribe(ObservableEmitter<Integer> e) throws Exception {

        System.out.println("<");

        for (int i = 0; i < 10; i++) {
            e.onNext(i);
        }
        e.onComplete();

        System.out.println("/>");
    }
});

// 订阅
observable.subscribe(observer);

RxJava 还提供了一些方法用来快捷创建事件队列

// fromArray与just相似，都可以用来发射单个或一组数据
// 区别在参数是数组的情况(fromArray会逐个发送数据，而just会将数组作为一个参数)
// 原因在于 fromArray方法接收的是一个可变参数，而just是固定个数的参数

Integer[] items = { 0, 1, 2, 3, 4, 5 };

// just(T...): 将传入的参数依次发送出来。
Observable.just(items).subscribe(t -> {
    System.out.println("just->" + t);
});

// fromArray(T[]) : 将传入的数组拆分成具体对象后，依次发送出来。
Observable.fromArray(items).subscribe(t -> {
    System.out.println("fromArray->" + t);
});

四、线程控制
在不指定线程的情况下， RxJava 遵循的是线程不变的原则(生产事件和消费事件在一个线程)，如果需要切换线程，就需要用到 Scheduler（调度器）。
RxJava 通过Scheduler来指定每一段代码应该运行在什么样的线程，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。)
AndroidSchedulers.mainThread():     Android 专用，它指定的操作将在 Android 主线程运行。

有了 Scheduler ，就可以使用 subscribeOn() 和 observeOn() 两个方法来对线程进行控制。
subscribeOn() 指定的就是发射事件的线程。observerOn 指定的就是订阅者接收事件的线程。
注意：多次指定发射事件的线程只有第一次指定的有效，也就是说多次调用 subscribeOn() 只有第一次的有效，其余的会被忽略。但多次指定订阅者接收线程是可以的，也就是说每调用一次 observerOn()，下游的线程就会切换一次。

Observable.just(1, 2, 3, 4, 5, 6, 7, 8, 9)//
        .subscribeOn(Schedulers.newThread())//指定发射事件的线程发生在 IO 线程
        .observeOn(Schedulers.newThread())//指定的就是订阅者总是启用新线程
        .doOnNext(new Consumer<Integer>() {
            @Override
            public void accept(@NonNull Integer integer) throws Exception {
                System.out.println("doOnNext:" + Thread.currentThread());
            }
        }).observeOn(Schedulers.newThread())//指定的就是订阅者总是启用新线程
        .subscribe(new Consumer<Integer>() {
            @Override
            public void accept(@NonNull Integer integer) throws Exception {
                System.out.println("subscribe:" + Thread.currentThread());
            }
        });

//等待执行完成
Thread.sleep(1000);