Package io.smallrye.mutiny.groups

Class UniOnNotNull<T>

  • public class UniOnNotNull<T>
extends java.lang.Object

    • Constructor Summary

      Constructors 
      Constructor Description
      UniOnNotNull​(Uni<T> upstream)  

    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      <R> Uni<R> apply​(java.util.function.Function<? super T,​? extends R> mapper)
      Deprecated.
      use transform(Function)
      Uni<T> call​(java.util.function.Function<? super T,​Uni<?>> action)
      Produces a new Uni invoking the given @{code action} when the item event is received.
      Uni<T> call​(java.util.function.Supplier<Uni<?>> action)
      Produces a new Uni invoking the given @{code action} when the item event is received.
      Uni<T> invoke​(java.lang.Runnable callback)
      Produces a new Uni invoking the given callback when the item event is fired.
      Uni<T> invoke​(java.util.function.Consumer<? super T> callback)
      Produces a new Uni invoking the given callback when the item event is fired.
      Uni<T> invokeUni​(java.util.function.Function<? super T,​Uni<?>> action)
      Deprecated.
      Use call(Function)
      <R> Uni<R> produceCompletionStage​(java.util.function.Function<? super T,​? extends java.util.concurrent.CompletionStage<? extends R>> mapper)
      Deprecated.
      Use transformToUni(Function) and produce the Uni using Uni.createFrom().completionStage(...)
      <R> Multi<R> produceMulti​(java.util.function.Function<? super T,​? extends org.reactivestreams.Publisher<? extends R>> mapper)
      Deprecated.
      Use transformToMulti(Function) instead
      <R> Uni<R> produceUni​(java.util.function.BiConsumer<? super T,​UniEmitter<? super R>> consumer)
      Deprecated.
      Use transformToUni(BiConsumer) instead.
      <R> Uni<R> produceUni​(java.util.function.Function<? super T,​Uni<? extends R>> mapper)
      Deprecated.
      Use transformToUni(Function) instead
      <R> Uni<R> transform​(java.util.function.Function<? super T,​? extends R> mapper)
      Produces a new Uni invoking the given function when the current Uni fires the item event.
      <R> Multi<R> transformToMulti​(java.util.function.Function<? super T,​? extends org.reactivestreams.Publisher<? extends R>> mapper)
      When this Uni produces its item (not null), call the given mapper to produce a Publisher.
      <R> Uni<R> transformToUni​(java.util.function.BiConsumer<? super T,​UniEmitter<? super R>> consumer)
      Transforms the received item asynchronously, forwarding the events emitted an UniEmitter consumes by the given consumer.
      <R> Uni<R> transformToUni​(java.util.function.Function<? super T,​Uni<? extends R>> mapper)
      Transforms the received item asynchronously, forwarding the events emitted by another Uni produced by the given mapper.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • UniOnNotNull

        public UniOnNotNull​(Uni<T> upstream)

    • Method Detail

      • invoke

        public Uni<T> invoke​(java.util.function.Consumer<? super T> callback)
        Produces a new Uni invoking the given callback when the item event is fired. If the item is null, the callback is not invoked.
        Parameters:
        callback - the callback, must not be null
        Returns:
        the new Uni

      • invoke

        public Uni<T> invoke​(java.lang.Runnable callback)
        Produces a new Uni invoking the given callback when the item event is fired. If the item is null, the callback is not invoked.
        Parameters:
        callback - the callback, must not be null
        Returns:
        the new Uni

      • invokeUni

        @Deprecated
