RxJava2.0之旅(五)---功能性操作符

1 小结

类型 方法 作用 细分类
连接被观察者&观察者 subscribe()
线程调度 subscribeOn()
observeOn()
延迟操作 delay()
在事件的生命周期中操作 doOnEach() 当Observable每发送一次数据就会调用一次(含onNext、onError和onCompleted)
doOnNext() 执行next事件前调用 Next事件
doAfterNext() 执行Next事件后调用
doOnError() 发送错误事件时 发送事件完毕后调用
doOnCompleted() 正发送事件完毕后
doOnTerminate() 无论正常发送完毕/异常终止
onfinaly() 最后执行
doOnSubscribe() 观察者订阅时调用 订阅相关
doOnUnsubscribe() 观察者取消订阅时调用
错误处理:遇到错误时的解决机制 onErrorRturn() 发送一个新的特殊事件&正常终止,可捕获在它之前发生的异常 发送数据
onErrorReturnNext() 发送一个新的Observable
onEexceptionResumeNext() 发送一个新的Observable
retry() 重试 重试
retryUntil() 让Observable重新订阅
retryWhen() 将错误传递给另一个Observable来决定是否重新订阅该Observable
重复发送操作 repeat() 无条件重复发送
repeatWhen() 有条件循环重复发送

2 连接被观察者 & 观察者

subscribe()

  • 作用
    订阅,即连接观察者 & 被观察者

分步骤的完整调

//  步骤1: 创建被观察者 Observable 对象
        Observable observable = Observable.create(new ObservableOnSubscribe() {
            @Override
            public void subscribe(ObservableEmitter emitter) throws Exception {
                emitter.onNext(1);
                emitter.onNext(2);
                emitter.onNext(3);
                emitter.onComplete();
            }
        });

// 步骤2:创建观察者 Observer 并 定义响应事件行为
        Observer observer = new Observer() {
            // 通过复写对应方法来 响应 被观察者
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "开始采用subscribe连接");
            }
            // 默认最先调用复写的 onSubscribe()

            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "对Next事件"+ value +"作出响应"  );
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "对Error事件作出响应");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "对Complete事件作出响应");
            }
        };

        
        // 步骤3:通过订阅(subscribe)连接观察者和被观察者
        observable.subscribe(observer);

事件流的链式调用

Observable.create(new ObservableOnSubscribe() {
        // 1. 创建被观察者 & 生产事件
            @Override
            public void subscribe(ObservableEmitter emitter) throws Exception {
                emitter.onNext(1);
                emitter.onNext(2);
                emitter.onNext(3);
                emitter.onComplete();
            }
        }).subscribe(new Observer() {
            // 2. 通过通过订阅(subscribe)连接观察者和被观察者
            // 3. 创建观察者 & 定义响应事件的行为
            @Override
            public void onSubscribe(Disposable d) {
                Log.d(TAG, "开始采用subscribe连接");
            }
            // 默认最先调用复写的 onSubscribe()

            @Override
            public void onNext(Integer value) {
                Log.d(TAG, "对Next事件"+ value +"作出响应"  );
            }

            @Override
            public void onError(Throwable e) {
                Log.d(TAG, "对Error事件作出响应");
            }

            @Override
            public void onComplete() {
                Log.d(TAG, "对Complete事件作出响应");
            }

        });

Observable.subscribe(Subscriber) 的内部实现

public Subscription subscribe(Subscriber subscriber) {
    subscriber.onStart();
    // 在观察者 subscriber抽象类复写的方法 onSubscribe.call(subscriber),用于初始化工作
    // 通过该调用,从而回调观察者中的对应方法从而响应被观察者生产的事件
    // 从而实现被观察者调用了观察者的回调方法 & 由被观察者向观察者的事件传递,即观察者模式
    // 同时也看出:Observable只是生产事件,真正的发送事件是在它被订阅的时候,即当 subscribe() 方法执行时
}

