CKTIS / Java
CompletableFuture.join(): das Ergebnis abrufen
`join()` ruft das Ergebnis eines `CompletableFuture` ab und wartet bei Bedarf auf dessen Abschluss. Die Methode deklariert keine geprüften Ausnahmen, kann aber eine ungeprüfte Ausnahme auslösen.
Version: Java SE 21
Syntax
public T join()In Java SE 21 ist CompletableFuture.join() eine parameterlose Instanzmethode von java.util.concurrent.CompletableFuture<T>. Ist das Future noch nicht abgeschlossen, blockiert der Aufruf den aktuellen Thread bis zum Abschluss. Bei normalem Abschluss liefert er das Ergebnis vom Typ T; liegt es bereits vor, wartet er nicht.
Schlägt die Berechnung fehl, löst join() eine CompletionException aus. Die Ursache lässt sich mit getCause() abfragen. Wurde das Future selbst abgebrochen, löst join() direkt eine CancellationException aus. Beide Ausnahmen sind ungeprüft: Der Compiler verlangt nicht, dass du sie abfängst oder deklarierst.
Anders als join() löst get() bei einer Unterbrechung des Wartens die geprüfte InterruptedException aus und meldet einen Berechnungsfehler mit der geprüften ExecutionException. join() beendet das Warten nicht mit einer InterruptedException und nimmt kein Zeitlimit entgegen; für zeitlich begrenztes Warten gibt es get(timeout, unit). Thread.join() wartet dagegen auf das Ende eines Threads, liefert kein Berechnungsergebnis (void) und deklariert InterruptedException.
Beispiele
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");
}
}
}
Ergebnis
42 failure: invalid input cancelled
Jedes Future ist beim Aufruf von `join()` bereits abgeschlossen. Das Beispiel zeigt den Wert `42`, die Meldung der Fehlerursache und eine direkt ausgelöste `CancellationException`; es zeigt kein Blockieren.
Zugehörige Lektionen
- Java · Lektion 51 · Mittlere Stufe · Version: 2