RxJava 提供了对事件序列进行变换的支持;所谓变换,就是将事件序列中的对象或整个序列进行加工处理,转换成不同的事件或事件序列。
不仅可以针对事件对象,还可以针对整个事件队列。
变换部分主要来自《给Android 开发者的 RxJava 详解》
1. 事件对象变换-map()
:
map()
事件对象的直接变换;它是 RxJava
最常用的变换;可以将Observable深入的对象1转换为对象2发送给Subscriber。
基本用法如下:
Observable.just(R.drawable.t)
.map(new Func1<Integer, Drawable>() { @Override public Drawable call(Integer integer) { return getResources().getDrawable(integer); } }) .subscribe(new Action1<Drawable>() { @Override public void call(Drawable drawable) { showImg(drawable); } }); |
2. 事件序列变换-flatMap()
flatMap() 也和 map() 相同,也是把传入的参数转化之后返回另一个对象;和 map() 不同的是, flatMap() 中返回的是个 Observable 对象,并且这个 Observable 对象并不是被直接发送到了 Subscriber 的回调方法中。
flatMap() 的原理:
1. 使用传入的事件对象创建一个 Observable 对象;
2. 并不发送这个 Observable, 而是将它激活,于是它开始发送事件;
3. 每一个创建出来的 Observable 发送的事件,都被汇入同一个 Observable ,而这个 Observable 负责将这些事件统一交给 Subscriber 的回调方法。
这三个步骤,把事件拆成了两级,通过一组新创建的 Observable 将初始的对象『铺平』之后通过统一路径分发了下去。
//
扩展:由于可以在嵌套的Observable 中添加异步代码, flatMap() 也常用于嵌套的异步操作,例如嵌套的网络请求。
flatmap()基本用法如下,定义了一个Book类型,包含名称和章节列表;通过flatmap()打印出全部的章节列表。
? Book.java
public class Book {
public String name; public List<String> chapterList = new ArrayList<String>(); public void addChapter(String chapter) { chapterList.add(chapter); } } |
? flagmap()使用
Book[] books = getBookList(5);
Observable.from(books) .flatMap(new Func1<Book, Observable<String>>() { @Override public Observable<String> call(Book book) { return Observable.from(book.chapterList); } }) .subscribe(new Action1<String>() { @Override public void call(String s) { Log.v(TAG, s); } }); |
3. 变换的原理:lift()
所有的变换功能可能有所不同,实质上都是针对事件序列的处理和再发送。而在 RxJava 的内部,它们是基于同一个基础的变换方法: lift(Operator)。
lift()实现的源码:
/**
* Lifts a function to the current Observable and returns a new Observable that when subscribed to will pass * the values of the current Observable through the Operator function. * <p> * In other words, this allows chaining Observers together on an Observable for acting on the values within * the Observable. * <p> {@code * observable.map(...).filter(...).take(5).lift(new OperatorA()).lift(new OperatorB(...)).subscribe() * } * <p> * If the operator you are creating is designed to act on the individual items emitted by a source * Observable, use {@code lift}. If your operator is designed to transform the source Observable as a whole * (for instance, by applying a particular set of existing RxJava operators to it) use {@link #compose}. * <dl> * <dt><b>Scheduler:</b></dt> * <dd>{@code lift} does not operate by default on a particular {@link Scheduler}.</dd> * </dl> * * @param operator the Operator that implements the Observable-operating function to be applied to the source * Observable * @return an Observable that is the result of applying the lifted Operator to the source Observable * @see <a href="https://github.com/ReactiveX/RxJava/wiki/Implementing-Your-Own-Operators">RxJava wiki: Implementing Your Own Operators</a> */ public final <R> Observable<R> lift(final Operator<? extends R, ? super T> operator) { return new Observable<R>(new OnSubscribe<R>() { @Override public void call(Subscriber<? super R> o) { try { Subscriber<? super T> st = hook.onLift(operator).call(o); try { // new Subscriber created and being subscribed with so ‘onStart‘ it st.onStart(); onSubscribe.call(st); } catch (Throwable e) { // localized capture of errors rather than it skipping all operators // and ending up in the try/catch of the subscribe method which then // prevents onErrorResumeNext and other similar approaches to error handling Exceptions.throwIfFatal(e); st.onError(e); } } catch (Throwable e) { Exceptions.throwIfFatal(e); // if the lift function failed all we can do is pass the error to the final Subscriber // as we don‘t have the operator available to us o.onError(e); } } }); } |
通过lift()源码可以发现,生成了一个新的Observable(new);并且在新的Observable(new)的OnSubscribe(new)的call()回调方法中,创建了一个新的Subscriber(new),该新的Subscriber(最终目标)使用了最终调用的Subscriber的代理;再使用原来的Observable(old)的onSubscribe(old)来调用新的Subscriber(new)。
图示lift()变换过程-(图片来自《给Android 开发者的 RxJava 详解》)
lift()
实现过程
1) lift() 创建一个新Observable ,此时加上之前的原始 Observable,已经有两个 Observable 了;
2) 而同样地,新 Observable 里的新 OnSubscribe 加上之前的原始 Observable 中的原始 OnSubscribe,也就有了两个 OnSubscribe;
3) 当用户调用经过 lift() 后的 Observable 的 subscribe() 的时候,使用的是 lift() 所返回的新的 Observable ,于是它所触发的 onSubscribe.call(subscriber),也是用的新 Observable 中的新OnSubscribe,即在 lift() 中生成的那个 OnSubscribe;
4) 而这个新 OnSubscribe 的 call() 方法中的 onSubscribe ,就是指的原始 Observable 中的原始 OnSubscribe ,在这个 call() 方法里,新 OnSubscribe 利用 operator.call(subscriber) 生成了一个新的 Subscriber(Operator 就是在这里,通过自己的call() 方法将新 Subscriber 和原始 Subscriber 进行关联,并插入自己的『变换』代码以实现变换),然后利用这个新
Subscriber 向原始 Observable 进行订阅。
lift() 过程,有点像一种代理机制,通过事件拦截和处理实现事件序列的变换。
在 Observable 执行了lift(Operator) 方法之后,会返回一个新的 Observable,这个新的 Observable 会像一个代理一样,负责接收原始的 Observable 发出的事件,并在处理后发送给 Subscriber。
4. 自定义Observable.Operator,直接调用lift()
下面实例实现的功能跟前面flatMap()实现的功能一致:
Observable.from(getBookList(4))
.lift(new Observable.Operator<String, Book>() { @Override public Subscriber<? super Book> call(final Subscriber<? super String> subscriber) { return new Subscriber<Book>() { @Override public void onCompleted() { subscriber.onCompleted(); } @Override public void onError(Throwable e) { subscriber.onError(e); } @Override public void onNext(Book book) { for(String chapter : book.chapterList) { subscriber.onNext(chapter); } } }; } }) .subscribe(new Action1<String>() { @Override public void call(String s) { Log.v(TAG, s); } }); |
5. compose(Transformer)变换
compose(Transformer)变换,针对Observable 自身进行变换。假设在程序中有多个 Observable ,并且他们都需要应用一组相同的 lift() 变换,可以使用compose方式处理,而不是每个都调用一次相同的变换过程
实例代码,如需要将Book转换得到对应的全部章节,两个Observable对章节数据有不同的处理方式:
final Observable.Transformer bookTtransformer = new Observable.Transformer<Book, String>() {
@Override public Observable<String> call(Observable<Book> bookObservable) { return bookObservable.flatMap(new Func1<Book, Observable<String>>() { @Override public Observable<String> call(Book book) { return Observable.from(book.chapterList); } }); } }; Observable.from(getBookList(4)) .compose(bookTtransformer) .subscribe(new Action1<String>() { @Override public void call(String s) { //处理方式1 Log.v(TAG, s); } }); //// Observable.from(getBookList(2)) .compose(bookTtransformer) .subscribe(new Action1<String>() { @Override public void call(String s) { //处理方式2 Log.v(TAG, s); } }); |