Multi (SmallRye Mutiny 0.4.4 API)

All Superinterfaces:

org.reactivestreams.Publisher<T>

All Known Subinterfaces:

GroupedMulti<K,T>

All Known Implementing Classes:

AbstractMulti, AbstractMultiOperator, BroadcastProcessor, CollectionBasedMulti, ConnectableMulti, DeferredMulti, EmitterBasedMulti, EmptyMulti, FailedMulti, IntervalMulti, IterableBasedMulti, MultiBufferOp, MultiBufferWithTimeoutOp, MultiCacheOp, MultiCollectorOp, MultiCombineLatestOp, MultiConcatOp, MultiConnectAfter, MultiDistinctOp, MultiDistinctUntilChangedOp, MultiEmitOnOp, MultiFilterOp, MultiFlatMapOnFailure, MultiFlatMapOp, MultiGroupByOp, MultiIgnoreOp, MultiLastItemOp, MultiMapOnFailure, MultiMapOp, MultiOnFailureResumeOp, MultiOnOverflowBufferOp, MultiOnOverflowDropItemsOp, MultiOnOverflowKeepLastOp, MultiOperator, MultiPublishOp, MultiReferenceCount, MultiRepeatOp, MultiRetryOp, MultiRetryWhenOp, MultiScanOp, MultiScanWithSeedOp, MultiSignalConsumerOp, MultiSkipLastOp, MultiSkipOp, MultiSkipUntilOp, MultiSkipUntilPublisherOp, MultiSubscribeOnOp, MultiSwitchOnCompletion, MultiSwitchOnEmpty, MultiSwitchOnEmptyOp, MultiTakeLastOp, MultiTakeOp, MultiTakeUntilOtherOp, MultiTakeWhileOp, MultiWindowOnDurationOp, MultiWindowOp, MultiZipOp, NeverMulti, ResourceMulti, StreamBasedMulti, UnicastProcessor, UniProduceMultiOnItem
```
public interface Multi<T>
extends org.reactivestreams.Publisher<T>
```

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`MultiBroadcast<T>`	`broadcast()` Makes this `Multi` be able to broadcast its events (`items`, `failure`, and `completion`) to multiple subscribers.
`Multi<T>`	`cache()` Creates a new `Multi` that subscribes to this upstream and caches all of its events and replays them, to all the downstream subscribers.
`MultiCollect<T>`	`collectItems()` Produces `Multi` or `Uni` collecting items from this `Multi`.
`default <O> Multi<O>`	`concatMap(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)` Produces a `Multi` containing the items from `Publisher` produced by the `mapper` for each item emitted by this `Multi`.
`MultiConvert<T>`	`convert()` Converts a `Multi` to other types
`static MultiCreateBy`	`createBy()` Creates new instances of `Multi` by merging, concatenating or associating items from others `Multi` and `Publisher`.
`static MultiCreate`	`createFrom()`
`Multi<T>`	`emitOn(Executor executor)` Produces a new `Multi` invoking the `onItem`, `onFailure` and `onCompletion` methods on the supplied `Executor`.
`default <O> Multi<O>`	`flatMap(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)` Produces a `Multi` containing the items from `Publisher` produced by the `mapper` for each item emitted by this `Multi`.
`MultiGroup<T>`	`groupItems()` Produces `Multi` grouping items from this `Multi` into various "form of chunks" (list, `Multi`).
`default <O> Multi<O>`	`map(Function<? super T,? extends O> mapper)` Produces a new `Multi` invoking the given function for each item emitted by the upstream `Multi`.
`MultiOnEvent<T>`	`on()` Allows adding behavior when various type of events are emitted by the current `Multi` (item, failure, completion) or by the subscriber (cancellation, request, subscription)
`MultiOnCompletion<T>`	`onCompletion()` Allows configures the actions or continuation to execute when this `Multi` fires the completion event.
`MultiOnFailure<T>`	`onFailure()` Like `onFailure(Predicate)` but applied to all failures fired by the upstream multi.
`MultiOnFailure<T>`	`onFailure(Class<? extends Throwable> typeOfFailure)` Configures a type of failure filtering the failures on which the behavior (specified with the returned `MultiOnFailure`) is applied.
`MultiOnFailure<T>`	`onFailure(Predicate<? super Throwable> predicate)` Configures a predicate filtering the failures on which the behavior (specified with the returned `MultiOnFailure`) is applied.
`MultiOnItem<T>`	`onItem()` Configures the behavior when an `item` event is received from the this `Multi`
`MultiOverflow<T>`	`onOverflow()` Configures the back-pressure behavior when the consumer cannot keep up with the emissions from this `Multi`.
`MultiSubscribe<T>`	`subscribe()` Configures the subscriber consuming this `Multi`.
`Multi<T>`	`subscribeOn(Executor executor)` When a subscriber subscribes to this `Multi`, execute the subscription to the upstream `Multi` on a thread from the given executor.
`default <O> O`	`then(Function<Multi<T>,O> stage)` Allows structuring the pipeline by creating a logic separation:
`Uni<T>`	`toUni()` Creates a `Uni` from this `Multi`.
`MultiTransform<T>`	`transform()` Transforms the streams by skipping, selecting, or merging.

