rx.observers

Class SafeSubscriber<T>

java.lang.Object

rx.Subscriber<T>

rx.observers.SafeSubscriber<T>

Type Parameters:

T - the type of item expected by the Subscriber

All Implemented Interfaces:

Observer<T>, Subscription

public class SafeSubscriber<T>
extends Subscriber<T>

Wrapper around Observer that ensures compliance with the Rx contract.

The following is taken from the Rx Design Guidelines document:

Messages sent to instances of the IObserver interface follow the following grammar:

OnNext* (OnCompleted | OnError)?

This grammar allows observable sequences to send any amount (0 or more) of OnNext messages to the subscribed observer instance, optionally followed by a single success (OnCompleted) or failure (OnError) message.

The single message indicating that an observable sequence has finished ensures that consumers of the observable sequence can deterministically establish that it is safe to perform cleanup operations.

A single failure further ensures that abort semantics can be maintained for operators that work on multiple observable sequences (see paragraph 6.6).

This wrapper does the following:

• Allows only single execution of either onError or onCompleted.
• Ensures that once an onCompleted or onError is performed, no further calls can be executed
• If unsubscribe is called, calls completed and forbids any further onNext calls.
• When onError or onComplete occur, unsubscribes from the Observable (if executing asynchronously).

SafeSubscriber will not synchronize onNext execution. Use SerializedSubscriber to do that.

Constructor Summary

Constructors

Constructor and Description
SafeSubscriber(Subscriber<? super T> actual)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	_onError(java.lang.Throwable e) The logic for onError without the isFinished check so it can be called from within onCompleted.
Subscriber<? super T>	getActual() Returns the Subscriber underlying this SafeSubscriber.
void	onCompleted() Notifies the Observer that the Observable has finished sending push-based notifications.
void	onError(java.lang.Throwable e) Notifies the Observer that the Observable has experienced an error condition.
void	onNext(T args) Provides the Observer with a new item to observe.

Methods inherited from class rx.Subscriber

add, isUnsubscribed, onStart, request, setProducer, unsubscribe

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SafeSubscriber

public SafeSubscriber(Subscriber<? super T> actual)

Method Detail

onCompleted

public void onCompleted()

Description copied from interface: Observer

Notifies the Observer that the Observable has finished sending push-based notifications.

The Observable will not call this method if it calls Observer.onError(java.lang.Throwable).

onError

public void onError(java.lang.Throwable e)

Description copied from interface: Observer

Notifies the Observer that the Observable has experienced an error condition.

If the Observable calls this method, it will not thereafter call Observer.onNext(T) or Observer.onCompleted().

Parameters:

e - the exception encountered by the Observable

onNext

public void onNext(T args)

Description copied from interface: Observer

Provides the Observer with a new item to observe.

The Observable may call this closure 0 or more times.

The Observable will not call this closure again after it calls either Observer.onCompleted() or Observer.onError(java.lang.Throwable).

Parameters:

args - the item emitted by the Observable

_onError

protected void _onError(java.lang.Throwable e)

The logic for onError without the isFinished check so it can be called from within onCompleted.

See Also:

the report of this bug

getActual

public Subscriber<? super T> getActual()

Returns the Subscriber underlying this SafeSubscriber.

Returns:

the Subscriber that was used to create this SafeSubscriber