Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła