CKTIS / Java
CompletableFuture — comporre calcoli asincroni
CompletableFuture<T> rappresenta un risultato futuro e permette di collegare fasi dipendenti senza bloccare dopo ogni passaggio. Scopri trasformazioni, composizione, combinazione dei risultati, recupero dagli errori e timeout in Java SE 21.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
CompletableFuture<T> future = CompletableFuture.supplyAsync(supplier, executor);
CompletableFuture<U> mapped = future.thenApply(mapper);
CompletableFuture<U> composed = future.thenCompose(asyncMapper);
T result = future.join();CompletableFuture<T> combina un risultato Future<T> con fasi CompletionStage<T>. CompletableFuture.supplyAsync invia un calcolo per l’esecuzione; CompletableFuture.completedFuture crea un risultato già completato. CompletableFuture.completeExceptionally completa con un errore un future ancora incompleto. Ambito: Java SE 21; ambiente di esecuzione del repository, ambiente di produzione non attestato.
CompletableFuture.thenApply trasforma un risultato completato correttamente; non garantisce un thread separato. CompletableFuture.thenApplyAsync invia la funzione a un executor perché la esegua. Per impostazione predefinita viene usato ForkJoinPool.commonPool(); se il parallelismo è inferiore a due, viene creato un thread per ogni attività. È possibile fornire esplicitamente un executor. CompletableFuture.thenCompose appiattisce una funzione che restituisce un’altra fase, invece di creare un risultato annidato. CompletableFuture.thenCombine combina i valori dopo che entrambe le fasi sono state completate correttamente.
CompletableFuture.exceptionally calcola un valore sostitutivo solo in caso di errore. CompletableFuture.allOf attende tutte le fasi, restituisce CompletableFuture<Void> e propaga l’errore se una fase fallisce; non raccoglie i valori. CompletableFuture.anyOf restituisce CompletableFuture<Object> con il risultato o l’errore di una delle fasi completate, che non è necessariamente un successo. Non annulla le attività rimanenti.
CompletableFuture.join e CompletableFuture.get bloccano fino al completamento. Di norma, l’errore viene racchiuso in CompletionException, non verificata, oppure in ExecutionException, verificata; get può anche lanciare InterruptedException. La cancellazione lancia CancellationException. Evita di bloccare all’interno di attività dipendenti.
CompletableFuture.completeOnTimeout completa lo stesso future con un valore alternativo, mentre CompletableFuture.orTimeout lo completa con TimeoutException se non è già terminato. Nessuno dei due metodi arresta il calcolo sottostante. Al contrario, get(timeout, unit) limita solo il tempo di attesa del chiamante.
Esempi
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executors;
public class Main {
public static void main(String[] args) {
try (var executor = Executors.newFixedThreadPool(2)) {
var base = CompletableFuture.supplyAsync(() -> 20, executor);
var result = base
.thenApply(n -> n + 1)
.thenCompose(n -> CompletableFuture.completedFuture(n * 2))
.thenCombine(CompletableFuture.completedFuture(8), Integer::sum);
var failed = new CompletableFuture<Integer>();
failed.completeExceptionally(new IllegalStateException("unavailable"));
var recovered = failed.exceptionally(error -> -1);
CompletableFuture.allOf(result, recovered).join();
System.out.println("result=" + result.join());
System.out.println("recovered=" + recovered.join());
}
}
}Risultato
result=50 recovered=-1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.