Methods inherited from interface org.reactivestreams.Publisher
subscribe

- Method Detail
  - createFrom
```
static MultiCreate createFrom()
```
  - createBy
```
static MultiCreateBy createBy()
```
    Creates new instances of Multi by merging, concatenating or associating items from others Multi and Publisher.
    
    Returns:
    
    the object to configure the creation process.
  - subscribe
```
MultiSubscribe<T> subscribe()
```
    Configures the subscriber consuming this Multi.
    
    Returns:
    
    the object to configure the subscriber
  - onItem
```
MultiOnItem<T> onItem()
```
    Configures the behavior when an item event is received from the this Multi
    
    Returns:
    
    the object to configure the behavior.
  - then
```
default <O> O then(Function<Multi<T>,O> stage)
```
    Allows structuring the pipeline by creating a logic separation:
```
 
     Multi multi = upstream
      .then(m -> { ...})
      .then(m -> { ...})
      .then(m -> { ...})
 
 
```
    With `then` you can structure and chain groups of processing.
    Type Parameters:
    
    O - the outcome type
    
    Parameters:
    
    stage - the function receiving this Multi as parameter and producing the outcome (can be a Multi or something else), must not be null.
    
    Returns:
    
    the outcome of the function.
  - toUni
```
Uni<T> toUni()
```
    Creates a Uni from this Multi.
    When a subscriber subscribes to the returned Uni, it subscribes to this Multi and requests one item. The event emitted by this Multi are then forwarded to the Uni:
    - on item event, the item is fired by the produced Uni
    - on failure event, the failure is fired by the produced Uni
    - on completion event, a null item is fired by the produces Uni
    - any item or failure events received after the first event is dropped
    If the subscription on the produced Uni is cancelled, the subscription to the passed Multi is also cancelled.
    Returns:
    
    the produced Uni
  - onFailure
```
MultiOnFailure<T> onFailure()
```
    Like onFailure(Predicate) but applied to all failures fired by the upstream multi. It allows configuring the on failure behavior (recovery, retry...).
    
    Returns:
    
    a MultiOnFailure on which you can specify the on failure action
  - onFailure
```
MultiOnFailure<T> onFailure(Predicate<? super Throwable> predicate)
```
    Configures a predicate filtering the failures on which the behavior (specified with the returned MultiOnFailure) is applied.
    For instance, to only when an IOException is fired as failure you can use: multi.onFailure(IOException.class).recoverWithItem("hello")
    The fallback value (hello) will only be used if the upstream multi fires a failure of type IOException.
    
    Parameters:
    
    predicate - the predicate, null means applied to all failures
    
    Returns:
    
    a MultiOnFailure configured with the given predicate on which you can specify the on failure action
  - onFailure
```
MultiOnFailure<T> onFailure(Class<? extends Throwable> typeOfFailure)
```
    Configures a type of failure filtering the failures on which the behavior (specified with the returned MultiOnFailure) is applied.
    For instance, to only when an IOException is fired as failure you can use: multi.onFailure(IOException.class).recoverWithItem("hello")
    The fallback value (hello) will only be used if the upstream multi fire a failure of type IOException.*
    
    Parameters:
    
    typeOfFailure - the class of exception, must not be null
    
    Returns:
    
    a MultiOnFailure configured with the given predicate on which you can specify the on failure action
  - on
```
MultiOnEvent<T> on()
```
    Allows adding behavior when various type of events are emitted by the current Multi (item, failure, completion) or by the subscriber (cancellation, request, subscription)
    
    Returns:
    
    the object to configure the action to execute when events happen
  - cache
```
Multi<T> cache()
```
    Creates a new Multi that subscribes to this upstream and caches all of its events and replays them, to all the downstream subscribers.
    
    Returns:
    
    a multi replaying the events from the upstream.
  - collectItems