public Uni<T> invokeUni​(java.util.function.Function<? super T,​Uni<?>> action)
        Deprecated.
        Use call(Function)
        Produces a new Uni invoking the given @{code action} when the item event is received. Note that if the received item is null, the action is not executed, and the item is propagated downstream.

        Unlike invoke(Consumer), the passed function returns a Uni. When the produced Uni sends its result, the result is discarded, and the original (non null) item is forwarded downstream. If the produced Uni fails, the failure is propagated downstream.

        Parameters:
        action - the callback, must not be null
        Returns:
        the new Uni

      • call

        public Uni<T> call​(java.util.function.Function<? super T,​Uni<?>> action)
        Produces a new Uni invoking the given @{code action} when the item event is received. Note that if the received item is null, the action is not executed, and the item is propagated downstream.

        Unlike invoke(Consumer), the passed function returns a Uni. When the produced Uni sends its result, the result is discarded, and the original (non null) item is forwarded downstream. If the produced Uni fails, the failure is propagated downstream.

        Parameters:
        action - the callback, must not be null
        Returns:
        the new Uni

      • call

        public Uni<T> call​(java.util.function.Supplier<Uni<?>> action)
        Produces a new Uni invoking the given @{code action} when the item event is received. Note that if the received item is null, the action is not executed.

        Unlike invoke(Consumer), the passed function returns a Uni. When the produced Uni sends its result, the result is discarded, and the original (non null) item is forwarded downstream. If the produced Uni fails, the failure is propagated downstream.

        Parameters:
        action - the callback, must not be null and must not return null
        Returns:
        the new Uni

      • apply

        @Deprecated
public <R> Uni<R> apply​(java.util.function.Function<? super T,​? extends R> mapper)
        Deprecated.
        use transform(Function)
        Produces a new Uni invoking the given function when the current Uni fires the item event. The function receives the (non-null) item as parameter, and can transform it. The returned object is sent downstream as item.

        If the item is `null`, the mapper is not called and it produces a null item.

        For asynchronous composition, see transformToUni(Function).

        Type Parameters:
        R - the type of Uni item
        Parameters:
        mapper - the mapper function, must not be null
        Returns:
        the new Uni

      • transform

        public <R> Uni<R> transform​(java.util.function.Function<? super T,​? extends R> mapper)
        Produces a new Uni invoking the given function when the current Uni fires the item event. The function receives the (non-null) item as parameter, and can transform it. The returned object is sent downstream as item.

        If the item is `null`, the mapper is not called and it produces a null item.

        For asynchronous composition, see transformToUni(Function).

        Type Parameters:
        R - the type of Uni item
        Parameters:
        mapper - the mapper function, must not be null
        Returns:
        the new Uni

      • produceUni

        @Deprecated
public <R> Uni<R> produceUni​(java.util.function.Function<? super T,​Uni<? extends R>> mapper)
        Deprecated.
        Use transformToUni(Function) instead
        Transforms the received item asynchronously, forwarding the events emitted by another Uni produced by the given mapper.

        The mapper is called with the item event of the current Uni and produces an Uni, possibly using another type of item (R). The events fired by produced Uni are forwarded to the Uni returned by this method.

        If the item is null, the mapper is not called, and null is propagated downstream.

        This operation is generally named flatMap.

        Type Parameters:
        R - the type of item
        Parameters:
        mapper - the function called with the item of this Uni and producing the Uni, must not be null, must not return null.
        Returns:
        a new Uni that would fire events from the uni produced by the mapper function, possibly in an asynchronous manner.

      • transformToUni

        public <R> Uni<R> transformToUni​(java.util.function.Function<? super T,​Uni<? extends R>> mapper)
        Transforms the received item asynchronously, forwarding the events emitted by another Uni produced by the given mapper.

        The mapper is called with the item event of the current Uni and produces an Uni, possibly using another type of item (R). The events fired by produced Uni are forwarded to the Uni returned by this method.

        If the item is null, the mapper is not called, and null is propagated downstream.

        This operation is generally named flatMap.

        Type Parameters:
        R - the type of item
        Parameters:
        mapper - the function called with the item of this Uni and producing the Uni, must not be null, must not return null.
        Returns:
        a new Uni that would fire events from the uni produced by the mapper function, possibly in an asynchronous manner.

      • transformToMulti

        public <R> Multi<R> transformToMulti​(java.util.function.Function<? super T,​? extends org.reactivestreams.Publisher<? extends R>> mapper)
        When this Uni produces its item (not null), call the given mapper to produce a Publisher. Continue the pipeline with this publisher (as a Multi).

        The mapper is called with the item event of the current Uni and produces a Publisher, possibly using another type of item (R). Events fired by the produced Publisher are forwarded to the Multi returned by this method.

        If the item is `null`, the mapper is not called and an empty Multi is produced.

        This operation is generally named flatMapPublisher.

        Type Parameters:
        R - the type of item produced by the resulting Multi
        Parameters:
        mapper - the mapper, must not be null, may expect to receive null as item.
        Returns:
        the multi

      • produceMulti

        @Deprecated
