io.reactivex.observable

Interface SingleObserver<T>

Type Parameters:

T - the type of item the SingleObserver expects to observe

All Known Implementing Classes:

DisposableSingleObserver, ResourceSingleObserver, SingleSubject, TestObserver

public interface SingleObserver<T>

Provides a mechanism for receiving push-based notifications.

After a SingleObserver calls a Single's subscribe method, first the Single calls onSubscribe(Disposable) with a Disposable that allows cancelling the sequence at any time, then the Single calls only one of the SingleObserver onSuccess(T) and onError(java.lang.Throwable) methods to provide notifications.

Since:

2.0

See Also:

ReactiveX documentation: Observable

Method Summary

Modifier and Type	Method and Description
void	onError(java.lang.Throwable e) Notifies the SingleObserver that the Single has experienced an error condition.
void	onSubscribe(io.reactivex.common.Disposable d) Provides the SingleObserver with the means of cancelling (disposing) the connection (channel) with the Single in both synchronous (from within onSubscribe(Disposable) itself) and asynchronous manner.
void	onSuccess(T t) Notifies the SingleObserver with a single item and that the Single has finished sending push-based notifications.

Method Detail

onSubscribe

void onSubscribe(@NonNull
                 io.reactivex.common.Disposable d)

Provides the SingleObserver with the means of cancelling (disposing) the connection (channel) with the Single in both synchronous (from within onSubscribe(Disposable) itself) and asynchronous manner.

Parameters:

d - the Disposable instance whose Disposable.dispose() can be called anytime to cancel the connection

Since:

2.0

onSuccess

void onSuccess(@NonNull
               T t)

Notifies the SingleObserver with a single item and that the Single has finished sending push-based notifications.

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

Parameters:

t - the item emitted by the Single

onError

void onError(@NonNull
             java.lang.Throwable e)

Notifies the SingleObserver that the Single has experienced an error condition.

If the Single calls this method, it will not thereafter call onSuccess(T).

Parameters:

e - the exception encountered by the Single