Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

CompletableFuture.thenApply: transformar o resultado de uma etapa

Usa `thenApply` para transformar o resultado de uma etapa após a sua conclusão normal. O método devolve uma nova etapa e não garante que a função corra numa thread separada.

Versão: Java SE 21

Sintaxe

public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)

Em Java SE 21, CompletableFuture.thenApply, do pacote java.util.concurrent, cria um novo CompletableFuture<U> dependente sem alterar o resultado do CompletableFuture<T> de origem. Quando a etapa de origem termina normalmente, a função recebe o seu resultado e o valor que devolve torna-se o resultado da nova etapa. U pode ser diferente de T: ? super T aceita T ou um supertipo como tipo de entrada, e ? extends U aceita U ou um subtipo como tipo de retorno.

A variante sem Async não garante uma thread separada. A função pode correr na thread que conclui a etapa de origem ou durante a própria chamada a thenApply, se o resultado já estiver disponível. Mantém estas transformações curtas e não bloqueantes. thenApplyAsync usa o mecanismo de execução assíncrona predefinido da etapa ou um Executor fornecido explicitamente.

Se a etapa de origem terminar de forma excecional, incluindo por cancelamento, a função não é chamada e a etapa dependente também termina de forma excecional. O mesmo acontece se a função lançar uma exceção: nesse caso, join() na etapa dependente lança CompletionException em vez de devolver um resultado.

Usa thenApply quando a função devolve um valor simples. Se devolver um CompletionStage<U>, usa thenCompose para obter o resultado dessa etapa sem criar etapas aninhadas.

Exemplos

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());
    }
}

Resultado

false
Total: 42

A primeira linha é `false` porque a etapa de origem ainda não terminou. `complete(42)` disponibiliza o valor à função e `join()` obtém o resultado transformado `Total: 42`, aguardando se necessário.

Lições relacionadas

  • Java · Lição 51 · Intermédio · Versão: 2

Fontes