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
- 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