debounce操作符
debounce操作符對源Observable每產(chǎn)生一個結(jié)果后，如果在規(guī)定的間隔時間內(nèi)沒有別的結(jié)果產(chǎn)生，則把這個結(jié)果提交給訂閱者處理，否則忽略該結(jié)果。
值得注意的是，如果源Observable產(chǎn)生的最后一個結(jié)果后在規(guī)定的時間間隔內(nèi)調(diào)用了onCompleted，那么通過debounce操作符也會把這個結(jié)果提交給訂閱者。
Observable.create(new Observable.OnSubscribe<Integer>() {
@Override
public void call(Subscriber<? super Integer> subscriber) {
if(subscriber.isUnsubscribed()) return;
try {
//產(chǎn)生結(jié)果的間隔時間分別為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);
}
}
}).subscribeOn(Schedulers.newThread())
.debounce(400, TimeUnit.MILLISECONDS) //超時時間為400毫秒
.subscribe(
new Action1<Integer>() {
@Override
public void call(Integer integer) {
System.out.println("Next:" + integer);
}
}, new Action1<Throwable>() {
@Override
public void call(Throwable throwable) {
System.out.println("Error:" + throwable.getMessage());
}
}, new Action0() {
@Override
public void call() {
System.out.println("completed!");
}
});
運行結(jié)果如下：
Next:4
Next:5
Next:6
Next:7
Next:8
Next:9
completed!
distinct操作符
distinct操作符對源Observable產(chǎn)生的結(jié)果進行過濾，把重復的結(jié)果過濾掉，只輸出不重復的結(jié)果給訂閱者，非常類似于SQL里的distinct關(guān)鍵字。
Observable.just(1, 2, 1, 1, 2, 3)
.distinct()
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 1
Next: 2
Next: 3
Sequence complete.
elementAt操作符
elementAt操作符在源Observable產(chǎn)生的結(jié)果中，僅僅把指定索引的結(jié)果提交給訂閱者，索引是從0開始的。
Observable.just(1,2,3,4,5,6).elementAt(2)
.subscribe(
new Action1<Integer>() {
@Override
public void call(Integer integer) {
System.out.println("Next:" + integer);
}
}, new Action1<Throwable>() {
@Override
public void call(Throwable throwable) {
System.out.println("Error:" + throwable.getMessage());
}
}, new Action0() {
@Override
public void call() {
System.out.println("completed!");
}
});
運行結(jié)果如下：
Next:3
completed!
filter操作符
filter操作符是對源Observable產(chǎn)生的結(jié)果按照指定條件進行過濾，只有滿足條件的結(jié)果才會提交給訂閱者
Observable.just(1, 2, 3, 4, 5)
.filter(new Func1<Integer, Boolean>() {
@Override
public Boolean call(Integer item) {
return( item < 4 );
}
}).subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 1
Next: 2
Next: 3
Sequence complete.
ofType操作符
ofType操作符類似于filter操作符，區(qū)別在于ofType操作符是按照類型對結(jié)果進行過濾
Observable.just(1, "hello world", true, 200L, 0.23f)
.ofType(Float.class)
.subscribe(new Subscriber<Object>() {
@Override
public void onNext(Object item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 0.23
Sequence complete.
first操作符
first操作符是把源Observable產(chǎn)生的結(jié)果的第一個提交給訂閱者，first操作符可以使用elementAt(0)和take(1)替代。
Observable.just(1,2,3,4,5,6,7,8)
.first()
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 1
Sequence complete.
single操作符
single操作符是對源Observable的結(jié)果進行判斷，如果產(chǎn)生的結(jié)果滿足指定條件的數(shù)量不為1，則拋出異常，否則把滿足條件的結(jié)果提交給訂閱者
Observable.just(1,2,3,4,5,6,7,8)
.single(new Func1<Integer, Boolean>() {
@Override
public Boolean call(Integer integer) {
//取大于10的第一個數(shù)字
return integer>10;
}
})
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Error: Sequence contains no elements
last操作符
last操作符把源Observable產(chǎn)生的結(jié)果的最后一個提交給訂閱者，last操作符可以使用takeLast(1)替代。
Observable.just(1, 2, 3)
.last()
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 3
Sequence complete.
ignoreElements操作符
ignoreElements操作符忽略所有源Observable產(chǎn)生的結(jié)果，只把Observable的onCompleted和onError事件通知給訂閱者。ignoreElements操作符適用于不太關(guān)心Observable產(chǎn)生的結(jié)果，只是在Observable結(jié)束時(onCompleted)或者出現(xiàn)錯誤時能夠收到通知。
Observable.just(1,2,3,4,5,6,7,8).ignoreElements()
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Sequence complete.
sample操作符
sample操作符定期掃描源Observable產(chǎn)生的結(jié)果，在指定的時間間隔范圍內(nèi)對源Observable產(chǎn)生的結(jié)果進行采樣
Observable.create(new Observable.OnSubscribe<Integer>() {
@Override
public void call(Subscriber<? super Integer> subscriber) {
if(subscriber.isUnsubscribed()) return;
try {
//前8個數(shù)字產(chǎn)生的時間間隔為1秒，后一個間隔為3秒
for (int i = 1; i < 9; i++) {
subscriber.onNext(i);
Thread.sleep(1000);
}
Thread.sleep(2000);
subscriber.onNext(9);
subscriber.onCompleted();
} catch(Exception e){
subscriber.onError(e);
}
}
}).subscribeOn(Schedulers.newThread())
.sample(2200, TimeUnit.MILLISECONDS) //采樣間隔時間為2200毫秒
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 3
Next: 5
Next: 7
Next: 8
Sequence complete.
skip操作符
skip操作符針對源Observable產(chǎn)生的結(jié)果，跳過前面n個不進行處理，而把后面的結(jié)果提交給訂閱者處理
Observable.just(1,2,3,4,5,6,7).skip(3)
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 4
Next: 5
Next: 6
Next: 7
Sequence complete.
skipLast操作符
skipLast操作符針對源Observable產(chǎn)生的結(jié)果，忽略O(shè)bservable最后產(chǎn)生的n個結(jié)果，而把前面產(chǎn)生的結(jié)果提交給訂閱者處理
值得注意的是，skipLast操作符提交滿足條件的結(jié)果給訂閱者是存在延遲效果的
可以看到skipLast操作符把最后的天藍色球、藍色球、紫色球忽略掉了，但是前面的紅色球等并不是源Observable一產(chǎn)生就直接提交給訂閱者，這里有一個延遲的效果。
Observable.just(1,2,3,4,5,6,7).skipLast(3)
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 1
Next: 2
Next: 3
Next: 4
Sequence complete.
take操作符
take操作符是把源Observable產(chǎn)生的結(jié)果，提取前面的n個提交給訂閱者，而忽略后面的結(jié)果
調(diào)用例子如下：
Observable.just(1, 2, 3, 4, 5, 6, 7, 8)
.take(4)
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 1
Next: 2
Next: 3
Next: 4
Sequence complete.
takeFirst操作符
takeFirst操作符類似于take操作符，同時也類似于first操作符，都是獲取源Observable產(chǎn)生的結(jié)果列表中符合指定條件的前一個或多個，與first操作符不同的是，first操作符如果獲取不到數(shù)據(jù)，則會拋出NoSuchElementException異常，而takeFirst則會返回一個空的Observable，該Observable只有onCompleted通知而沒有onNext通知。
Observable.just(1,2,3,4,5,6,7).takeFirst(new Func1<Integer, Boolean>() {
@Override
public Boolean call(Integer integer) {
//獲取數(shù)值大于3的數(shù)據(jù)
return integer>3;
}
})
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 4
Sequence complete.
takeLast操作符
takeLast操作符是把源Observable產(chǎn)生的結(jié)果的后n項提交給訂閱者，提交時機是Observable發(fā)布onCompleted通知之時
Observable.just(1,2,3,4,5,6,7).takeLast(2)
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
運行結(jié)果如下：
Next: 6
Next: 7
Sequence complete.
