CKTIS / Java
`CompletableFuture.thenCombine`: combinare due risultati
`thenCombine` crea un nuovo `CompletableFuture` il cui valore viene calcolato solo quando entrambi gli stadi di ingresso terminano normalmente, per esempio per sommare due contatori indipendenti.
Versione: Java SE 21
Sintassi
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine registra una funzione fn che dipende da due stadi. La chiamata left.thenCombine(right, fn) non avvia i calcoli di ingresso e non si blocca in attesa dei risultati. fn può essere eseguita solo dopo che entrambi gli stadi sono terminati normalmente. Riceve prima il risultato di left e poi quello di right, indipendentemente dall’ordine di completamento.
T è il tipo del risultato di left, mentre U è il tipo del risultato dell’altro stadio; possono essere diversi. right può essere qualsiasi CompletionStage compatibile, non necessariamente un CompletableFuture. Il valore restituito dalla BiFunction diventa il risultato di tipo V del nuovo CompletableFuture<V>. Usa thenCompose quando il primo risultato serve a scegliere o avviare lo stadio successivo.
La variante senza Async non garantisce l’uso di un thread separato. Se entrambi i risultati sono già disponibili, la funzione può essere eseguita prima che thenCombine restituisca il controllo. thenCombineAsync(other, fn) usa il meccanismo di esecuzione asincrona predefinito, mentre thenCombineAsync(other, fn, executor) usa l’Executor fornito.
Se uno stadio di ingresso termina con un’eccezione, anche per annullamento, fn non viene invocata. In OpenJDK 21, thenCombine attende che entrambi gli stadi di ingresso siano terminati prima di completare lo stadio dipendente con un’eccezione. Se l’altro stadio non termina mai, lo stadio dipendente può rimanere in sospeso a tempo indeterminato. Se falliscono entrambi, la causa segnalata può provenire dall’uno o dall’altro. Anche un’eccezione lanciata da fn fa fallire lo stadio dipendente; se si tenta di leggerne il risultato, join() lancia una CompletionException.
Esempi
import java.util.concurrent.CompletableFuture;
public class CombineCounters {
public static void main(String[] args) {
var leftCount = new CompletableFuture<Integer>();
var rightCount = new CompletableFuture<Integer>();
CompletableFuture<Integer> total =
leftCount.thenCombine(rightCount, Integer::sum);
rightCount.complete(24);
System.out.println(total.isDone());
leftCount.complete(18);
System.out.println(total.join());
}
}Risultato
false 42
`rightCount` termina per primo, ma `total.isDone()` restituisce ancora `false`. Solo dopo il completamento di `leftCount`, `Integer::sum` riceve `18` e `24` e `total.join()` restituisce `42`.
Lezioni correlate
- Java · Lezione 51 · Intermedio · Versione: 2