Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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