3 线程调度

  • 作用
    快速、方便指定 & 控制被观察者 & 观察者 的工作线程
  • 在 RxJava模型中,被观察者 (Observable) / 观察者(Observer)的工作线程 = 创建自身的线程
  • Observable.subscribeOn(Schedulers.Thread):指定被观察者 发送事件的线程(传入RxJava内置的线程类型)
  • Observable.observeOn(Schedulers.Thread):指定观察者 接收 & 响应事件的线程(传入RxJava内置的线程类型)
  • 特别注意
  • 若Observable.subscribeOn()多次指定被观察者 生产事件的线程,则只有第一次指定有效,其余的指定线程无效
  • 若Observable.observeOn()多次指定观察者 接收 & 响应事件的线程,则每次指定均有效,即每指定一次,就会进行一次线程的切换

3.1 需求场景

  • 在子线程中实现耗时的操作;然后回到主线程实现 UI操作
  • 对应RxJava模型
  • 被观察者 (Observable) 在 子线程 中生产事件(如实现耗时操作等等)
  • 观察者(Observer)在 主线程 接收 & 响应事件(即实现UI操作)
RxJava2.0之旅(五)---功能性操作符_第1张图片
944365-3997d7540acda975.png

3.2 实现方式

采用 RxJava内置的线程调度器( Scheduler ),即通过 功能性操作符subscribeOn() & observeOn()实现

  • 作用
    线程控制,即指定 被观察者 (Observable) / 观察者(Observer) 的工作线程类型
  • 线程类型
    在 RxJava中,内置了多种用于调度的线程类型
类型 含义 应用场景
Schedulers.immediate() 当前线程 = 不指定线程 默认
AndroidSchedulers.mainThread() Android主线程 操作UI
Schedulers.newThread() 常规新线程 耗时等操作
Schedulers.io() io操作线程 网络请求、读写文件等io密集型操作
Schedulers.computation() CPU计算操作线程 大量计算操作

注:RxJava内部使用 线程池 来维护这些线程,所以线程的调度效率非常高。

3.3 具体使用

具体是在 (上述步骤3)通过订阅(subscribe)连接观察者和被观察者中实现

<-- 使用说明 -->
  // Observable.subscribeOn(Schedulers.Thread):指定被观察者 发送事件的线程(传入RxJava内置的线程类型)
  // Observable.observeOn(Schedulers.Thread):指定观察者 接收 & 响应事件的线程(传入RxJava内置的线程类型)

<-- 实例使用 -->
// 步骤3:通过订阅(subscribe)连接观察者和被观察者
        observable.subscribeOn(Schedulers.newThread()) // 1. 指定被观察者 生产事件的线程
                  .observeOn(AndroidSchedulers.mainThread())  // 2. 指定观察者 接收 & 响应事件的线程
                  .subscribe(observer); // 3. 最后再通过订阅(subscribe)连接观察者和被观察者

3.4 步骤实现

步骤1: 添加依赖

dependencies {

// Android 支持 Rxjava
// 此处一定要注意使用RxJava2的版本
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'

// Android 支持 Retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'

// 衔接 Retrofit & RxJava
// 此处一定要注意使用RxJava2的版本
compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

// 支持Gson解析
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

}

b. 添加 网络权限


步骤2:创建 接收服务器返回数据 的类

public class Translation {
    private int status;

    private content content;
    private static class content {
        private String from;
        private String to;
        private String vendor;
        private String out;
        private int errNo;
    }

    //定义 输出返回数据 的方法
    public void show() {
        System.out.println( "Rxjava翻译结果:" + status);
        System.out.println("Rxjava翻译结果:" + content.from);
        System.out.println("Rxjava翻译结果:" + content.to);
        System.out.println("Rxjava翻译结果:" + content.vendor);
        System.out.println("Rxjava翻译结果:" + content.out);
        System.out.println("Rxjava翻译结果:" + content.errNo);
    }
}

步骤3:创建 用于描述网络请求 的接口
采用 注解 + Observable<...>接口描述 网络请求参数

public interface GetRequest_Interface {

    @GET("ajax.php?a=fy&f=auto&t=auto&w=hi%20world")
    Observable getCall();
     // 注解里传入 网络请求 的部分URL地址
    // Retrofit把网络请求的URL分成了两部分:一部分放在Retrofit对象里,另一部分放在网络请求接口里
    // 如果接口里的url是一个完整的网址,那么放在Retrofit对象里的URL可以忽略
    // 采用Observable<...>接口 
    // getCall()是接受网络请求数据的方法
}

