一、转换操作符
1.1、map()
map()
用于将被观察者发送的数据类型转变成其他的类型
Observable.just(1, 2, 3)
.map(new Function<Integer, String>() {
@Override
public String apply(Integer integer) {
return "I'm " + integer;
}
})
.subscribe(new Consumer<String>() {
@Override
public void accept(String s) {
Log.e(TAG, s);
}
});
10-06 10:53:16.364 18099-18099/leavesc.hello.rxjavademo E/MainActivity: I'm 1
10-06 10:53:16.364 18099-18099/leavesc.hello.rxjavademo E/MainActivity: I'm 2
10-06 10:53:16.364 18099-18099/leavesc.hello.rxjavademo E/MainActivity: I'm 3
1.2、flatMap()
用于将事件序列中的元素进行整合加工,返回一个新的被观察者
List<List<String>> listArrayList = new ArrayList<>();
List<String> stringList = new ArrayList<>();
for (int j = 0; j < 2; j++) {
stringList.add("A_" + j);
}
listArrayList.add(stringList);
stringList = new ArrayList<>();
for (int j = 0; j < 2; j++) {
stringList.add("B_" + j);
}
listArrayList.add(stringList);
Observable.fromIterable(listArrayList).flatMap(new Function<List<String>, ObservableSource<String>>() {
@Override
public ObservableSource<String> apply(List<String> stringList1) throws Exception {
return Observable.fromIterable(stringList1);
}
}).subscribe(new Consumer<String>() {
@Override
public void accept(String s) throws Exception {
Log.e(TAG, "value is: " + s);
}
});
10-06 11:02:47.246 18230-18230/leavesc.hello.rxjavademo E/MainActivity: value is: A_0
10-06 11:02:47.246 18230-18230/leavesc.hello.rxjavademo E/MainActivity: value is: A_1
10-06 11:02:47.246 18230-18230/leavesc.hello.rxjavademo E/MainActivity: value is: B_0
10-06 11:02:47.246 18230-18230/leavesc.hello.rxjavademo E/MainActivity: value is: B_1
1.3、concatMap()
concatMap()
和 flatMap()
基本一样,只不过 concatMap()
转发出来的事件是有序的,而 flatMap()
是无序的
还是用 flatMap()
的例子来看
Observable.fromIterable(listArrayList).flatMap(new Function<List<String>, ObservableSource<String>>() {
@Override
public ObservableSource<String> apply(List<String> stringList1) throws Exception {
if (stringList1.get(0).startsWith("A")) {
return Observable.fromIterable(stringList1).delay(200, TimeUnit.MILLISECONDS);
}
return Observable.fromIterable(stringList1);
}
}).subscribe(new Consumer<String>() {
@Override
public void accept(String s) throws Exception {
Log.e(TAG, "value is: " + s);
}
});
进行了一次延时操作,可以看到两次事件的发送顺序颠倒了
10-06 11:07:30.753 18702-18702/leavesc.hello.rxjavademo E/MainActivity: value is: B_0
10-06 11:07:30.753 18702-18702/leavesc.hello.rxjavademo E/MainActivity: value is: B_1
10-06 11:07:30.953 18702-18716/leavesc.hello.rxjavademo E/MainActivity: value is: A_0
10-06 11:07:30.953 18702-18716/leavesc.hello.rxjavademo E/MainActivity: value is: A_1
使用 concatMap()
则顺序将保持一致
1.4、buffer()
从需要发送的事件当中获取指定数量的事件,并将这些事件放到缓冲区当中一并发出。buffer
有两个参数,参数一count
用于指点缓冲区大小,参数二 skip
用指定当缓冲区满了时,发送下一次事件序列的时候要跳过多少元素
Observable.just(1, 2, 3, 4, 5, 6)
.buffer(2, 2)
.subscribe(new Observer<List<Integer>>() {
@Override
public void onSubscribe(Disposable d) {
Log.e(TAG, "onSubscribe");
}
@Override
public void onNext(List<Integer> integers) {
Log.e(TAG, "缓冲区大小: " + integers.size());
for (Integer i : integers) {
Log.e(TAG, "元素: " + i);
}
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: " + e.getMessage());
}
@Override
public void onComplete() {
Log.e(TAG, "onComplete");
}
});
onSubscribe
缓冲区大小: 2
元素: 1
元素: 2
缓冲区大小: 2
元素: 3
元素: 4
缓冲区大小: 2
元素: 5
元素: 6
onComplete
1.5、groupBy()
用于将数据进行分组,每个分组都会返回一个被观察者。groupBy()
方法的返回值用于指定分组名,每返回一个新值就代表会创建一个分组
Observable.just(1, 2, 3, 4, 5, 6, 7)
.groupBy(new Function<Integer, String>() {
@Override
public String apply(Integer integer) {
if (integer < 4) {
return "hello";
}
return "hi";
}
})
.subscribe(new Observer<GroupedObservable<String, Integer>>() {
@Override
public void onSubscribe(Disposable d) {
Log.e(TAG, "onSubscribe");
}
@Override
public void onNext(final GroupedObservable<String, Integer> observable) {
observable.subscribe(new Observer<Integer>() {
@Override
public void onSubscribe(Disposable d) {
Log.e(TAG, "GroupedObservable onSubscribe");
}
@Override
public void onNext(Integer integer) {
Log.e(TAG, "GroupedObservable onNext key :" + observable.getKey());
Log.e(TAG, "GroupedObservable onNext value :" + integer);
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "GroupedObservable onError");
}
@Override
public void onComplete() {
Log.e(TAG, "GroupedObservable onComplete");
}
});
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError");
}
@Override
public void onComplete() {
Log.e(TAG, "onComplete");
}
});
10-06 11:16:35.616 19015-19015/? E/MainActivity: onSubscribe
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onSubscribe
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hello
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :1
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hello
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :2
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hello
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :3
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onSubscribe
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hi
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :4
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hi
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :5
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hi
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :6
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext key :hi
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onNext value :7
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onComplete
10-06 11:16:35.616 19015-19015/? E/MainActivity: GroupedObservable onComplete
10-06 11:16:35.616 19015-19015/? E/MainActivity: onComplete
1.6、scan()
scan()
操作符对原始 Observable
发射的第一条数据应用一个函数,然后将那个函数的结果作为自己的第一项数据发射。它将函数的结果同第二项数据一起填充给这个函数来产生它自己的第二项数据。它持续进行这个过程来产生剩余的数据序列
Observable.just(1, 5, 8, 12).scan(new BiFunction<Integer, Integer, Integer>() {
@Override
public Integer apply(Integer integer, Integer integer2) {
Log.e(TAG, "integer : " + integer);
Log.e(TAG, "integer2 : " + integer2);
return integer + integer2;
}
}).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) {
Log.e(TAG, "accept : " + integer);
}
});
10-06 11:25:19.389 19158-19158/leavesc.hello.rxjavademo E/MainActivity: accept : 1
10-06 11:25:19.389 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer : 1
10-06 11:25:19.389 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer2 : 5
10-06 11:25:19.399 19158-19158/leavesc.hello.rxjavademo E/MainActivity: accept : 6
10-06 11:25:19.399 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer : 6
10-06 11:25:19.399 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer2 : 8
10-06 11:25:19.399 19158-19158/leavesc.hello.rxjavademo E/MainActivity: accept : 14
10-06 11:25:19.399 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer : 14
10-06 11:25:19.409 19158-19158/leavesc.hello.rxjavademo E/MainActivity: integer2 : 12
10-06 11:25:19.409 19158-19158/leavesc.hello.rxjavademo E/MainActivity: accept : 26
二、组合操作符
2.1、concat() & concatArray()
用于将多个观察者组合在一起,然后按照参数的传入顺序发送事件,concat()
最多只可以发送4个事件
Observable.concat(Observable.just(1, 2),
Observable.just(3, 4),
Observable.just(5, 6),
Observable.just(7, 8)).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept: " + integer);
}
});
accept: 1
accept: 2
accept: 3
accept: 4
accept: 5
accept: 6
accept: 7
accept: 8
concatArray()
作用与 concat()
作用一样,不过前者可以发送多于 4 个的被观察者
2.2、merge() & mergeArray()
这个方法与 concat()
作用基本一样,只是 concat()
是串行发送事件,而 merge()
并行发送事件
Observable.merge(Observable.interval(1, TimeUnit.SECONDS).map(new Function<Long, String>() {
@Override
public String apply(Long aLong) {
return "Test_A_" + aLong;
}
}),
Observable.interval(1, TimeUnit.SECONDS).map(new Function<Long, String>() {
@Override
public String apply(Long aLong) {
return "Test_B_" + aLong;
}
})).subscribe(new Consumer<String>() {
@Override
public void accept(String s) {
Log.e(TAG, "accept: " + s);
}
});
Test_A_0
Test_B_0
Test_A_1
Test_B_1
Test_A_2
Test_B_2
Test_B_3
Test_A_3
Test_A_4
Test_B_4
Test_A_5
Test_B_5
mergeArray()
可以发送 4 个以上的被观察者
2.3、concatArrayDelayError() & mergeArrayDelayError()
在 concatArray()
和 mergeArray()
两个方法当中,如果其中有一个被观察者发送了一个 Error
事件,那么就会停止发送事件,如果想 onError()
事件延迟到所有被观察者都发送完事件后再执行的话,可以使用 concatArrayDelayError()
和 mergeArrayDelayError()
首先使用 concatArray()
来验证其发送 onError()
事件是否会中断其他被观察者的发送事件
Observable.concatArray(Observable.create(new ObservableOnSubscribe<Integer>() {
@Override
public void subscribe(ObservableEmitter<Integer> emitter) {
emitter.onNext(1);
emitter.onNext(2);
emitter.onError(new Exception("Normal Exception"));
}
}), Observable.just(30, 40, 50)).subscribe(new Observer<Integer>() {
@Override
public void onSubscribe(Disposable d) {
}
@Override
public void onNext(Integer integer) {
Log.e(TAG, "onNext: " + integer);
}
@Override
public void onError(Throwable e) {
Log.e(TAG, "onError: " + e.getMessage());
}
@Override
public void onComplete() {
}
});
onNext: 1
onNext: 2
onError: Normal Exception
从结果可以知道,确实中断了,现在换用 concatArrayDelayError()
10-06 04:00:04.935 6514-6514/? E/MainActivity: onNext: 1
10-06 04:00:04.935 6514-6514/? E/MainActivity: onNext: 2
10-06 04:00:04.935 6514-6514/? E/MainActivity: onNext: 30
10-06 04:00:04.935 6514-6514/? E/MainActivity: onNext: 40
10-06 04:00:04.935 6514-6514/? E/MainActivity: onNext: 50
10-06 04:00:04.935 6514-6514/? E/MainActivity: onError: Normal Exception
从结果可以看到,onError
事件是在所有被观察者发送完事件才发送的
2.4、zip()
zip()
操作符返回一个 Obversable
,它使用这个函数按顺序结合两个或多个 Observables 发射的数据项,然后它发射这个函数返回的结果。它按照严格的顺序应用这个函数。它只发射与发射数据项最少的那个 Observable 一样多的数据
Observable.zip(Observable.just(1, 2, 3, 4), Observable.just(5, 6, 7, 8, 9),
new BiFunction<Integer, Integer, String>() {
@Override
public String apply(Integer integer, Integer integer2) throws Exception {
return String.valueOf(integer) + "_" + String.valueOf(integer2);
}
})
.subscribe(new Consumer<String>() {
@Override
public void accept(String s) throws Exception {
Log.e(TAG, "accept: " + s);
}
});
accept: 1_5
accept: 2_6
accept: 3_7
accept: 4_8
2.5、combineLatest() & combineLatestDelayError()
combineLatest()
的作用与 zip()
类似,combineLatest()
发送事件的序列是与发送的时间线有关的,当两个 Observables
中的任何一个发射了一个数据时,通过一个指定的函数组合每个 Observable
发射的最新数据,然后发射这个函数的结果
Observable.zip(
Observable.intervalRange(1, 4, 1, 1, TimeUnit.SECONDS)
.map(new Function<Long, String>() {
@Override
public String apply(Long aLong) {
String s1 = "A" + aLong;
Log.e(TAG, "A 发送的事件 " + s1);
return s1;
}
}), Observable.intervalRange(1, 4, 2, 1, TimeUnit.SECONDS)
.map(new Function<Long, String>() {
@Override
public String apply(Long aLong) {
String s1 = "B" + aLong;
Log.e(TAG, "B 发送的事件 " + s1);
return s1;
}
}),
new BiFunction<String, String, String>() {
@Override
public String apply(String value1, String value2) throws Exception {
return value1 + "_" + value2;
}
})
.subscribe(new Consumer<String>() {
@Override
public void accept(String s) throws Exception {
Log.e(TAG, "accept: " + s);
}
});
10-06 05:17:06.337 7227-7241/leavesc.hello.rxjavademo E/MainActivity: A 发送的事件 A1
10-06 05:17:07.337 7227-7241/leavesc.hello.rxjavademo E/MainActivity: A 发送的事件 A2
10-06 05:17:07.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: B 发送的事件 B1
10-06 05:17:07.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: accept: A1_B1
10-06 05:17:08.337 7227-7241/leavesc.hello.rxjavademo E/MainActivity: A 发送的事件 A3
10-06 05:17:08.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: B 发送的事件 B2
10-06 05:17:08.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: accept: A2_B2
10-06 05:17:09.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: B 发送的事件 B3
10-06 05:17:09.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: accept: A3_B3
10-06 05:17:09.337 7227-7241/leavesc.hello.rxjavademo E/MainActivity: A 发送的事件 A4
10-06 05:17:10.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: B 发送的事件 B4
10-06 05:17:10.337 7227-7242/leavesc.hello.rxjavademo E/MainActivity: accept: A4_B4
当发送 A1 和 A2 事件时,B 并没有发送任何事件,所以不会触发到 accept
方法。当发送了 B1 事件之后,就会与 A 最新发送的事件 A2 结合成 A1_B2,之后的发射规则也以此类推
combineLatestDelayError()
多了延迟发送 onError()
的功能
2.6、reduce()
与 scan()
操作符的作用类似,也是将发送数据以一定逻辑聚合起来,区别在于 scan()
每处理一次数据就会将事件发送给观察者,而 reduce()
会将所有数据聚合在一起才会发送事件给观察者
Observable.just(1, 3, 5, 7).reduce(new BiFunction<Integer, Integer, Integer>() {
@Override
public Integer apply(Integer integer, Integer integer2) throws Exception {
Log.e(TAG, "integer1 : " + integer);
Log.e(TAG, "integer2 : " + integer2);
return integer + integer2;
}
}).subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept : " + integer);
}
});
integer1 : 1
integer2 : 3
integer1 : 4
integer2 : 5
integer1 : 9
integer2 : 7
accept : 16
2.7、collect()
collect()
与 reduce()
类似,但它的目的是收集原始 Observable 发射的所有数据到一个可变的数据结构
Observable.just(1, 2, 3, 4)
.collect(new Callable<ArrayList<Integer>>() {
@Override
public ArrayList<Integer> call() throws Exception {
return new ArrayList<>();
}
}, new BiConsumer<ArrayList<Integer>, Integer>() {
@Override
public void accept(ArrayList<Integer> integers, Integer integer) throws Exception {
integers.add(integer);
}
})
.subscribe(new Consumer<ArrayList<Integer>>() {
@Override
public void accept(ArrayList<Integer> integers) throws Exception {
Log.e(TAG, "accept : " + integers);
}
});
accept : [1, 2, 3, 4]
2.8、startWith() & startWithArray()
在发送事件之前追加事件,startWith()
追加一个事件,startWithArray()
可以追加多个事件,追加的事件会先发出
Observable.just(4, 5)
.startWithArray(2, 3)
.startWith(1)
.subscribe(new Consumer<Integer>() {
@Override
public void accept(Integer integer) throws Exception {
Log.e(TAG, "accept : " + integer);
}
});
10-06 05:38:21.081 8033-8033/leavesc.hello.rxjavademo E/MainActivity: accept : 1
10-06 05:38:21.081 8033-8033/leavesc.hello.rxjavademo E/MainActivity: accept : 2
10-06 05:38:21.081 8033-8033/leavesc.hello.rxjavademo E/MainActivity: accept : 3
10-06 05:38:21.081 8033-8033/leavesc.hello.rxjavademo E/MainActivity: accept : 4
10-06 05:38:21.081 8033-8033/leavesc.hello.rxjavademo E/MainActivity: accept : 5
2.9、count()
返回被观察者发送事件的数量
Observable.just(1, 2, 3)
.count()
.subscribe(new Consumer<Long>() {
@Override
public void accept(Long aLong) throws Exception {
Log.e(TAG, "aLong : " + aLong);
}
});
aLong : 3