public abstract class

DisposableSingleObserver

extends Object
implements SingleObserver<T> Disposable
java.lang.Object
   ↳ io.reactivex.observers.DisposableSingleObserver<T>

Class Overview

An abstract SingleObserver that allows asynchronous cancellation by implementing Disposable.

All pre-implemented final methods are thread-safe.

Like all other consumers, DisposableSingleObserver can be subscribed only once. Any subsequent attempt to subscribe it to a new source will yield an IllegalStateException with message "It is not allowed to subscribe with a(n) <class name> multiple times.".

Implementation of onStart(), onSuccess(Object) and onError(Throwable) are not allowed to throw any unchecked exceptions.

Example


 Disposable d =
     Single.just(1).delay(1, TimeUnit.SECONDS)
     .subscribeWith(new DisposableSingleObserver<Integer>() {
         @Override public void onStart() {
             System.out.println("Start!");
         }
         @Override public void onSuccess(Integer t) {
             System.out.println(t);
         }
         @Override public void onError(Throwable t) {
             t.printStackTrace();
         }
     });
 // ...
 d.dispose();
 

Summary

Public Constructors
DisposableSingleObserver()
Public Methods
final void dispose()
Dispose the resource, the operation should be idempotent.
final boolean isDisposed()
Returns true if this resource has been disposed.
final void onSubscribe(Disposable s)
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.
Protected Methods
void onStart()
Called once the single upstream Disposable is set via onSubscribe.
[Expand]
Inherited Methods
From class java.lang.Object
From interface io.reactivex.SingleObserver
From interface io.reactivex.disposables.Disposable

Public Constructors

public DisposableSingleObserver ()

Public Methods

public final void dispose ()

Dispose the resource, the operation should be idempotent.

public final boolean isDisposed ()

Returns true if this resource has been disposed.

Returns
  • true if this resource has been disposed

public final void onSubscribe (Disposable s)

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
s the Disposable instance whose dispose() can be called anytime to cancel the connection

Protected Methods

protected void onStart ()

Called once the single upstream Disposable is set via onSubscribe.