步骤4:使用

private void scheduler() {
    //步骤4:创建Retrofit对象
    Retrofit retrofit = new Retrofit.Builder()
            .baseUrl("http://fy.iciba.com/") // 设置 网络请求 Url
            .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
            .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 支持RxJava
            .build();

    // 步骤5:创建 网络请求接口 的实例
    GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

    // 步骤6:采用Observable<...>形式 对 网络请求 进行封装
    Observable observable = request.getCall();

    // 步骤7:发送网络请求
    observable.subscribeOn(Schedulers.io())               // 在IO线程进行网络请求
            .observeOn(AndroidSchedulers.mainThread())  // 回到主线程 处理请求结果
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                    Log.d(TAG, "开始采用subscribe连接");
                }

                @Override
                public void onNext(Translation result) {
                    // 步骤8:对返回的数据进行处理
                    result.show();
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "请求失败");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "请求成功");
                }
            });

}

3.5 应用程序崩溃问题

  • 背景:在发送网络请求时 退出当前Activity
  • 冲突:此时如果回到主线程更新 UI,App会崩溃
  • 解决方案:当 Activity退出时,调用 Disposable.dispose()切断观察者和被观察者的连接,使得观察者无法收到事件 & 响应事件
  • 当出现多个Disposable时,可采用RxJava内置容器CompositeDisposable进行统一管理
// 添加Disposable到CompositeDisposable容器
CompositeDisposable.add()

// 清空CompositeDisposable容器
CompositeDisposable.clear() 

4 延迟操作

  • 需求场景
    即在被观察者发送事件前进行一些延迟的操作

delay()

  • 作用
    使得被观察者延迟一段时间再发送事件
  • 方法介绍
    delay() 具备多个重载方法,具体如下:
// 1. 指定延迟时间
// 参数1 = 时间;参数2 = 时间单位
delay(long delay,TimeUnit unit)

// 2. 指定延迟时间 & 调度器
// 参数1 = 时间;参数2 = 时间单位;参数3 = 线程调度器
delay(long delay,TimeUnit unit,mScheduler scheduler)

// 3. 指定延迟时间  & 错误延迟
// 错误延迟,即:若存在Error事件,则如常执行,执行后再抛出错误异常
// 参数1 = 时间;参数2 = 时间单位;参数3 = 错误延迟参数
delay(long delay,TimeUnit unit,boolean delayError)

// 4. 指定延迟时间 & 调度器 & 错误延迟
// 参数1 = 时间;参数2 = 时间单位;参数3 = 线程调度器;参数4 = 错误延迟参数
delay(long delay,TimeUnit unit,mScheduler scheduler,boolean delayError): //指定延迟多长时间并添加调度器,错误通知可以设置是否延迟
private void delay() {
    Log.d(TAG, "开始执行");
    Observable.just(1, 2, 3)
            .delay(3, TimeUnit.SECONDS)
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                    Log.d(TAG, "开始采用subscribe连接");
                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }
            });

}
RxJava2.0之旅(五)---功能性操作符_第2张图片
TIM截图20180606160423.png

5 在事件的生命周期中操作

