RxJava 操作符
阅读本文前请先了解 RxJava 的基本使用。
参考文档:
1 Observable 的创建
1.1 from( )
转换集合为一个每次发射集合中一个元素的 Observable 对象。可用来遍历集合。
方法列表:
public static <T> Observable<T> from(Future<? extends T> future)
public static <T> Observable<T> from(Future<? extends T> future, long timeout, TimeUnit unit)
public static <T> Observable<T> from(Future<? extends T> future, Scheduler scheduler)
public static <T> Observable<T> from(Iterable<? extends T> iterable)
栗子:
// 1. 遍历集合Observable<String> observable = Observable.from(new String[]{"hello", "hi"});
// 2. 使用 Future 创建 Observable,Future 表示一个异步计算的结果。FutureTask<String> futureTask = new FutureTask<String>(new Callable<String>() { @Override public String call() throws Exception { // TODO 执行异步操作并返回数据 return "hihi"; } }); Scheduler.Worker worker = Schedulers.io().createWorker(); worker.schedule(new Action0() { @Override public void call() { futureTask.run(); } }); Observable<String> observable = Observable.from(futureTask);
1.2 just( )
转换一个或多个 Object 为依次发射这些 Object 的 Observable 对象。
方法列表:
public static <T> Observable<T> just(T t1, T t2, T t3, T t4)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5, T t6)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5, T t6, T t7)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5, T t6, T t7, T t8)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5, T t6, T t7, T t8, T t9)
public static <T> Observable<T> just(T t1, T t2, T t3, T t4, T t5, T t6, T t7, T t8, T t9, T t10)
栗子:
Observable<String> observable = Observable.just("hello");// 使用 just() 遍历几个元素Observable<String> observable = Observable.just("hello", "hi", "...");// 使用 from() 方法遍历,效果和 just() 一样。String[] stringArrs = new String[]{"hello", "hi", "..."}; Observable<String> observable = Observable.from(stringArrs);
just()
方法可传入 1~10 个参数,也就说当元素个数小于等于 10 的时候既可以使用 just()
也可以使用 from()
,否则只能用 from()
方法。
1.3 create( )
返回一个在被 OnSubscribe 订阅时执行特定方法的 Observable 对象。
方法列表:
@Beta public static <S, T> Observable<T>create(SyncOnSubscribe<S, T> syncOnSubscribe)
@Experimental public static <S, T> Observable<T> create(AsyncOnSubscribe<S, T> asyncOnSubscribe)
栗子:
Observable.OnSubscribe<String> onSubscribe = new Observable.OnSubscribe< String >() { @Override public void call(Subscriber<? super String > subscriber) { // onNext() 方法可执行多次 subscribe.onNext("hello"); subscribe.onCompleted(); } }; Observable<Object> observable = Observable.create(onSubscribe);
此方法不常用,大多数时候都是使用 just( )
、form( )
等方法,如上面那串代码就可以写成:
Observable<Object> observable = Observable.just("hello");
1.4 interval( )
返回一个每隔指定的时间间隔就发射一个序列号的 Observable 对象,可用来做倒计时等操作。
方法列表:
public static Observable<Long> interval(long interval, TimeUnit unit)
public static Observable<Long> interval(long interval, TimeUnit unit, Scheduler scheduler)
public static Observable<Long> interval(long initialDelay, long period, TimeUnit unit)
栗子:
// 每隔 1 s 发送一个序列号,序列号从 0 开始,每次累加 1。 Observable<Long> observable = Observable.interval(1, TimeUnit.SECONDS);
1.5 timer( )
创建一个在指定延迟时间后发射一条数据( 固定值:0 )的 Observable 对象,可用来做定时操作。
方法列表:
public static Observable<Long> timer(long delay, TimeUnit unit)
public static Observable<Long> timer(long delay, TimeUnit unit, Scheduler scheduler)
栗子:
// 定时 3 s Observable<Long> observable = Observable.timer(3, TimeUnit.SECONDS);
1.6 range( )
创建一个发射指定范围内的连续整数的 Observable 对象。
方法列表:
public static Observable<Integer> range(int start, int count)
public static Observable<Integer> range(int start, int count, Scheduler scheduler)
栗子:
// 依次发射 5、6、7Observable<Integer> observable = Observable.range(5, 3);
1.7 empty()
创建一个不发射任何数据就发出 onCompleted()
通知的 Observable 对象。
方法列表:
栗子:
// 发出一个 onCompleted() 通知Observable<Object> observable = Observable.empty();
1.8 error( )
创建不发射任何数据就发出 onError
通知的 Observable 对象。
方法列表:
栗子:
// 发出一个 onError() 通知Observable<Object> observable = Observable.error(new Throwable("message"));
1.9 never()
创建一个不发射任何数据和通知的 Observable 对象。
方法列表:
栗子:
Observable<Object> observable = Observable.never();
1.10 defer( )
在订阅的时候才会创建 Observable 对象;每一次订阅都创建一个新的 Observable 对象。
方法列表:
栗子:
Observable<String> observable = Observable.defer(new Func0<Observable<String>>() { @Override public Observable<String> call() { return Observable.just("string"); } });
2 重做
2.1 repeat( )
使Observable 对象在发出 onNext()
通知之后重复发射数据。重做结束才会发出 onComplete()
通知,若重做过程中出现异常则会中断并发出 onError()
通知。
方法列表:
栗子:
Observable<String> observable = Observable.just("string");// 无限重复执行observable.repeat();// 重复执行 5 次observable.repeat(5);
2.2 repeatWhen( )
使Observable 对象在发出 onNext()
通知之后有条件的重复发射数据。重做结束才会发出 onCompleted()
通知,若重做过程中出现异常则会中断并发出 onError()
通知。
方法列表:
栗子:
observable.repeatWhen(new Func1<Observable<? extends Void>, Observable<?>>() { @Override public Observable<?> call(Observable<? extends Void> observable) { // 重复 3 次, 每次间隔 1 s return observable.zipWith(Observable.range(1, 3), new Func2<Void, Integer, Integer>() { @Override public Integer call(Void aVoid, Integer integer) { return integer; } }).flatMap(integer -> Observable.timer(1, TimeUnit.SECONDS)); } });
3 重试
3.1 retry( )
在执行 Observable对象的序列出现异常时,不直接发出 onError()
通知,而是重新订阅该 Observable对象,直到重做过程中未出现异常,则会发出 onNext()
和 onCompleted()
通知;若重做过程中也出现异常,则会继续重试,直到达到重试次数上限,超出次数后发出最新的 onError()
通知。
方法列表:
栗子:
Observable<Integer> observable = Observable.create(new Observable.OnSubscribe<Integer>() { @Override public void call(Subscriber<? super Integer> subscriber) { System.out.println("......."); int a = 1 / 0; subscriber.onNext(a); subscriber.onCompleted(); } });// 无限次的重试observable.retry();// 重试 3 次observable.retry(3);// 使用谓语函数决定是否重试observable.retry(new Func2<Integer, Throwable, Boolean>() { @Override public Boolean call(Integer integer, Throwable throwable) { // 参数 integer 是订阅的次数; 参数 throwable 是抛出的异常 // 返回值为 true 表示重试, 返回值为 false 表示不重试 return false; } });
3.2 retryWhen( )
作用: 有条件的执行重试。
方法列表:
栗子:
// 重试 3 次,每次间隔 1 sobservable.retryWhen(new Func1<Observable<? extends Throwable>, Observable<?>>() { @Override public Observable<?> call(Observable<? extends Throwable> observable) { return observable.zipWith(Observable.range(1, 3), new Func2<Throwable, Integer, Object>() { @Override public Object call(Throwable throwable, Integer integer) { return integer; } }).flatMap(new Func1<Object, Observable<?>>() { @Override public Observable<?> call(Object o) { return Observable.timer(1, TimeUnit.SECONDS); } }); } });
4 变换
4.1 map( )
把源 Observable 发射的元素应用于指定的函数,并发送该函数的结果。
方法列表:
栗子:
Observable.just(2) .map(new Func1<Integer, String>() { @Override public String call(Integer integer) { return String.valueOf(String.format("原始数据的两倍为: %s", integer * 2)); } });
4.2 flatMap( )
转换源 Observable 对象为另一个 Observable 对象。
方法列表:
栗子:
Observable.just(2) .flatMap(new Func1<Integer, Observable<Long>>() { @Override public Observable<Long> call(Integer integer) { // 转换为一个定时 integer 秒的 Observable 对象 return Observable.timer(integer, TimeUnit.SECONDS); } });
5 过滤
5.1 filter( )
只发射满足指定谓词的元素。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2) .filter(new Func1<Integer, Boolean>() { @Override public Boolean call(Integer integer) { return integer > 0; } });
5.2 first( )
返回一个仅仅发射源 Observable 发射的第一个[满足指定谓词的]元素的 Observable,如果如果源 Observable 为空,则会抛出一个 NoSuchElementException
。
方法列表:
栗子:
// 发射第一个元素Observable.just(-1, -2, 0, 1, 2).first();// 发射满足条件的第一个元素Observable.just(-1, -2, 0, 1, 2) .first(new Func1<Integer, Boolean>() { @Override public Boolean call(Integer integer) { return integer > 0; } });// 会抛出 NoSuchElementException 异常Observable.empty().first();
5.3 last( )
返回一个仅仅发射源 Observable 发射的倒数第一个[满足指定谓词的]元素的 Observable,如果如果源 Observable 为空,则会抛出一个 NoSuchElementException
。
方法列表:
栗子:
// 发射倒数第一个元素Observable.just(-1, -2, 0, 1, 2).first();// 发射满足条件的倒数第一个元素Observable.just(-1, -2, 0, 1, 2) .first(new Func1<Integer, Boolean>() { @Override public Boolean call(Integer integer) { return integer < 0; } });// 会抛出 NoSuchElementException 异常Observable.empty().last();
5.4 skip( )
跳过前面指定数量或指定时间内的元素,只发射后面的元素。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2) .skip(2) // 跳过前两条数据
5.5 skipLast( )
跳过前面指定数量或指定时间内的元素,只发射后面的元素。指定时间时会延迟源 Observable 发射的任何数据。
方法列表:
public final Observable<T> skipLast(long time, TimeUnit unit)
public final Observable<T> skipLast(long time, TimeUnit unit, Scheduler scheduler)
栗子:
Observable.just(-1, -2, 0, 1, 2) .skip(2) // 跳过后两条数据
5.6 take( )
只发射前面指定数量或指定时间内的元素。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2).take(3); // 只发射前三条数据
5.7 takeLast( )
只发射后面指定数量或指定时间内的元素。指定时间时会延迟源 Observable 发射的任何数据。
方法列表:
public final Observable<T> takeLast(int count, long time, TimeUnit unit)
public final Observable<T> takeLast(int count, long time, TimeUnit unit, Scheduler scheduler)
public final Observable<T> takeLast(long time, TimeUnit unit)
public final Observable<T> takeLast(long time, TimeUnit unit, Scheduler scheduler)
栗子:
Observable.just(-1, -2, 0, 1, 2).takeLast(3); // 只发射后三条数据1
5.8 sample( )
定期发射 Observable 发射的最后一条数据。
方法列表:
public final Observable<T> sample(long period, TimeUnit unit)
public final Observable<T> sample(long period, TimeUnit unit, Scheduler scheduler)
public final <U> Observable<T> sample(Observable<U> sampler)
栗子:
Observable.interval(300, TimeUnit.MILLISECONDS) .sample(2, TimeUnit.SECONDS)
5.9 elementAt( )
只发射指定索引的元素。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2).elementAt(2); // 发射索引为 2 的数据
5.10 elementAtOrDefault( )
只发射指定索引的元素,若该索引对应的元素不存在,则发射默认值。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2).elementAtOrDefault(9, -5); // 发射索引为 9的数据,若不存在,则发射 -5
5.11 ignoreElements( )
不发射任何数据,直接发出 onCompleted()
通知。
方法列表:
栗子:
Observable.just(-1, -2, 0, 1, 2).ignoreElements()
5.12 distinct( )
过滤重复的元素,过滤规则是:只允许还没有发射过的元素通过。
方法列表:
栗子:
// 直接过滤Observable.just(-1, -2, 0, 1, 2, 1).distinct();// 通过生成的 key 值过滤Observable.just(-1, -2, 0, 1, 2, 1).distinct(new Func1<Integer, Integer>() { @Override public Integer call(Integer integer) { // 随机生成 key return integer * (int)(Math.random() * 10); } });
5.13 debounce( )
源 Observable 每产生结果后,如果在规定的间隔时间内没有产生新的结果,则发射这个结果,否则会忽略这个结果。该操作符会过滤掉发射速率过快的数据项。
方法列表:
public final Observable<T> debounce(long timeout, TimeUnit unit)
public final Observable<T> debounce(long timeout, TimeUnit unit, Scheduler scheduler)
public final <U> Observable<T> debounce(Func1<? super T, ? extends Observable<U>> debounceSelector)
栗子:
Observable<Integer> observable = Observable.create(new Observable.OnSubscribe<Integer>() { @Override public void call(Subscriber<? super Integer> subscriber) { try { //产生结果的间隔时间分别为100、200、300...900毫秒 for (int i = 1; i < 10; i++) { subscriber.onNext(i); Thread.sleep(i * 100); } subscriber.onCompleted(); } catch (Exception e) { subscriber.onError(e); } } }); observable.debounce(400, TimeUnit.MILLISECONDS) // 超时时间为400毫秒
该栗子产生结果为:依次打印5、6、7、8。
附:功能实现
延时遍历
// 遍历Observable<Integer> traverseObservable = Observable.just(3, 4, 5, 6);// 计时Observable<Long> intervalObservable = Observable.interval(1, TimeUnit.SECONDS); Func2<Long, Integer, Integer> func2 = new Func2<Long, Integer, Integer>() { @Override public Integer call(Long aLong, Integer integer) { return integer; } }; intervalObservable.zipWith(traverseObservable, func2) .toBlocking() .subscribe(new Subscriber<Integer>() { @Override public void onCompleted() { System.out.println("onCompleted"); } @Override public void onError(Throwable e) { e.printStackTrace(); } @Override public void onNext(Integer integer) { System.out.println(integer); } });
倒计时
int startTime = 10; Observable.interval(0, 1, TimeUnit.SECONDS) .take(startTime + 1) // 接收 startTime + 1 次 .map(new Func1<Long, Long>() { @Override public Long call(Long time) { // 1 2 3...转换为...3 2 1 return startTime - time; } }) .toBlocking() .subscribe(new Subscriber<Long>() { @Override public void onCompleted() { System.out.println("倒计时结束"); } @Override public void onError(Throwable e) { System.out.println("倒计时出现异常"); e.printStackTrace(); } @Override public void onNext(Long aLong) { System.out.println(String.format("倒计时: %s s", aLong)); } });
共同学习,写下你的评论
评论加载中...
作者其他优质文章