CKTIS / Java
CompletableFuture — compor cálculos assíncronos
CompletableFuture<T> representa um resultado futuro e permite encadear etapas dependentes sem bloquear após cada passo. Aprenda transformações, composição, combinação de resultados, recuperação de erros e limites de tempo em Java SE 21.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
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 um resultado Future<T> com etapas CompletionStage<T>. CompletableFuture.supplyAsync submete um cálculo para execução; CompletableFuture.completedFuture cria um resultado já concluído. CompletableFuture.completeExceptionally conclui com um erro um future ainda não concluído. Âmbito: Java SE 21; ambiente de execução do repositório, ambiente de produção não atestado.
CompletableFuture.thenApply transforma um resultado bem-sucedido; não garante uma thread separada. CompletableFuture.thenApplyAsync submete a função a um executor para execução. Por predefinição, é utilizado ForkJoinPool.commonPool(); quando o paralelismo é inferior a dois, é criada uma thread para cada tarefa. Pode fornecer explicitamente um executor. CompletableFuture.thenCompose achata uma função que devolve outra etapa, em vez de criar um resultado aninhado. CompletableFuture.thenCombine combina valores depois de ambas as etapas serem concluídas com sucesso.
CompletableFuture.exceptionally calcula um valor de substituição apenas em caso de falha. CompletableFuture.allOf aguarda por todas as etapas, devolve CompletableFuture<Void> e propaga a falha se alguma etapa falhar; não recolhe os valores. CompletableFuture.anyOf devolve CompletableFuture<Object> com o resultado ou a falha de uma das etapas que terminar — não necessariamente um sucesso. Não cancela as tarefas restantes.
CompletableFuture.join e CompletableFuture.get bloqueiam até à conclusão. Normalmente, a falha é encapsulada em CompletionException, não verificada, ou em ExecutionException, verificada, respetivamente; get também pode lançar InterruptedException. O cancelamento lança CancellationException. Evite bloquear dentro de tarefas dependentes.
CompletableFuture.completeOnTimeout conclui o mesmo future com um valor alternativo, enquanto CompletableFuture.orTimeout o conclui com TimeoutException, caso ainda não esteja concluído. Nenhum destes métodos interrompe o cálculo subjacente. Em contrapartida, get(timeout, unit) limita apenas o tempo de espera de quem faz a chamada.
Exemplos
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());
}
}
}Resultado
result=50 recovered=-1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.