RxJava2.0之旅(五)---功能性操作符_第3张图片
944365-3f411ad304df78d5.png
private void doLifecycle() {
    Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(ObservableEmitter e) throws Exception {
            e.onNext(1);
            e.onNext(2);
            e.onNext(3);
            e.onError(new Throwable("发生错误了"));
        }
    })
            // 1. 当Observable每发送1次数据事件就会调用1次
            .doOnEach(new Consumer>() {
                @Override
                public void accept(Notification integerNotification) throws Exception {
                    Log.d(TAG, "doOnEach: " + integerNotification.getValue());
                }
            })
            // 2. 执行Next事件前调用
            .doOnNext(new Consumer() {
                @Override
                public void accept(Integer integer) throws Exception {
                    Log.d(TAG, "doOnNext: " + integer);
                }
            })
            // 3. 执行Next事件后调用
            .doAfterNext(new Consumer() {
                @Override
                public void accept(Integer integer) throws Exception {
                    Log.d(TAG, "doAfterNext: " + integer);
                }
            })
            // 4. Observable正常发送事件完毕后调用
            .doOnComplete(new Action() {
                @Override
                public void run() throws Exception {
                    Log.d(TAG, "doOnComplete: ");
                }
            })
            // 5. Observable发送错误事件时调用
            .doOnError(new Consumer() {
                @Override
                public void accept(Throwable throwable) throws Exception {
                    Log.d(TAG, "doOnError: " + throwable.getMessage());
                }
            })
            // 6. 观察者订阅时调用
            .doOnSubscribe(new Consumer() {
                @Override
                public void accept(@NonNull Disposable disposable) throws Exception {
                    Log.d(TAG, "doOnSubscribe: ");
                }
            })
            // 7. Observable发送事件完毕后调用,无论正常发送完毕 / 异常终止
            .doAfterTerminate(new Action() {
                @Override
                public void run() throws Exception {
                    Log.d(TAG, "doAfterTerminate: ");
                }
            })
            // 8. 最后执行
            .doFinally(new Action() {
                @Override
                public void run() throws Exception {
                    Log.d(TAG, "doFinally: ");
                }
            })
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                    Log.d(TAG, "开始采用subscribe连接");
                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }
            });

}
RxJava2.0之旅(五)---功能性操作符_第4张图片
TIM截图20180606161356.png

6 错误处理

RxJava2.0之旅(五)---功能性操作符_第5张图片
944365-abbc7ffe57770e84.png

6.1 onErrorReturn()

  • 作用
    遇到错误时,发送1个特殊事件 & 正常终止
  • 可捕获在它之前发生的异常
private void onErrorReturn() {
    Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(ObservableEmitter e) throws Exception {
            e.onNext(1);
            e.onNext(2);
            e.onError(new Throwable("发生错误了"));
        }
    })
            .onErrorReturn(new Function() {
                @Override
                public Integer apply(@NonNull Throwable throwable) throws Exception {
                    // 捕捉错误异常
                    Log.e(TAG, "在onErrorReturn处理了错误: "+throwable.toString() );

                    return 666;
                    // 发生错误事件后,发送一个"666"事件,最终正常结束
                }
            })
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {

                }
                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件"+ value  );
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }
            });
}
TIM截图20180606163029.png

6.2 onErrorResumeNext()/onExceptionResumeNext()

  • 作用
    遇到错误时,发送1个新的Observable
  • 注:
    onErrorResumeNext()拦截的错误 = Throwable;若需拦截Exception请用onExceptionResumeNext()
    若onErrorResumeNext()拦截的错误 = Exception,则会将错误传递给观察者的onError方法
private void onErrorResumeNext() {
    Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(ObservableEmitter e) throws Exception {
            e.onNext(1);
            e.onNext(2);
            e.onError(new Throwable("发生错误了"));
            e.onNext(3);
        }
    })
            .onErrorResumeNext(new Function>() {
                @Override
                public ObservableSource apply(@NonNull Throwable throwable) throws Exception {

                    // 1. 捕捉错误异常
                    Log.e(TAG, "在onErrorReturn处理了错误: " + throwable.toString());

                    // 2. 发生错误事件后,发送一个新的被观察者 & 发送事件序列
                    return Observable.just(11, 22);

                }
            })
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {

                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }
            });

}
RxJava2.0之旅(五)---功能性操作符_第6张图片
TIM截图20180606163626.png

6.3 retry()

  • 作用
    重试,即当出现错误时,让被观察者(Observable)重新发射数据
  • 接收到 onError()时,重新订阅 & 发送事件
  • Throwable 和 Exception都可拦截

5种重载方法

<-- 1. retry() -->
// 作用:出现错误时,让被观察者重新发送数据
// 注:若一直错误,则一直重新发送

<-- 2. retry(long time) -->
// 作用:出现错误时,让被观察者重新发送数据(具备重试次数限制
// 参数 = 重试次数
 
<-- 3. retry(Predicate predicate) -->
// 作用:出现错误后,判断是否需要重新发送数据(若需要重新发送& 持续遇到错误,则持续重试)
// 参数 = 判断逻辑

<--  4. retry(new BiPredicate) -->
// 作用:出现错误后,判断是否需要重新发送数据(若需要重新发送 & 持续遇到错误,则持续重试
// 参数 =  判断逻辑(传入当前重试次数 & 异常错误信息)