```
MultiCollect<T> collectItems()
```
    Produces Multi or Uni collecting items from this Multi. You can accumulate the items into a List (MultiCollect.asList()), Map (MultiCollect.asMap(Function)...
    You can also retrieve the first and list items using MultiCollect.first() and MultiCollect.last().
    
    Returns:
    
    the object to configure the collection process.
  - groupItems
```
MultiGroup<T> groupItems()
```
    Produces Multi grouping items from this Multi into various "form of chunks" (list, Multi). The grouping can be done linearly (MultiGroup.intoLists() and MultiGroup.intoMultis(), or based on a grouping function (MultiGroup.by(Function))
    
    Returns:
    
    the object to configure the grouping.
  - emitOn
```
Multi<T> emitOn(Executor executor)
```
    Produces a new Multi invoking the onItem, onFailure and onCompletion methods on the supplied Executor.
    Instead of receiving the item event on the thread firing the event, this method influences the threading context to switch to a thread from the given executor. Same behavior for failure and completion.
    Note that the subscriber is guaranteed to never be called concurrently.
    
    Parameters:
    
    executor - the executor to use, must not be null
    
    Returns:
    
    a new Multi
  - subscribeOn
```
Multi<T> subscribeOn(Executor executor)
```
    When a subscriber subscribes to this Multi, execute the subscription to the upstream Multi on a thread from the given executor. As a result, the Subscriber.onSubscribe(Subscription) method will be called on this thread (except mentioned otherwise)
    
    Parameters:
    
    executor - the executor to use, must not be null
    
    Returns:
    
    a new Multi
  - onCompletion
```
MultiOnCompletion<T> onCompletion()
```
    Allows configures the actions or continuation to execute when this Multi fires the completion event.
    
    Returns:
    
    the object to configure the action.
  - transform
```
MultiTransform<T> transform()
```
    Transforms the streams by skipping, selecting, or merging.
    
    Returns:
    
    the object to configure the transformation.
  - onOverflow
```
MultiOverflow<T> onOverflow()
```
    Configures the back-pressure behavior when the consumer cannot keep up with the emissions from this Multi.
    
    Returns:
    
    the object to configure the overflow strategy
  - broadcast
```
MultiBroadcast<T> broadcast()
```
    Makes this Multi be able to broadcast its events (items, failure, and completion) to multiple subscribers.
    
    Returns:
    
    the object to configure the broadcast
  - convert
```
MultiConvert<T> convert()
```
    Converts a Multi to other types
    Examples:
```
 
 multi.convert().with(multi -> x); // Convert with a custom lambda converter
 
 
```
    Returns:
    
    the object to convert an Multi instance
    
    See Also:
    
    MultiConvert
  - map
```
default <O> Multi<O> map(Function<? super T,? extends O> mapper)
```
    Produces a new Multi invoking the given function for each item emitted by the upstream Multi.
    The function receives the received item as parameter, and can transform it. The returned object is sent downstream as item event.
    This method is a shortcut for multi.onItem().apply(mapper).
    
    Type Parameters:
    
    O - the type of item produced by the mapper function
    
    Parameters:
    
    mapper - the mapper function, must not be null
    
    Returns:
    
    the new Multi
  - flatMap
```
default <O> Multi<O> flatMap(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)
```
    Produces a Multi containing the items from Publisher produced by the mapper for each item emitted by this Multi.
    The operation behaves as follows:
    - for each item emitted by this Multi, the mapper is called and produces a Publisher (potentially a Multi). The mapper must not return null
    - The items emitted by each of the produced Publisher are then merged in the produced Multi. The flatten process may interleaved items.
    This method is a shortcut for multi.onItem().producePublisher(mapper).merge().
    Type Parameters:
    
    O - the type of item emitted by the Publisher produced by the mapper
    
    Parameters:
    
    mapper - the Function producing Publisher / Multi for each items emitted by the upstream Multi
    
    Returns:
    
    the produced Multi
  - concatMap
```
default <O> Multi<O> concatMap(Function<? super T,? extends org.reactivestreams.Publisher<? extends O>> mapper)
```
    Produces a Multi containing the items from Publisher produced by the mapper for each item emitted by this Multi.
    The operation behaves as follows:
    - for each item emitted by this Multi, the mapper is called and produces a Publisher (potentially a Multi). The mapper must not return null
    - The items emitted by each of the produced Publisher are then concatenated in the produced Multi. The flatten process makes sure that the items are not interleaved.
    This method is equivalent to multi.onItem().producePublisher(mapper).concatenate().
    Type Parameters:
    
    O - the type of item emitted by the Publisher produced by the mapper
    
    Parameters:
    
    mapper - the Function producing Publisher / Multi for each items emitted by the upstream Multi
    
    Returns:
    
    the produced Multi

Interface Multi<T>

Method Summary

Methods inherited from interface org.reactivestreams.Publisher

Method Detail

createFrom

createBy

subscribe

onItem

then

toUni

onFailure

onFailure

onFailure

on

cache

collectItems

groupItems

emitOn

subscribeOn

onCompletion

transform

onOverflow

broadcast

convert

map

flatMap

concatMap