CKTIS / Java
CompletableFuture.join(): pobieranie wyniku
Metoda `join()` zwraca wynik obiektu `CompletableFuture`, w razie potrzeby czekając na jego zakończenie. Nie deklaruje wyjątków kontrolowanych, ale może zgłosić wyjątek niekontrolowany.
Wersja: Java SE 21
Składnia
public T join()W Javie SE 21 CompletableFuture.join() to bezargumentowa metoda instancji klasy java.util.concurrent.CompletableFuture<T>. Jeśli obiekt nie jest jeszcze zakończony, wywołanie blokuje bieżący wątek do czasu jego zakończenia. Przy normalnym zakończeniu zwraca wynik typu T; jeśli wynik jest już gotowy, nie czeka.
Gdy obliczenie kończy się błędem, join() zgłasza CompletionException, a przyczynę można odczytać przez getCause(). Jeśli anulowano sam obiekt, join() zgłasza bezpośrednio CancellationException. Oba wyjątki są niekontrolowane: kompilator nie wymaga ich przechwycenia ani zadeklarowania.
W odróżnieniu od join() metoda get() zgłasza kontrolowany InterruptedException, jeśli oczekiwanie zostanie przerwane, i sygnalizuje błąd obliczenia kontrolowanym ExecutionException. join() nie przerywa oczekiwania przez zgłoszenie InterruptedException i nie przyjmuje limitu czasu; do oczekiwania z limitem służy get(timeout, unit). Z kolei Thread.join() czeka na zakończenie wątku, nie zwraca wyniku obliczenia (void) i deklaruje InterruptedException.
Przykłady
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");
}
}
}
Wynik
42 failure: invalid input cancelled
Każdy obiekt `CompletableFuture` jest już zakończony przed wywołaniem `join()`. Przykład pokazuje wartość `42`, komunikat przyczyny błędu oraz bezpośrednie zgłoszenie `CancellationException`; nie demonstruje blokowania.
Powiązane lekcje
- Java · Lekcja 51 · Średniozaawansowany · Wersja: 2