CKTIS / Java
CompletableFuture.join(): obtener el resultado
`join()` obtiene el resultado de un `CompletableFuture` y, si es necesario, espera a que termine. No declara excepciones comprobadas, pero puede lanzar una excepción no comprobada.
Versión: Java SE 21
Sintaxis
public T join()En Java SE 21, CompletableFuture.join() es un método de instancia sin argumentos de java.util.concurrent.CompletableFuture<T>. Si el futuro aún no ha terminado, la llamada bloquea el hilo actual hasta que termine. Si termina normalmente, devuelve el resultado de tipo T; si el resultado ya está disponible, no espera.
Si el cálculo falla, join() lanza CompletionException y puedes consultar su causa con getCause(). Si se ha cancelado el propio futuro, join() lanza directamente CancellationException. Ambas excepciones son no comprobadas: el compilador no exige capturarlas ni declararlas.
A diferencia de join(), get() lanza la excepción comprobada InterruptedException si se interrumpe la espera y notifica un fallo del cálculo con la excepción comprobada ExecutionException. join() no finaliza la espera lanzando InterruptedException ni admite un tiempo máximo de espera; para eso, usa get(timeout, unit). En cambio, Thread.join() espera a que termine un hilo, no devuelve ningún resultado del cálculo (void) y declara InterruptedException.
Ejemplos
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 futuro ya ha terminado antes de llamar a `join()`. El ejemplo muestra el valor `42`, el mensaje de la causa del fallo y una `CancellationException` lanzada directamente; no demuestra el bloqueo.
Lecciones relacionadas
- Java · Lección 51 · Intermedio · Versión: 2