<-- 5. retry(long time,Predicate predicate) -->
// 作用:出现错误后,判断是否需要重新发送数据(具备重试次数限制
// 参数 = 设置重试次数 & 判断逻辑
private void retry() {
    Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(ObservableEmitter e) throws Exception {
            e.onNext(1);
            e.onNext(2);
            e.onError(new Exception("发生错误了"));
            e.onNext(3);
        }
    })
            .retry() // 遇到错误时,让被观察者重新发射数据(若一直错误,则一直重新发送
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {

                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }
            });
}
RxJava2.0之旅(五)---功能性操作符_第7张图片
TIM截图20180606164851.png
retry(3) // 设置重试次数 = 3次
// 拦截错误后,判断是否需要重新发送请求
retry(new Predicate() {
    @Override
    public boolean test(@NonNull Throwable throwable) throws Exception {
        // 捕获异常
        Log.e(TAG, "retry错误: "+throwable.toString());

        //返回false = 不重新重新发送数据 & 调用观察者的onError结束
        //返回true = 重新发送请求(若持续遇到错误,就持续重新发送)
        return true;
    }
})
// 拦截错误后,判断是否需要重新发送请求
retry(new BiPredicate() {
    @Override
    public boolean test(@NonNull Integer integer, @NonNull Throwable throwable) throws Exception {
        // 捕获异常
        Log.e(TAG, "异常错误 =  "+throwable.toString());

        // 获取当前重试次数
        Log.e(TAG, "当前重试次数 =  "+integer);

        //返回false = 不重新重新发送数据 & 调用观察者的onError结束
        //返回true = 重新发送请求(若持续遇到错误,就持续重新发送)
        return true;
    }
})
// 拦截错误后,判断是否需要重新发送请求
retry(3, new Predicate() {
    @Override
    public boolean test(@NonNull Throwable throwable) throws Exception {
        // 捕获异常
        Log.e(TAG, "retry错误: "+throwable.toString());

        //返回false = 不重新重新发送数据 & 调用观察者的onError()结束
        //返回true = 重新发送请求(最多重新发送3次)
        return true;
    }
})

6.4 retryUntil()

  • 作用
    出现错误后,判断是否需要重新发送数据
  • 具体使用类似于retry(Predicate predicate),唯一区别:返回 true 则不重新发送数据事件。

6.5 retryWhen()

  • 作用
    遇到错误时,将发生的错误传递给一个新的被观察者(Observable),并决定是否需要重新订阅原始被观察者(Observable)& 发送事件
private void retryWhen() {
    Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(ObservableEmitter e) throws Exception {
            e.onNext(1);
            e.onNext(2);
            e.onError(new Exception("发生错误了"));
            e.onNext(3);
        }
    })
            // 遇到error事件才会回调
            .retryWhen(new Function, ObservableSource>() {
                @Override
                public ObservableSource apply(Observable throwableObservable) throws Exception {
                    // 参数Observable中的泛型 = 上游操作符抛出的异常,可通过该条件来判断异常的类型
                    // 返回Observable = 新的被观察者 Observable(任意类型)
                    // 此处有两种情况:
                    // 1. 若 新的被观察者 Observable发送的事件 = Error事件,那么 原始Observable则不重新发送事件:
                    // 2. 若 新的被观察者 Observable发送的事件 = Next事件 ,那么原始的Observable则重新发送事件:
                    return throwableObservable.flatMap(new Function>() {
                        @Override
                        public ObservableSource apply(@NonNull Throwable throwable) throws Exception {

                            // 1. 若返回的Observable发送的事件 = Error事件,则原始的Observable不重新发送事件
                            // 该异常错误信息可在观察者中的onError()中获得
//                                return Observable.error(new Throwable("retryWhen终止啦"));

                            // 2. 若返回的Observable发送的事件 = Next事件,则原始的Observable重新发送事件(若持续遇到错误,则持续重试)
                             return Observable.just(1);
                        }
                    });
                }
            }).subscribe(new Observer() {
        @Override
        public void onSubscribe(Disposable d) {

        }

        @Override
        public void onNext(Integer value) {
            Log.d(TAG, "接收到了事件" + value);
        }

        @Override
        public void onError(Throwable e) {
            Log.d(TAG, "对Error事件作出响应" + e.toString());
            // 获取异常错误信息
        }

        @Override
        public void onComplete() {
            Log.d(TAG, "对Complete事件作出响应");
        }
    });

}
RxJava2.0之旅(五)---功能性操作符_第8张图片
TIM截图20180606172902.png

