io.reactivex

Interface SingleEmitter<T>

Type Parameters:

T - the value type to emit

public interface SingleEmitter<T>

Abstraction over an RxJava SingleObserver that allows associating a resource with it.

All methods are safe to call from multiple threads.

Calling onSuccess or onError multiple times has no effect.

Method Summary

Modifier and Type	Method and Description
boolean	isDisposed() Returns true if the downstream cancelled the sequence.
void	onError(Throwable t) Signal an exception.
void	onSuccess(T t) Signal a success value.
void	setCancellable(Cancellable c) Sets a Cancellable on this emitter; any previous Disposable or Cancellation will be unsubscribed/cancelled.
void	setDisposable(Disposable s) Sets a Disposable on this emitter; any previous Disposable or Cancellation will be unsubscribed/cancelled.
boolean	tryOnError(Throwable t) Attempts to emit the specified Throwable error if the downstream hasn't cancelled the sequence or is otherwise terminated, returning false if the emission is not allowed to happen due to lifecycle restrictions.

Method Detail

onSuccess

void onSuccess(@NonNull
               T t)

Signal a success value.

Parameters:

t - the value, not null

onError

void onError(@NonNull
             Throwable t)

Signal an exception.

Parameters:

t - the exception, not null

setDisposable

void setDisposable(@Nullable
                   Disposable s)

Sets a Disposable on this emitter; any previous Disposable or Cancellation will be unsubscribed/cancelled.

Parameters:

s - the disposable, null is allowed

setCancellable

void setCancellable(@Nullable
                    Cancellable c)

Sets a Cancellable on this emitter; any previous Disposable or Cancellation will be unsubscribed/cancelled.

Parameters:

c - the cancellable resource, null is allowed

isDisposed

boolean isDisposed()

Returns true if the downstream cancelled the sequence.

Returns:

true if the downstream cancelled the sequence

tryOnError

boolean tryOnError(@NonNull
                   Throwable t)

Attempts to emit the specified Throwable error if the downstream hasn't cancelled the sequence or is otherwise terminated, returning false if the emission is not allowed to happen due to lifecycle restrictions.

Unlike onError(Throwable), the RxJavaPlugins.onError is not called if the error could not be delivered.

Parameters:

t - the throwable error to signal if possible

Returns:

true if successful, false if the downstream is not able to accept further events

Since:

2.1.1 - experimental