MaybeEmitter (RxJava Javadoc 2.2.21)

Type Parameters:

T - the value type to emit
```
public interface MaybeEmitter
```
Abstraction over an RxJava MaybeObserver that allows associating a resource with it.
All methods are safe to call from multiple threads, but note that there is no guarantee whose terminal event will win and get delivered to the downstream.
Calling onSuccess(Object) or onComplete() multiple times has no effect. Calling onError(Throwable) multiple times or after the other two will route the exception into the global error handler via RxJavaPlugins.onError(Throwable).
The emitter allows the registration of a single resource, in the form of a Disposable or Cancellable via setDisposable(Disposable) or setCancellable(Cancellable) respectively. The emitter implementations will dispose/cancel this instance when the downstream cancels the flow or after the event generator logic calls onSuccess(Object), onError(Throwable), onComplete() or when tryOnError(Throwable) succeeds.
Only one Disposable or Cancellable object can be associated with the emitter at a time. Calling either set method will dispose/cancel any previous object. If there is a need for handling multiple resources, one can create a CompositeDisposable and associate that with the emitter instead.
The Cancellable is logically equivalent to Disposable but allows using cleanup logic that can throw a checked exception (such as many close() methods on Java IO components). Since the release of resources happens after the terminal events have been delivered or the sequence gets cancelled, exceptions throw within Cancellable are routed to the global error handler via RxJavaPlugins.onError(Throwable).

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`isDisposed()` Returns true if the downstream disposed the sequence or the emitter was terminated via `onSuccess(Object)`, `onError(Throwable)`, `onComplete()` or a successful `tryOnError(Throwable)`.
`void`	`onComplete()` Signal the completion.
`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 `Cancellable` will be disposed/cancelled.
`void`	`setDisposable(Disposable d)` Sets a Disposable on this emitter; any previous `Disposable` or `Cancellable` will be disposed/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
  - onComplete
```
void onComplete()
```
    Signal the completion.
  - setDisposable
```
void setDisposable(@Nullable
                   Disposable d)
```
    Sets a Disposable on this emitter; any previous Disposable or Cancellable will be disposed/cancelled.
    
    Parameters:
    
    d - the disposable, null is allowed
  - setCancellable
```
void setCancellable(@Nullable
                    Cancellable c)
```
    Sets a Cancellable on this emitter; any previous Disposable or Cancellable will be disposed/cancelled.
    
    Parameters:
    
    c - the cancellable resource, null is allowed
  - isDisposed
```
boolean isDisposed()
```
    Returns true if the downstream disposed the sequence or the emitter was terminated via onSuccess(Object), onError(Throwable), onComplete() or a successful tryOnError(Throwable).
    This method is thread-safe.
    
    Returns:
    
    true if the downstream disposed the sequence or the emitter was terminated
  - 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.
    History: 2.1.1 - experimental
    
    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.2

Interface MaybeEmitter

Method Summary

Method Detail

onSuccess

onError

onComplete

setDisposable

setCancellable

isDisposed

tryOnError