7 重复发送

7.1 repeat

  • 作用
    无条件地、重复发送 被观察者事件
  • 注:
    1. 接收到.onCompleted()事件后,触发重新订阅 & 发送
// 不传入参数 = 重复发送次数 = 无限次
repeat();
// 传入参数 = 重复发送次数有限
repeatWhen(Integer int );
private void repeat() {
    // 具体使用
    Observable.just(1, 2)
            .repeat(3) // 重复创建次数 =- 3次
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                    Log.d(TAG, "开始采用subscribe连接");
                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应");
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }

            });
}
RxJava2.0之旅(五)---功能性操作符_第9张图片
TIM截图20180606173921.png

7.2 repeatWhen()

  • 作用
    有条件地、重复发送 被观察者事件
  • 原理
    将原始 Observable 停止发送事件的标识(Complete() / Error())转换成1个 Object 类型数据传递给1个新被观察者(Observable),以此决定是否重新订阅 & 发送原来的 Observable
private void repeatWhen() {

    Observable.just(1, 2, 4).repeatWhen(new Function, ObservableSource>() {
        @Override
        // 在Function函数中,必须对输入的 Observable进行处理,这里我们使用的是flatMap操作符接收上游的数据
        public ObservableSource apply(@NonNull Observable objectObservable) throws Exception {
            // 将原始 Observable 停止发送事件的标识(Complete() /  Error())转换成1个 Object 类型数据传递给1个新被观察者(Observable)
            // 以此决定是否重新订阅 & 发送原来的 Observable
            // 此处有2种情况:
            // 1. 若新被观察者(Observable)返回1个Complete() /  Error()事件,则不重新订阅 & 发送原来的 Observable
            // 2. 若新被观察者(Observable)返回其余事件,则重新订阅 & 发送原来的 Observable
            return objectObservable.flatMap(new Function>() {
                @Override
                public ObservableSource apply(@NonNull Object throwable) throws Exception {

                    // 情况1:若新被观察者(Observable)返回1个Complete() /  Error()事件,则不重新订阅 & 发送原来的 Observable
                    return Observable.empty();
                    // Observable.empty() = 发送Complete事件,但不会回调观察者的onComplete()

                    // return Observable.error(new Throwable("不再重新订阅事件"));
                    // 返回Error事件 = 回调onError()事件,并接收传过去的错误信息。

                    // 情况2:若新被观察者(Observable)返回其余事件,则重新订阅 & 发送原来的 Observable
//                         return Observable.just(1);
                    // 仅仅是作为1个触发重新订阅被观察者的通知,发送的是什么数据并不重要,只要不是Complete() /  Error()事件
                }
            });

        }
    })
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                    Log.d(TAG, "开始采用subscribe连接");
                }

                @Override
                public void onNext(Integer value) {
                    Log.d(TAG, "接收到了事件" + value);
                }

                @Override
                public void onError(Throwable e) {
                    Log.d(TAG, "对Error事件作出响应:" + e.toString());
                }

                @Override
                public void onComplete() {
                    Log.d(TAG, "对Complete事件作出响应");
                }

            });
}
 
 

8 轮询的实现

8.1 步骤1: 添加依赖

dependencies {

// Android 支持 Rxjava
// 此处一定要注意使用RxJava2的版本
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'

// Android 支持 Retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'

// 衔接 Retrofit & RxJava
// 此处一定要注意使用RxJava2的版本
compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

// 支持Gson解析
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

}

添加 网络权限


8.2 步骤2:创建 接收服务器返回数据 的类

public class Translation {

    private int status;

    private content content;
    private static class content {
        private String from;
        private String to;
        private String vendor;
        private String out;
        private int errNo;
    }

    //定义 输出返回数据 的方法
    public void show() {
        Log.d("RxJava", content.out );
    }
}

8.3 步骤3:创建 用于描述网络请求 的接口

public interface GetRequest_Interface {

