CKTIS / Java
CompletableFuture.join(): het resultaat ophalen
`join()` haalt het resultaat van een `CompletableFuture` op en wacht zo nodig tot die klaar is. De methode declareert geen gecontroleerde uitzonderingen, maar kan wel een ongecontroleerde uitzondering werpen.
Versie: Java SE 21
Syntax
public T join()In Java SE 21 is CompletableFuture.join() een instantiemethode zonder argumenten van java.util.concurrent.CompletableFuture<T>. Als de future nog niet is voltooid, blokkeert de aanroep de huidige thread tot de voltooiing. Bij normale voltooiing geeft de methode het resultaat van type T terug; als het resultaat al beschikbaar is, wacht ze niet.
Mislukt de berekening, dan werpt join() een CompletionException. Met getCause() kun je de oorzaak opvragen. Is de future zelf geannuleerd, dan werpt join() direct een CancellationException. Beide uitzonderingen zijn ongecontroleerd: de compiler verplicht je niet om ze af te vangen of te declareren.
Anders dan join() werpt get() de gecontroleerde InterruptedException als het wachten wordt onderbroken, en meldt het een mislukte berekening met de gecontroleerde ExecutionException. join() beëindigt het wachten niet door InterruptedException te werpen en accepteert geen tijdslimiet; gebruik get(timeout, unit) om de wachttijd te begrenzen. Thread.join() wacht daarentegen tot een thread eindigt, geeft geen berekeningsresultaat terug (void) en declareert InterruptedException.
Voorbeelden
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");
}
}
}
Resultaat
42 failure: invalid input cancelled
Elke future is al voltooid voordat `join()` wordt aangeroepen. Het voorbeeld toont de waarde `42`, het bericht van de oorzaak van de fout en een direct geworpen `CancellationException`; het laat geen blokkering zien.
Gerelateerde lessen
- Java · Les 51 · Gemiddeld · Versie: 2