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

CKTIS / Java

CompletableFuture.join(): obter o resultado

`join()` obtém o resultado de um `CompletableFuture`, aguardando pela sua conclusão se necessário. Não declara exceções verificadas, mas pode lançar uma exceção não verificada.

Versão: Java SE 21

Sintaxe

public T join()

No Java SE 21, CompletableFuture.join() é um método de instância sem argumentos de java.util.concurrent.CompletableFuture<T>. Se o future ainda não estiver concluído, a chamada bloqueia a thread atual até à conclusão. Se terminar normalmente, devolve o resultado do tipo T; se o resultado já estiver disponível, não espera.

Se o cálculo falhar, join() lança CompletionException, cuja causa pode ser consultada com getCause(). Se o próprio future tiver sido cancelado, join() lança diretamente CancellationException. Ambas são exceções não verificadas: o compilador não exige que sejam capturadas ou declaradas.

Ao contrário de join(), get() lança a exceção verificada InterruptedException se a espera for interrompida e assinala uma falha no cálculo com a exceção verificada ExecutionException. join() não termina a espera lançando InterruptedException nem aceita um limite de tempo; para limitar a espera, usa get(timeout, unit). Já Thread.join() espera que uma thread termine, não devolve um resultado do cálculo (void) e declara InterruptedException.

Exemplos

import java.util.concurrent.CancellationException;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;

public class Main {
    public static void main(String[] args) {
        CompletableFuture<Integer> success = CompletableFuture.completedFuture(42);
        System.out.println(success.join());

        CompletableFuture<Integer> failure =
                CompletableFuture.failedFuture(new IllegalArgumentException("invalid input"));
        try {
            failure.join();
        } catch (CompletionException e) {
            System.out.println("failure: " + e.getCause().getMessage());
        }

        CompletableFuture<Integer> cancelled = new CompletableFuture<>();
        cancelled.cancel(false);
        try {
            cancelled.join();
        } catch (CancellationException e) {
            System.out.println("cancelled");
        }
    }
}

Resultado

42
failure: invalid input
cancelled

Cada future já está concluído quando se chama `join()`. O exemplo mostra o valor `42`, a mensagem da causa da falha e uma `CancellationException` lançada diretamente; não demonstra o bloqueio.

Lições relacionadas

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

Fontes