Debounce
仅在过了一段指定的时间还没发射数据时才发射一个数据,会过滤掉发射速率过快的数据项。
debounce 默认在 computation 调度器上执行,也可指定调度器。
Observable.range(1, 10)
.flatMap((Function<Integer, ObservableSource<Integer>>) integer -> {
int delay = new Random().nextInt(5);
System.out.println(System.currentTimeMillis() + " - emitter " + integer + " with delay " + delay);
return Observable.just(integer).delay(delay, TimeUnit.SECONDS);
})
.debounce(500, TimeUnit.MILLISECONDS)
.subscribe(new Observer<Integer>() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onNext(@NonNull Integer integer) {
System.out.println(System.currentTimeMillis() + " - onNext :" + integer);
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
@Override
public void onComplete() {
System.out.println(System.currentTimeMillis() + " - onComplete");
}
});
结果:
1601279968513 - onSubscribe
1601279968513 - emitter 1 with delay 1
1601279968518 - emitter 2 with delay 4
1601279968520 - emitter 3 with delay 3
1601279968522 - emitter 4 with delay 0
1601279968524 - emitter 5 with delay 2
1601279968526 - emitter 6 with delay 2
1601279968528 - emitter 7 with delay 1
1601279968530 - emitter 8 with delay 4
1601279968531 - emitter 9 with delay 0
1601279968532 - emitter 10 with delay 4
1601279969033 - onNext :9
1601279970034 - onNext :7
1601279971031 - onNext :6
1601279972026 - onNext :3
1601279972539 - onNext :10
1601279972540 - onComplete
Distinct
过滤掉重复的数据项,只允许还没有发射过的数据项通过。
distinct()
Observable.just(1, 2, 3, 3, 5, 2, 4)
.distinct()
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept :" + integer));
结果:
1601283270028 - accept :1
1601283270028 - accept :2
1601283270028 - accept :3
1601283270029 - accept :5
1601283270029 - accept :4
distinct(Func1)
指定函数根据数据计算key,只过滤key重复的项。
Observable.just(1, 2, 3, 3, 5, 2, 4)
.distinct(integer -> integer % 2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept :" + integer));
结果:
1601283315276 - accept :1
1601283315276 - accept :2
distinctUntilChanged()
仅过滤相邻的重复项。
Observable.just(1, 2, 3, 3, 5, 2, 4)
.distinctUntilChanged()
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept :" + integer));
结果:
1601283492051 - accept :1
1601283492051 - accept :2
1601283492051 - accept :3
1601283492051 - accept :5
1601283492052 - accept :2
1601283492052 - accept :4
distinctUntilChanged(Func1)
仅过滤根据指定函数计算的key相邻重复的项。
Observable.just(1, 2, 3, 3, 5, 2, 4)
.distinctUntilChanged(integer -> integer % 2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept :" + integer));
结果:
1601283349667 - accept :1
1601283349668 - accept :2
1601283349669 - accept :3
1601283349669 - accept :2
ElementAt
只发射指定索引位置的数据项。elementAt(int)
Observable.just(1, 2, 3, 4, 5)
.elementAt(3)
.subscribe(new MaybeObserver<Integer>() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onSuccess(@NonNull Integer integer) {
System.out.println(System.currentTimeMillis() + " - onSuccess : " + integer);
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
@Override
public void onComplete() {
System.out.println(System.currentTimeMillis() + " - onComplete");
}
});
结果:
1601287405930 - onSubscribe
1601287405931 - onSuccess : 4
elementAt(int, T)
如果索引值大于数据项数,它会发射一个默认值,而不会抛出异常,但是如果传递一个负数索引,仍然会抛出异常。
Observable.just(1, 2, 3, 4, 5)
.elementAt(6, 0)
.subscribe(new SingleObserver<Integer>() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onSuccess(@NonNull Integer integer) {
System.out.println(System.currentTimeMillis() + " - onSuccess : " + integer);
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
});
结果:
1601287423744 - onSubscribe
1601287423744 - onSuccess : 0
Filter
指定函数过滤数据项。filter 默认不在任何特定的调度器上执行。
Observable.just(1, 2, 3, 4, 5)
.filter(integer -> integer < 3)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601361677541 - accept : 1
1601361677542 - accept : 2
First
只发射第一个数据项。firstElement()
Observable.just(1, 2, 3, 4, 5)
.firstElement()
.subscribe(new MaybeObserver<Integer>() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onSuccess(@NonNull Integer integer) {
System.out.println(System.currentTimeMillis() + " - onSuccess : " + integer);
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
@Override
public void onComplete() {
System.out.println(System.currentTimeMillis() + " - onComplete");
}
});
结果:
1601361708189 - onSubscribe
1601361708190 - onSuccess : 1
firstElement(defaultItem)
没有元素的时候,返回一个默认值。
Observable.just(1, 2, 3, 4, 5)
.filter(integer -> integer > 5)
.first(0)
.subscribe(new SingleObserver<Integer>() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onSuccess(@NonNull Integer integer) {
System.out.println(System.currentTimeMillis() + " - onSuccess : " + integer);
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
});
结果:
1601361735834 - onSubscribe
1601361735834 - onSuccess : 0
IgnoreElements
抑制原始 Observable 发射的所有数据,只允许它的终止通知(onError和onCompleted)通过。
ignoreElements 默认不在任何特定的调度器上执行。
Observable.just(1, 2, 3, 4, 5)
.ignoreElements()
.subscribe(new CompletableObserver() {
@Override
public void onSubscribe(@NonNull Disposable d) {
System.out.println(System.currentTimeMillis() + " - onSubscribe");
}
@Override
public void onComplete() {
System.out.println(System.currentTimeMillis() + " - onComplete");
}
@Override
public void onError(@NonNull Throwable e) {
System.out.println(System.currentTimeMillis() + " - onError");
}
});
结果:
1601362003092 - onSubscribe
1601362003093 - onComplete
Last
只发射最后一个数据项。
有lastElement()、last(defaultItem),类似 first。
Observable.just(1, 2, 3, 4, 6)
.lastElement()
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365040647 - accept : 6
Sample
定时发射 Observable 最近发射的数据项。
sample 默认在 computation 调度器上执行,可以参数指定调度器。
sample / throttleLast
在每个采样周期内,它总是发射原始Observable的最近的一项。
Observable.create((ObservableOnSubscribe<Integer>) emitter -> {
try {
for (int i=0; i<10; i++) {
Thread.sleep(1000);
emitter.onNext(i);
}
emitter.onComplete();
} catch (Exception ex) {
emitter.onError(ex);
}
})
.sample(3, TimeUnit.SECONDS)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365087140 - accept : 1
1601365090140 - accept : 4
1601365093140 - accept : 7
throttleFirst
在每个采样周期内,它总是发射原始Observable的第一项数据,而不是最近的一项。
Observable.create((ObservableOnSubscribe<Integer>) emitter -> {
try {
for (int i=0; i<10; i++) {
Thread.sleep(1000);
emitter.onNext(i);
}
emitter.onComplete();
} catch (Exception ex) {
emitter.onError(ex);
}
})
.throttleFirst(3, TimeUnit.SECONDS)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365111722 - accept : 0
1601365114732 - accept : 3
1601365117737 - accept : 6
1601365120741 - accept : 9
Skip
skip(int):跳过前面n个数据项,默认不在任何特定的调度器上执行。
skip(long,TimeUnit):跳过指定时长内发射的数据,这个方法默认在 computation 调度器执行,可通过参数指定。
Observable.just(1, 2, 3, 4, 5)
.skip(2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365188338 - accept : 3
1601365188339 - accept : 4
1601365188339 - accept : 5
SkipLast
skipLast(int):跳过最后n个数据项。
skipLast(long,TimeUnit):跳过最后一段时间的数据项。
Observable.just(1, 2, 3, 4, 5)
.skipLast(2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365216797 - accept : 1
1601365216797 - accept : 2
1601365216797 - accept : 3
Take
take(int):只发射前面n个数据项;
take(long,TimeUnit) :发射一段时间内的数据项;
Observable.just(1, 2, 3, 4, 5)
.take(2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365248492 - accept : 1
1601365248492 - accept : 2
TakeLast
takeLast(int):只发射后面n个数据项;
takeLast(long,TimeUnit) :发射最后一段时间内的数据项;
Observable.just(1, 2, 3, 4, 5)
.takeLast(2)
.subscribe(integer -> System.out.println(System.currentTimeMillis() + " - accept : " + integer));
结果:
1601365267191 - accept : 4
1601365267191 - accept : 5
参考资料
RxJava中文文档
原文链接:https://blog.csdn.net/doris_d/article/details/108846889