    @GET("ajax.php?a=fy&f=auto&t=auto&w=hi%20world")
    Observable getCall();
     // 注解里传入 网络请求 的部分URL地址
    // Retrofit把网络请求的URL分成了两部分:一部分放在Retrofit对象里,另一部分放在网络请求接口里
    // 如果接口里的url是一个完整的网址,那么放在Retrofit对象里的URL可以忽略
    // 采用Observable<...>接口 
    // getCall()是接受网络请求数据的方法
}
// 设置变量 = 模拟轮询服务器次数
private int i = 0;
private void poll() {
    // 步骤1:创建Retrofit对象
    Retrofit retrofit = new Retrofit.Builder()
            .baseUrl("http://fy.iciba.com/") // 设置 网络请求 Url
            .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
            .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 支持RxJava
            .build();

    // 步骤2:创建 网络请求接口 的实例
    GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

    // 步骤3:采用Observable<...>形式 对 网络请求 进行封装
    Observable observable = request.getCall();

    // 步骤4:发送网络请求 & 通过repeatWhen()进行轮询
    observable.repeatWhen(new Function, ObservableSource>() {
        @Override
        // 在Function函数中,必须对输入的 Observable进行处理,此处使用flatMap操作符接收上游的数据
        public ObservableSource apply(@NonNull Observable objectObservable) throws Exception {
            // 将原始 Observable 停止发送事件的标识(Complete() /  Error())转换成1个 Object 类型数据传递给1个新被观察者(Observable)
            // 以此决定是否重新订阅 & 发送原来的 Observable,即轮询
            // 此处有2种情况:
            // 1. 若返回1个Complete() /  Error()事件,则不重新订阅 & 发送原来的 Observable,即轮询结束
            // 2. 若返回其余事件,则重新订阅 & 发送原来的 Observable,即继续轮询
            return objectObservable.flatMap(new Function>() {
                @Override
                public ObservableSource apply(@NonNull Object throwable) throws Exception {

                    // 加入判断条件:当轮询次数 = 5次后,就停止轮询
                    if (i > 3) {
                        // 此处选择发送onError事件以结束轮询,因为可触发下游观察者的onError()方法回调
                        return Observable.error(new Throwable("轮询结束"));
                    }
                    // 若轮询次数<4次,则发送1Next事件以继续轮询
                    // 注:此处加入了delay操作符,作用 = 延迟一段时间发送(此处设置 = 2s),以实现轮询间间隔设置
                    return Observable.just(1).delay(2000, TimeUnit.MILLISECONDS);
                }
            });

        }
    }).subscribeOn(Schedulers.io())               // 切换到IO线程进行网络请求
            .observeOn(AndroidSchedulers.mainThread())  // 切换回到主线程 处理请求结果
            .subscribe(new Observer() {
                @Override
                public void onSubscribe(Disposable d) {
                }

                @Override
                public void onNext(Translation result) {
                    // e.接收服务器返回的数据
                    result.show();
                    i++;
                }

                @Override
                public void onError(Throwable e) {
                    // 获取轮询结束信息
                    Log.d(TAG, e.toString());
                }

                @Override
                public void onComplete() {

                }
            });
}
 
 

9 网络请求出错重连(结合Retrofit)

9.1 步骤1: 添加依赖

dependencies {

// Android 支持 Rxjava
// 此处一定要注意使用RxJava2的版本
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'

// Android 支持 Retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'

// 衔接 Retrofit & RxJava
// 此处一定要注意使用RxJava2的版本
compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

// 支持Gson解析
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

}

9.2 步骤2:创建 接收服务器返回数据 的类

public class Translation {

    private int status;

    private content content;
    private static class content {
        private String from;
        private String to;
        private String vendor;
        private String out;
        private int errNo;
    }

    //定义 输出返回数据 的方法
    public void show() {
        Log.d("RxJava", content.out );
    }
}

9.3 步骤3:创建 用于描述网络请求 的接口

public interface GetRequest_Interface {

