Package org.eclipse.microprofile.reactive.streams.operators.spi

Interface Stage.OnErrorResumeWith

All Superinterfaces:
Stage
Enclosing interface:
Stage
public static interface Stage.OnErrorResumeWith extends Stage
A stage to handle errors from upstream. It builds a stream containing all the elements from upstream. Additionally, in the case of failure, rather than propagating the error downstream, it invokes the given function and switches control to the returned stream.

By default, when a stream encounters an error that prevents it from emitting the expected item to its subscriber, the stream (publisher) invokes its subscriber's onError method, and then terminates without invoking any more of its subscriber's methods. This operator changes this behavior. If the current stream encounters an error, instead of invoking its subscriber's onError method, it will instead relinquish control to the PublisherBuilder returned from given function. In such a case, because no publisher necessarily invokes onError, the subscriber may never know that an error happened.

Any elements emitted by the returned publisher must be sent downstream, in addition to its completion and error signals. If the returned publisher completes with an error, that error must not result in the recovery function on this stage being invoked again.

Any RuntimeException thrown by the function must be propagated downstream as an error, replacing the exception that the function was handling.

  • Method Details