io.reactivex.observable.observers

Class DefaultObserver<T>

java.lang.Object

io.reactivex.observable.observers.DefaultObserver<T>

Type Parameters:

T - the value type

All Implemented Interfaces:

Observer<T>

public abstract class DefaultObserver<T>
extends java.lang.Object
implements Observer<T>

Abstract base implementation of an Observer with support for cancelling a subscription via cancel() (synchronously) and calls onStart() when the subscription happens.

All pre-implemented final methods are thread-safe.

Use the protected cancel() to dispose the sequence from within an onNext implementation.

Like all other consumers, DefaultObserver can be subscribed only once. Any subsequent attempt to subscribe it to a new source will yield an IllegalStateException with message "Disposable already set!".

Implementation of onStart(), Observer.onNext(Object), Observer.onError(Throwable) and Observer.onComplete() are not allowed to throw any unchecked exceptions. If for some reason this can't be avoided, use Observable.safeSubscribe(io.reactivex.observable.Observer) instead of the standard subscribe() method.

Example

 Disposable d =
     Observable.range(1, 5)
     .subscribeWith(new DefaultObserver<Integer>() {
         @Override public void onStart() {
             System.out.println("Start!");
         }
         @Override public void onNext(Integer t) {
             if (t == 3) {
                 cancel();
             }
             System.out.println(t);
         }
         @Override public void onError(Throwable t) {
             t.printStackTrace();
         }
         @Override public void onComplete() {
             System.out.println("Done!");
         }
     });
 // ...
 d.dispose();
 

Constructor Summary

Constructors

Constructor and Description
DefaultObserver()

Method Summary

Modifier and Type	Method and Description
protected void	cancel() Cancels the upstream's disposable.
protected void	onStart() Called once the subscription has been set on this observer; override this to perform initialization.
void	onSubscribe(io.reactivex.common.Disposable s) Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within Observer.onNext(Object)) and asynchronous manner.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.reactivex.observable.Observer

onComplete, onError, onNext

Constructor Detail

DefaultObserver

public DefaultObserver()

Method Detail

onSubscribe

public final void onSubscribe(@NonNull
                              io.reactivex.common.Disposable s)

Description copied from interface: Observer

Provides the Observer with the means of cancelling (disposing) the connection (channel) with the Observable in both synchronous (from within Observer.onNext(Object)) and asynchronous manner.

Specified by:

onSubscribe in interface Observer<T>

Parameters:

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

cancel

protected final void cancel()

Cancels the upstream's disposable.

onStart

protected void onStart()

Called once the subscription has been set on this observer; override this to perform initialization.