    @GET("ajax.php?a=fy&f=auto&t=auto&w=hi%20world")
    Observable getCall();
     // 注解里传入 网络请求 的部分URL地址
    // Retrofit把网络请求的URL分成了两部分:一部分放在Retrofit对象里,另一部分放在网络请求接口里
    // 如果接口里的url是一个完整的网址,那么放在Retrofit对象里的URL可以忽略
    // 采用Observable<...>接口 
    // getCall()是接受网络请求数据的方法
}
// 设置变量
    // 可重试次数
    private int maxConnectCount = 10;
    // 当前已重试次数
    private int currentRetryCount = 0;
    // 重试等待时间
    private int waitRetryTime = 0;

// 步骤1:创建Retrofit对象
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://fy.iciba.com/") // 设置 网络请求 Url
                .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 支持RxJava
                .build();

        // 步骤2:创建 网络请求接口 的实例
        GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

        // 步骤3:采用Observable<...>形式 对 网络请求 进行封装
        Observable observable = request.getCall();

        // 步骤4:发送网络请求 & 通过retryWhen()进行重试
        // 注:主要异常才会回调retryWhen()进行重试
        observable.retryWhen(new Function, ObservableSource>() {
            @Override
            public ObservableSource apply(@NonNull Observable throwableObservable) throws Exception {
                // 参数Observable中的泛型 = 上游操作符抛出的异常,可通过该条件来判断异常的类型
                return throwableObservable.flatMap(new Function>() {
                    @Override
                    public ObservableSource apply(@NonNull Throwable throwable) throws Exception {

                        // 输出异常信息
                        Log.d(TAG,  "发生异常 = "+ throwable.toString());

                        /**
                         * 需求1:根据异常类型选择是否重试
                         * 即,当发生的异常 = 网络异常 = IO异常 才选择重试
                         */
                        if (throwable instanceof IOException){

                            Log.d(TAG,  "属于IO异常,需重试" );

                            /**
                             * 需求2:限制重试次数
                             * 即,当已重试次数 < 设置的重试次数,才选择重试
                             */
                            if (currentRetryCount < maxConnectCount){

                                // 记录重试次数
                                currentRetryCount++;
                                Log.d(TAG,  "重试次数 = " + currentRetryCount);

                                /**
                                 * 需求2:实现重试
                                 * 通过返回的Observable发送的事件 = Next事件,从而使得retryWhen()重订阅,最终实现重试功能
                                 *
                                 * 需求3:延迟1段时间再重试
                                 * 采用delay操作符 = 延迟一段时间发送,以实现重试间隔设置
                                 *
                                 * 需求4:遇到的异常越多,时间越长
                                 * 在delay操作符的等待时间内设置 = 每重试1次,增多延迟重试时间1s
                                 */
                                // 设置等待时间
                                waitRetryTime = 1000 + currentRetryCount* 1000;
                                Log.d(TAG,  "等待时间 =" + waitRetryTime);
                                return Observable.just(1).delay(waitRetryTime, TimeUnit.MILLISECONDS);


                            }else{
                                // 若重试次数已 > 设置重试次数,则不重试
                                // 通过发送error来停止重试(可在观察者的onError()中获取信息)
                                return Observable.error(new Throwable("重试次数已超过设置次数 = " +currentRetryCount  + ",即 不再重试"));

                            }
                        }

                        // 若发生的异常不属于I/O异常,则不重试
                        // 通过返回的Observable发送的事件 = Error事件 实现(可在观察者的onError()中获取信息)
                        else{
                            return Observable.error(new Throwable("发生了非网络异常(非I/O异常)"));
                        }
                    }
                });
            }
        }).subscribeOn(Schedulers.io())               // 切换到IO线程进行网络请求
                .observeOn(AndroidSchedulers.mainThread())  // 切换回到主线程 处理请求结果
                .subscribe(new Observer() {
                    @Override
                    public void onSubscribe(Disposable d) {
                    }

                    @Override
                    public void onNext(Translation result) {
                        // 接收服务器返回的数据
                        Log.d(TAG,  "发送成功");
                        result.show();
                    }

                    @Override
                    public void onError(Throwable e) {
                        // 获取停止重试的信息
                        Log.d(TAG,  e.toString());
                    }

                    @Override
                    public void onComplete() {

                    }
                });

    }

参考

https://www.jianshu.com/p/b0c3669affdb

你可能感兴趣的:(RxJava2.0之旅(五)---功能性操作符)