Package io.smallrye.mutiny.groups

Class UniJoin

java.lang.Object

io.smallrye.mutiny.groups.UniJoin

@Experimental("New API based on observations that Uni.combine() is often used with homogeneous types, and combination often just a mapping to a collection.")
public class UniJoin
extends java.lang.Object

Join multiple Unis.

Note about emptiness: If the set of Unis is empty, the set is rejected. Joining an empty set would not propagate any event as it would not subscribe to anything. As a result, you cannot join empty sets of Unis. An IllegalArgumentException will be thrown in this case.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	UniJoin.Builder<T>	Builder to assemble Uni references to be joined.
static class	UniJoin.JoinAllStrategy<T>	Defines how to deal with failures while joining Uni references with all(List).
static class	UniJoin.JoinFirstStrategy<T>	Defines how to deal with failures while joining Uni references with first(List)}.

Field Summary

Fields

Modifier and Type	Field	Description
static UniJoin	SHARED_INSTANCE

Method Summary

Modifier and Type	Method	Description
<T> UniJoin.JoinAllStrategy<T>	all(Uni<T>... unis)	Join multiple Uni references and emit a list of values, this is a convenience delegate method for all(List).
<T> UniJoin.JoinAllStrategy<T>	all(java.util.List<Uni<T>> unis)	Join multiple Uni references and emit a list of values.
<T> UniJoin.Builder<T>	builder()	Provide a builder to assemble the Uni references to join.
<T> UniJoin.JoinFirstStrategy<T>	first(Uni<T>... unis)	Join multiple Uni and emit the result from the first one to emit a signal, or the first one with a value.
<T> UniJoin.JoinFirstStrategy<T>	first(java.util.List<Uni<T>> unis)	Join multiple Uni and emit the result from the first one to emit a signal, or the first one with a value.

Methods inherited from class java.lang.Object

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

Field Detail

SHARED_INSTANCE

public static final UniJoin SHARED_INSTANCE

Method Detail

all

@SafeVarargs
@CheckReturnValue
public final <T> UniJoin.JoinAllStrategy<T> all(Uni<T>... unis)

Join multiple Uni references and emit a list of values, this is a convenience delegate method for all(List).

The list of Unis must not be null, empty, or contain null objects.

Type Parameters:

T - the type of the Uni values

Parameters:

unis - the list of Uni to join, must not be null or empty, must not contain any null reference.

Returns:

the object to configure the failure management strategy

all

@CheckReturnValue
public final <T> UniJoin.JoinAllStrategy<T> all(java.util.List<Uni<T>> unis)

Join multiple Uni references and emit a list of values.

The resulting list of values is in order of the list of Uni. What happens when any of the Uni emits a failure rather than a value is specified by a subsequent call to any of the methods in UniJoin.JoinAllStrategy.

The list of Unis must not be null, empty, or contain null objects.

Type Parameters:

T - the type of the Uni values

Parameters:

unis - the list of Uni to join, must not be null, must not contain any null reference

Returns:

the object to configure the failure management strategy

first

@SafeVarargs
@CheckReturnValue
public final <T> UniJoin.JoinFirstStrategy<T> first(Uni<T>... unis)

Join multiple Uni and emit the result from the first one to emit a signal, or the first one with a value. This is a convenience delegate method for first(List).

The list of Unis must not be null, empty, or contain null objects.

Type Parameters:

T - the type of the Uni values

Parameters:

unis - the list of Uni to join, must not be null, empty and must not contain any null reference

Returns:

the object to configure the failure management strategy

first

@CheckReturnValue
public final <T> UniJoin.JoinFirstStrategy<T> first(java.util.List<Uni<T>> unis)

Join multiple Uni and emit the result from the first one to emit a signal, or the first one with a value.

What happens when any of the Uni emits a failure rather than a value is specified by a subsequent call to any of the methods in UniJoin.JoinFirstStrategy.

The list of Unis must not be null, empty, or contain null objects.

Type Parameters:

T - the type of the Uni values

Parameters:

unis - the list of Uni to join, must not be null, empty, must not contain any null reference

Returns:

the object to configure the failure management strategy

builder

@CheckReturnValue
public <T> UniJoin.Builder<T> builder()

Provide a builder to assemble the Uni references to join.

Type Parameters:

T - the type of the Uni values

Returns:

a new builder