Subject

Subject是一种桥接或代理,可在ReactiveX的某些实现中用作观察者(observer)和可观察对象(observable)。因为它是观察者,所以可以订阅一个或多个Observable。因为它是可观察的,所以它可以通过释放观测到的数据(reemitting),也可以发出新的数据(emit new items)。
因为一个subject订阅了一个Observable,它将触发Observable开始发射数据(如果Observable是“冷”的-也就是说,如果它在开始发出数据之前等待订阅)。这可以使最终的Subject成为原始“cold”可观察到的“hot”可观察到的变体(subject中的一些类型可以立即发射数据,无需像Observable一样subscribe才触发)。

针对特定用例设计了四种subject,并非所有这些实现在所有实现中都可用,并且某些实现使用其他命名约定。

AsyncSubject

使用AsyncSubject.create()的创建AsyncSubject。AsyncSubject只会在onComplete方法调用才会发射数据,只会发射一次最后的数据。如果源Observable不发出任何值,则AsyncSubject也将完成而不会发出任何值(可以使用observer.assertNoValues())。
它将向所有后续观察者发出相同的最终值(比如下面的observer和observer1)。
但是,如果源Observable终止并发生错误,则AsyncSubject将不会发出任何项目,而只会传递来自源Observable的错误通知。

代码示例

多次onNext,但是只可以看到最后一次的数据。多个observer都可以看到

AsyncSubject subject = AsyncSubject.create();
TestObserver observer = subject.test();
observer.assertEmpty();
subject.onNext("1");
observer.assertEmpty();
//AsyncSubject only emits when onComplete was called.
subject.onNext("2");
subject.onComplete();
observer.assertResult("2");

TestObserver observer1 = subject.test();
observer1.assertResult("2");

没有发射出数据

AsyncSubject subject = AsyncSubject.create();
TestObserver observer = subject.test();
subject.onComplete();
//observer.assertComplete();
observer.assertNoValues();

subject发生了异常,下游可以看到。

AsyncSubject subject = AsyncSubject.create();
TestObserver observer = subject.test();
Throwable t = new RuntimeException("发生异常啦");
subject.onError(t);
observer.assertError(t);

弹珠图

image.png

image.png

BehaviorSubject

当观察者订阅了BehaviorSubject,它首先发出源Observable最新发出的数据(如果尚未发出,则为默认值)
然后继续发出源Observable稍后发出的任何其他项目。
如果源Observable终止并发生错误,那么BehaviorSubject将不会向后续观察者发出任何项目,而只会传递源Observable的错误通知。
包含default值的订阅, 输出内容是default,one,two,three

代码示例

BehaviorSubject subjectHasDefault = BehaviorSubject.createDefault("default");
//default,one,two,three
subjectHasDefault.subscribe(System.out::println);
subjectHasDefault.onNext("one");
subjectHasDefault.onNext("two");
subjectHasDefault.onNext("three");

已经发射出数据后订阅,将从最新的数据开始输出。如下输出结果one,two,three

BehaviorSubject subject = BehaviorSubject.create();
subject.onNext("zero");
subject.onNext("one");
//one,two,three
subject.subscribe(System.out::println);
subject.onNext("two");
subject.onNext("three");
 
 

没有发出任何数据, 直接onComplete

BehaviorSubject emptySubject = BehaviorSubject.create();
emptySubject.onNext("zero");
emptySubject.onNext("one");
emptySubject.onComplete();
 
 

subject产生错误,observer会输出错误

BehaviorSubject errorSubject = BehaviorSubject.create();
errorSubject.onNext("zero");
errorSubject.onNext("one");
errorSubject.onError(new RuntimeException("error"));
//错误信息
        errorSubject.subscribe(System.out::println);
 
 

弹珠图

image.png

image.png

PublishSubject

PublishSubject仅向观察者发出订阅之后源Observable发出的那些项。请注意,PublishSubject可能会在创建后立即开始发射项目(除非您已采取措施防止这种情况发生),因此存在这样的风险,即在创建主题和观察者订阅该主题之间可能会丢失一个或多个项目
如果您需要保证从Observable订阅到所有数据,您将需要通过“Create”来形成“可观察”行为,以便您手动重新引入“冷”可观察行为(在开始发出项目之前检查所有观察者是否已订阅)。或改用ReplaySubject。
如果源Observable终止并发生错误,则PublishSubject不会将任何项目发送给后续的观察者,而只是传递来自源Observable的错误通知。

代码示例

如下的例子observer1只会输出three,four,订阅之前的数据无法订阅到

PublishSubject subject = PublishSubject.create();
subject.onNext("one");
subject.onNext("two");
subject.subscribe(System.out::println); //输出three,four
subject.onNext("three");
subject.onNext("four");
subject.onComplete();
subject.test().assertComplete();

PublishSubject遇到了error,则订阅者可以观测到异常。

PublishSubject errorSubject = PublishSubject.create();
errorSubject.onError(new RuntimeException("哈哈哈"));
errorSubject.subscribe(System.out::println);

弹珠图

image.png

image.png

ReplaySubject

ReplaySubject向观察者发出源Observable发出的所有数据,无论观察者何时订阅。
还有一些ReplaySubject版本,一旦重播缓冲区有可能增长到超过一定大小,或者自从最初发出项目以来经过了指定的时间跨度,它们就会丢弃旧数据。
如果使用ReplaySubject作为观察者,请注意不要从多个线程调用其onNext方法(或其他on方法),因为这可能导致同时发生(非顺序发生)的调用,这违反了Observable规约,并在生成的Subject中产生了关于哪个数据或通知应首先重放的不确定性。

代码示例

ReplaySubject subject = ReplaySubject.create();
subject.onNext("one");
subject.onNext("two");
subject.onNext("three");
subject.onComplete();

subject.subscribe(r -> System.out.println("[observer1] " + r));
System.out.println("================");
subject.subscribe(r -> System.out.println("[observer2] " + r));
 
 

输出结果

[observer1] one
[observer1] two
[observer1] three
================
[observer2] one
[observer2] two
[observer2] three

弹珠图

image.png

你可能感兴趣的:(Subject)