Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes