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);
弹珠图
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
没有发出任何数据, 直接onComplete
BehaviorSubject
subject产生错误,observer会输出错误
BehaviorSubject
弹珠图
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);
弹珠图
ReplaySubject
ReplaySubject向观察者发出源Observable发出的所有数据,无论观察者何时订阅。
还有一些ReplaySubject版本,一旦重播缓冲区有可能增长到超过一定大小,或者自从最初发出项目以来经过了指定的时间跨度,它们就会丢弃旧数据。
如果使用ReplaySubject作为观察者,请注意不要从多个线程调用其onNext方法(或其他on方法),因为这可能导致同时发生(非顺序发生)的调用,这违反了Observable规约,并在生成的Subject中产生了关于哪个数据或通知应首先重放的不确定性。
代码示例
ReplaySubject
输出结果
[observer1] one
[observer1] two
[observer1] three
================
[observer2] one
[observer2] two
[observer2] three