public <R> Multi<R> produceMulti​(java.util.function.Function<? super T,​? extends org.reactivestreams.Publisher<? extends R>> mapper)
        Deprecated.
        Use transformToMulti(Function) instead
        When this Uni produces its item (not null), call the given mapper to produce a Publisher. Continue the pipeline with this publisher (as a Multi).

        The mapper is called with the item event of the current Uni and produces a Publisher, possibly using another type of item (R). Events fired by the produced Publisher are forwarded to the Multi returned by this method.

        If the item is `null`, the mapper is not called and an empty Multi is produced.

        This operation is generally named flatMapPublisher.

        Type Parameters:
        R - the type of item produced by the resulting Multi
        Parameters:
        mapper - the mapper, must not be null, may expect to receive null as item.
        Returns:
        the multi

      • produceCompletionStage

        @Deprecated
public <R> Uni<R> produceCompletionStage​(java.util.function.Function<? super T,​? extends java.util.concurrent.CompletionStage<? extends R>> mapper)
        Deprecated.
        Use transformToUni(Function) and produce the Uni using Uni.createFrom().completionStage(...)
        Transforms the received item asynchronously, forwarding the events emitted by another CompletionStage produced by the given mapper.

        The mapper is called with the item event of the current Uni and produces an CompletionStage, possibly using another type of item (R). The events fired by produced CompletionStage are forwarded to the Uni returned by this method.

        If the incoming item is null, the mapper is not called, and a CompletionStage redeeming null is returned.

        Type Parameters:
        R - the type of item
        Parameters:
        mapper - the function called with the item of this Uni and producing the CompletionStage, must not be null, must not return null.
        Returns:
        a new Uni that would fire events from the uni produced by the mapper function, possibly in an asynchronous manner.

      • transformToUni

        public <R> Uni<R> transformToUni​(java.util.function.BiConsumer<? super T,​UniEmitter<? super R>> consumer)
        Transforms the received item asynchronously, forwarding the events emitted an UniEmitter consumes by the given consumer.

        The consumer is called with the item event of the current Uni and an emitter uses to fire events. These events are these propagated by the produced Uni.

        If the incoming item is null, the consumer is not called and a null item is propagated downstream.

        Type Parameters:
        R - the type of item emitted by the emitter
        Parameters:
        consumer - the function called with the item of the this Uni and an UniEmitter. It must not be null.
        Returns:
        a new Uni that would fire events from the emitter consumed by the mapper function, possibly in an asynchronous manner.

      • produceUni

        @Deprecated
public <R> Uni<R> produceUni​(java.util.function.BiConsumer<? super T,​UniEmitter<? super R>> consumer)
        Deprecated.
        Use transformToUni(BiConsumer) instead.
        Transforms the received item asynchronously, forwarding the events emitted an UniEmitter consumes by the given consumer.

        The consumer is called with the item event of the current Uni and an emitter uses to fire events. These events are these propagated by the produced Uni.

        If the incoming item is null, the consumer is not called and a null item is propagated downstream.

        Type Parameters:
        R - the type of item emitted by the emitter
        Parameters:
        consumer - the function called with the item of the this Uni and an UniEmitter. It must not be null.
        Returns:
        a new Uni that would fire events from the emitter consumed by the mapper function, possibly in an asynchronous manner.