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