RxJava1.x总结

一、RxJava概念：

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

onCompleted(): 事件队列完结。RxJava 不仅把每个事件单独处理，还会把它们看做一个队列。RxJava 规定，当不会再有新的 onNext() 发出时，需要触发 onCompleted() 方法作为标志。

onError(): 事件队列异常。在事件处理过程中出异常时，onError() 会被触发，同时队列自动终止，不允许再有事件发出。

在一个正确运行的事件序列中, onCompleted() 和 onError() 有且只有一个，并且是事件序列中的最后一个。需要注意的是，onCompleted() 和 onError() 二者也是互斥的，即在队列中调用了其中一个，就不应该再调用另一个。

2、创建 Observer

Subscriber subscriber = new Subscriber() {

    @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是一个接口，Subscriber是一个抽象类，Subscriber实现自Observer，选择 Observer 和 Subscriber 是完全一样的，区别在于：

①：onStart():Subscriber中多了个onStart()方法,可以做一些准备工作，他是在Subscribe所发生的线程被调用，而不能指定线程，要在指定的线程来做准备工作，可以使用doOnSubscribe()方法。

②：unsubscribe():这是Subscriber实现另一个接口Subscription中的方法，用于取消订阅。这个方法调用后，将不再接收事件，调用前先isUnsubscribed()判断状态。在Subscribe()之后，Observable会持有Subscriber的引用，避免内存泄漏的发生，调用unsubscribe()来解除引用关系。

3、创建Observable

Observable observable = Observable.create(new Observable.OnSubscribe() {

    @Override

    public void call(Subscriber subscriber) {

        subscriber.onNext("Hello");

        subscriber.onNext("Hi");

        subscriber.onNext("Aloha");

        subscriber.onCompleted();

    }

});

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

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

Observable observable = Observable.just("Hello", "Hi", "Aloha");

②：from(T[]) / from(Iterable) :

将传入的数组或 Iterable 拆分成具体对象后，依次发送出来。

String[] words = {"Hello", "Hi", "Aloha"};

Observable observable = Observable.from(words);

上面 just(T...) 的例子和 from(T[]) 的例子，都和之前的 create(OnSubscribe) 的例子是等价的。

4、Subscribe (订阅)

observable.subscribe(observer);

// 或者：

observable.subscribe(subscriber);

5、不完整定义的回调

Action1 onNextAction = new Action1() {

    // onNext()

    @Override

    public void call(String s) {

        Log.d(tag, s);

    }

};

Action1 onErrorAction = new Action1() {

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

说明：

Action0 是 RxJava 的一个接口，它只有一个方法 call()，这个方法是无参无返回值的

Action1 也是一个接口，它同样只有一个方法 call(T param)，这个方法也无返回值，但有一个参数；

6、应用场景

①：将字符串数组 names 中的所有字符串依次打印出来

String[] arr = {"小明","小红","小花"};

Observable.from(arr).subscribe(new Action1() {

    @Override

    public void call(String s) {

    Log.d("SDK","看看哪里调用了==="+s);

    }

});

②：由 id 取得图片并显示

int drawableRes = ...;

ImageView imageView = ...;

Observable.create(new OnSubscribe() {

    @Override

    public void call(Subscriber subscriber) {

        Drawable drawable = getTheme().getDrawable(drawableRes));

        subscriber.onNext(drawable);

        subscriber.onCompleted();

    }

}).subscribe(new Observer() {

    @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();

    }

});

二、线程控制--Scheduler(调度器)

1、Scheduler的api

①：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 主线程运行。

⑥：subscribeOn() 事件产生的线程

⑦：observeOn() 事件消费的线程

三、使用

①：map()  事件对象的直接变换，一对一的转化

Observable.just("images/logo.png") // 输入类型 String

    .map(new Func1() {

        @Override

        public Bitmap call(String filePath) { // 参数类型 String

            return getBitmapFromPath(filePath); // 返回类型 Bitmap

        }

    })

    .subscribe(new Action1() {

        @Override

        public void call(Bitmap bitmap) { // 参数类型 Bitmap

            showBitmap(bitmap);

        }

    });

FuncX 和 ActionX 的区别在 FuncX 包装的是有返回值的方法。

②：flatMap()    一对多得转化

场景：有个学生数组，打印出每个学生的中的所有课程

Student[] students = ...;

Subscriber subscriber = new Subscriber() {

    @Override

    public void onNext(Course course) {

        Log.d(tag, course.getName());

    }

    ...

};

Observable.from(students)

    .flatMap(new Func1>() {

        @Override

        public Observable call(Student student) {

            return Observable.from(student.getCourses());

        }

    })

    .subscribe(subscriber);

③：doOnSubscribe()

Observable.create(onSubscribe)

    .subscribeOn(Schedulers.io())

    .doOnSubscribe(new Action0() {

        @Override

        public void call() {

            progressBar.setVisibility(View.VISIBLE); // 需要在主线程执行

        }

    })

    .subscribeOn(AndroidSchedulers.mainThread()) // 指定主线程

    .observeOn(AndroidSchedulers.mainThread())

    .subscribe(subscriber);

在 doOnSubscribe()的后面跟一个 subscribeOn() ，就能指定准备工作的线程了。

四、Ï使用场景

1、 与 Retrofit 的结合

①：在操作User实体之前，需要拿User进行比对数据

@GET("/user")

public Observable getUser(@Query("userId") String userId);

getUser(userId)

    .doOnNext(new Action1() {

        @Override

        public void call(User user) {

            processUser(user);

        })

    .observeOn(AndroidSchedulers.mainThread())

    .subscribe(new Observer() {

        @Override

        public void onNext(User user) {

            userView.setUser(user);

        }

        @Override

        public void onCompleted() {

        }

        @Override

        public void onError(Throwable error) {

            // Error handling

            ...

        }

    });

②：假设 /user 接口并不能直接访问，而需要填入一个在线获取的 token

@GET("/token")

public Observable getToken();

@GET("/user")

public Observable getUser(@Query("token") String token, @Query("userId") String userId);

...

getToken()

    .flatMap(new Func1>() {

        @Override

        public Observable onNext(String token) {

            return getUser(token, userId);

        })

    .observeOn(AndroidSchedulers.mainThread())

    .subscribe(new Observer() {

        @Override

        public void onNext(User user) {

            userView.setUser(user);

        }

        @Override

        public void onCompleted() {

        }

        @Override

        public void onError(Throwable error) {

            // Error handling

            ...

        }

    });