原文地址：樑桂釗的部落格
部落格地址：blog.720ui.com
歡迎轉載，轉載請註明作者及出處，謝謝！
RxJava 2.x 提供了五種模式，如下所示。
|
模式/型別
|
描述
|
介面
|
消費者
|
Observable |
支援 0…N個資料
不支援背壓
|
io.reactivex.Observable |
Observer |
Flowable |
支援 0…N個資料 支援背壓
|
io.reactivex.Flowable |
Subscriber |
Single |
只支援1個資料
|
io.reactivex.Single |
SingleObserver |
Completable |
不支援資料
|
io.reactivex.Completable |
CompletableObserver |
Maybe |
只支援0或1個資料
|
io.reactivex.Maybe |
MaybeObserver |
Observable
建立 Observable 非常容易，我們首先需要建立一個 Observable 作為被觀察者，然後在建立一個 Observer 作為觀察者，然後通過 subscribe() 進行訂閱。
public class ObservableDemo {
public static void main(String[] args) {
Observable<
String>
observable = Observable.create(emitter ->
{
emitter.onNext("Hello World");
emitter.onNext("Hello World");
emitter.onComplete();
emitter.onNext("Hello World");
});
Observer<
String>
observer = new Observer<
String>
() {
@Override public void onSubscribe(Disposable d) {
System.out.println("Observer.onSubscribe");
} @Override public void onNext(String s) {
System.out.println("Observer.onNext: " + s);
} @Override public void onError(Throwable e) {
System.out.println("Observer.onError");
} @Override public void onComplete() {
System.out.println("Observer.onComplete");
}
};
observable.subscribe(observer);
}
} 複製程式碼我們可以使用 create 建立一個 Observable，它擁有 onNext, onError, onCompleted 方法。其中，onNext用於發射資料項，可以多次呼叫，每呼叫一次發射一條資料， onError 或 onCompleted 只能呼叫一次，onError發射錯誤事件，除非使用 retry() 操作符來截獲錯誤，否則事件流通常會終止。onCompleted 傳遞一個完成事件，表示不會再發生onNext呼叫。兩者之間互斥，此後就不能再呼叫該 Observable 的其他方法。
這裡，我們也可以改造成鏈式呼叫。
public class ObservableDemo2 {
public static void main(String[] args) {
Observable.<
String>
create(emitter ->
{
emitter.onNext("Hello World");
emitter.onNext("Hello World");
emitter.onComplete();
emitter.onNext("Hello World");
}).subscribe(new Observer<
String>
() {
@Override public void onSubscribe(Disposable d) {
System.out.println("Observer.onSubscribe");
} @Override public void onNext(String s) {
System.out.println("Observer.onNext: " + s);
} @Override public void onError(Throwable e) {
System.out.println("Observer.onError");
} @Override public void onComplete() {
System.out.println("Observer.onComplete");
}
});
}
}複製程式碼閱讀 RxJava 2.x 原始碼 io.reactivex.Observable，我們可以知道 subscribe 具有很多過載的方法。有興趣的讀者，可以深入瞭解下。我們可以省略 onComplete()，只實現 onNext() 和 onError()。這將不再對 onComplete() 執行任何操作。我們甚至可以忽略 onError()，只指定 onNext()。但是，不實現 onError() 是在生產環境中應該避免的事情。在事件流的任何地方發生的錯誤都將傳播到 onError() 進行處理，然後終止事件流。如果我們沒有為 onError() 指定一個操作，那麼該錯誤將不會處理。當然，如果出現錯誤，我們可以先嚐試使用 retry() 操作符恢復並重新訂閱可觀察到的資料項。
public final Disposable subscribe()public final Disposable subscribe(Consumer<
? super T>
onNext)public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError) public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError, Action onComplete) public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError, Action onComplete, Consumer<
? super Disposable>
onSubscribe)public final void subscribe(Observer<
? super T>
observer) 複製程式碼這裡，我們簡單來了解一下subscribe(Consumer<的使用吧。
? super T>
onNext)
public class ObservableDemo3 {
public static void main(String[] args) {
Observable.<
String>
create(emitter ->
{
emitter.onNext("Hello World");
emitter.onNext("Hello World");
emitter.onComplete();
emitter.onNext("Hello World");
}).subscribe(System.out::println);
}
}複製程式碼注意， onNext, onError, onCompleted
方法不需要直接推送到最終的觀察者，它們可以通過 map() 和 filter() 等操作符建立新的 Observable 然後繼續傳送。
Flowable
Flowable 是唯一支援背壓的模式，它的用法與 Observable 非常相似。（關於背壓，筆者會在之後的文章中進行講解。）
public class FlowableDemo {
public static void main(String[] args) {
Flowable.<
String>
create(e ->
{
e.onNext("Hello world!");
e.onNext("Hello World");
e.onComplete();
e.onNext("Hello World");
}, BackpressureStrategy.MISSING).subscribe(new Subscriber<
String>
(){
@Override public void onSubscribe(Subscription subscription) {
System.out.println("Subscriber.onSubscribe");
} @Override public void onNext(String s) {
System.out.println("Subscriber.onNext: " + s);
} @Override public void onError(Throwable throwable) {
System.out.println("Subscriber.onError");
} @Override public void onComplete() {
System.out.println("Subscriber.onComplete");
}
});
}
}複製程式碼閱讀 RxJava 2.x 原始碼 io.reactivex.Flowable，我們可以知道 subscribe 也具有很多過載的方法。
public final Disposable subscribe() public final Disposable subscribe(Consumer<
? super T>
onNext)public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError)public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError, Action onComplete)public final Disposable subscribe(Consumer<
? super T>
onNext, Consumer<
? super Throwable>
onError, Action onComplete, Consumer<
? super Subscription>
onSubscribe)public final void subscribe(FlowableSubscriber<
? super T>
s)public final void subscribe(Subscriber<
? super T>
s)複製程式碼Single
Single 的工作就像 Observable 一樣，但是它只有 onSuccess
事件和 onError 事件，並且它有自己的 SingleObserver 介面。 onSuccess 整合了 onNext 和 onComplete 事件，因此，這裡 onSuccess 只能傳送一個資料，換句話說，即使多次傳送也不會產生效果。
public class SingleDemo {
public static void main(String[] args) {
Single.<
String>
create(e ->
{
e.onSuccess("success");
e.onSuccess("success");
}).subscribe(new SingleObserver<
String>
(){
@Override public void onSubscribe(Disposable d) {
System.out.println("SingleObserver.onSubscribe");
} @Override public void onSuccess(String s) {
System.out.println("SingleObserver.onSuccess:"+s);
} @Override public void onError(Throwable e) {
System.out.println("SingleObserver.onError");
}
});
}
}複製程式碼從控制檯的列印結果可以看出，即使多次傳送“success”，但是隻會消費一次。
閱讀 RxJava 2.x 原始碼 io.reactivex.Single，我們可以知道 subscribe 也具有很多過載的方法。
public final Disposable subscribe()public final Disposable subscribe(final BiConsumer<
? super T, ? super Throwable>
onCallback)public final Disposable subscribe(Consumer<
? super T>
onSuccess)public final Disposable subscribe(final Consumer<
? super T>
onSuccess, final Consumer<
? super Throwable>
onError)public final void subscribe(SingleObserver<
? super T>
subscriber)複製程式碼這裡，我們簡單來了解一下subscribe(Consumer<的使用吧。
? super T>
onSuccess)
public class SingleDemo2 {
public static void main(String[] args) {
Single.<
String>
create(e ->
{
e.onSuccess("success");
}).subscribe(System.out::println);
}
}複製程式碼我們可以通過 toObservable 轉換成一個 Observable 物件。
Single.just("success").toObservable().subscribe(System.out::println);
複製程式碼Completable
Completable 不傳送資料，只有 onComplete 事件和 onError 事件。
public class CompletableDemo {
public static void main(String[] args) {
Completable.create(e ->
{
e.onComplete();
}) .subscribe(System.out::println);
}
}複製程式碼此外，我們可以通過 complete() 快速建立一個 Completable 物件，它會立即呼叫 onComplete 事件。
Completable.complete().subscribe(System.out::println);
複製程式碼或者，也可以通過 fromAction() 或 fromRunnable() 在呼叫 onComplete 事件之前執行指定的操作。
Completable.fromAction(System.out::println).subscribe();
複製程式碼Maybe
Maybe 結合了 Single 和 Completable 特性。Maybe 包含 onSuccess、onError、onComplete 事件。 這裡，onSuccess 可以傳送 0 ~ 1 個資料，換句話說，即使多次傳送也不會產生效果。如果呼叫 onComplete 事件，就會停止傳送資料。
public class MaybeDemo {
public static void main(String[] args) {
Maybe.<
String>
create(e ->
{
e.onComplete();
e.onSuccess("success");
e.onSuccess("success");
}).subscribe(System.out::println);
}
}複製程式碼參考資料
- 《RxJava 2.x 實戰》（沈哲）
- 《Learning Rxjava》（Thomas Nield）
- github.com/ReactiveX/R…
原始碼
相關示例完整程式碼： github.com/lianggzone/…
（完，轉載請註明作者及出處。）
更多精彩文章，盡在「服務端思維」！