CKTIS / Java
CompletableFuture.thenApply: trasformare il risultato di una fase
Usa `thenApply` per trasformare il risultato di una fase dopo il suo completamento normale. Il metodo restituisce una nuova fase e non garantisce l’esecuzione su un thread separato.
Versione: Java SE 21
Sintassi
public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)In Java SE 21, CompletableFuture.thenApply del package java.util.concurrent crea un nuovo CompletableFuture<U> dipendente senza cambiare il risultato del CompletableFuture<T> di origine. Quando la fase di origine si completa normalmente, la funzione ne riceve il risultato; il valore restituito diventa il risultato della nuova fase. U può essere diverso da T: ? super T ammette T o un supertipo come input, mentre ? extends U ammette U o un sottotipo come tipo di ritorno.
La variante senza Async non garantisce un thread separato. La funzione può essere eseguita sul thread che completa la fase di origine oppure durante la chiamata a thenApply se il risultato è già disponibile. Mantieni queste trasformazioni brevi e non bloccanti. thenApplyAsync usa il meccanismo di esecuzione asincrona predefinito della fase o un Executor fornito esplicitamente.
Se la fase di origine si completa in modo eccezionale, anche per annullamento, la funzione non viene eseguita e la fase dipendente si completa in modo eccezionale. Lo stesso accade se la funzione lancia un’eccezione: join() sulla fase dipendente lancia allora CompletionException anziché restituire un risultato.
Usa thenApply quando la funzione restituisce un semplice valore. Se restituisce un CompletionStage<U>, usa thenCompose per ottenere il risultato di quella fase senza annidare le fasi.
Esempi
import java.util.concurrent.CompletableFuture;
public class Main {
public static void main(String[] args) {
CompletableFuture<Integer> total = new CompletableFuture<>();
CompletableFuture<String> label = total.thenApply(value -> "Total: " + value);
System.out.println(label.isDone());
total.complete(42);
System.out.println(label.join());
}
}Risultato
false Total: 42
La prima riga mostra `false` perché la fase di origine non è ancora completata. `complete(42)` rende disponibile il valore alla funzione e `join()` recupera il risultato trasformato `Total: 42`, aspettando se necessario.
Lezioni correlate
- Java · Lezione 51 · Intermedio · Versione: 2
Fonti
- CompletableFuture.thenApply — Java SE 21 & JDK 21 API
- CompletableFuture — Execution policies and cancellation — Java SE 21 & JDK 21 API
- CompletionStage — Exceptional completion rules — Java SE 21 & JDK 21 API
- CompletionStage.thenCompose — Java SE 21 & JDK 21 API
- CompletableFuture.join — Java SE 21 & JDK 21 API