Top Description Fields Constructors Methods
io.reactivex.observers

public abstract Class DefaultObserver<T>

extends Object
implements Observer<T>
Class Inheritance
All Implemented Interfaces
io.reactivex.Observer
Known Direct Subclasses
io.reactivex.internal.operators.observable.BlockingObservableMostRecent.MostRecentObserver
Type Parameters
<T>
the value type
Imports
io.reactivex.Observer, io.reactivex.annotations.NonNull, io.reactivex.disposables.Disposable, io.reactivex.internal.disposables.DisposableHelper, io.reactivex.internal.util.EndConsumerHelper

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 "It is not allowed to subscribe with a(n) <class name> multiple times.".

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

Example


Observable.range(1, 5)
    .subscribe(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!");
        }
    });

Field Summary

Modifier and TypeField and Description
private Disposable

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
protected final 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.

public final void
onSubscribe(Disposable
the Disposable instance whose Disposable#dispose() can be called anytime to cancel the connection
d
)

Implements io.reactivex.Observer.onSubscribe.

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

Field Detail

upstreamback to summary
private Disposable upstream

Constructor Detail

DefaultObserverback to summary
public DefaultObserver()

Method Detail

cancelback to summary
protected final void cancel()

Cancels the upstream's disposable.

onStartback to summary
protected void onStart()

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

onSubscribeback to summary
public final void onSubscribe(Disposable d)

Implements io.reactivex.Observer.onSubscribe.

Doc from io.reactivex.Observer.onSubscribe.

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

Parameters
d:Disposable

the Disposable instance whose Disposable#dispose() can be called anytime to cancel the connection

Annotations
@Override