CKTIS / Java
Future.get: wynik zadania lub wyjątek
Odczytaj wynik zadania asynchronicznego i odróżnij jego błąd od przerwania oczekiwania, anulowania, upływu limitu czasu oraz błędu samego wywołania `invokeAll`.
Wersja: Java SE 21
Składnia
java.util.concurrent.Future<V>
V get() throws InterruptedException, ExecutionException
V get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutExceptionMetoda Future.get z interfejsu java.util.concurrent.Future<V> odczytuje wynik obliczenia asynchronicznego. get() w razie potrzeby blokuje wątek wywołujący bez limitu czasu. Po pomyślnym zakończeniu zwraca wartość typu V, która może być null, jeśli taki był wynik zadania.
Jeśli zadanie rzuci wyjątek, get() zgłasza ExecutionException. Oryginalny wyjątek odczytasz przez getCause(). InterruptedException oznacza natomiast przerwanie wątku wywołującego podczas oczekiwania, a nie błąd zadania. Jeśli zadanie anulowano, get() zgłasza niekontrolowany wyjątek CancellationException.
Wariant get(long timeout, TimeUnit unit) ma te same możliwe wyniki, ale ogranicza czas oczekiwania. Jeśli limit upłynie podczas oczekiwania, metoda zgłasza TimeoutException. Sam upływ limitu nie anuluje zadania; później możesz ponownie wywołać get().
Po normalnym powrocie ExecutorService.invokeAll(tasks) obiekty Future są już zakończone i zachowują kolejność zadań w kolekcji. isDone() nie oznacza sukcesu: wyjątek zadania ujawnia się jako ExecutionException dopiero przy odczycie jego wyniku przez get(), a nie w samym invokeAll. Samo invokeAll może na przykład zostać przerwane podczas oczekiwania (InterruptedException) albo nie móc zaplanować zadania (RejectedExecutionException). Wariant invokeAll z limitem czasu anuluje niezakończone zadania przed zwróceniem listy; get() na anulowanym obiekcie Future zgłasza CancellationException.
Przykłady
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
public class FutureGetExample {
public static void main(String[] args) throws InterruptedException {
List<Callable<Integer>> tasks = List.of(
() -> 21 * 2,
() -> { throw new IllegalStateException("invalid input"); }
);
try (ExecutorService executor = Executors.newSingleThreadExecutor()) {
List<Future<Integer>> futures = executor.invokeAll(tasks);
System.out.println("invokeAll returned");
for (Future<Integer> future : futures) {
try {
System.out.println("Result: " + future.get());
} catch (ExecutionException e) {
Throwable cause = e.getCause();
System.out.println("Task failed: " + cause.getClass().getSimpleName()
+ ": " + cause.getMessage());
}
}
}
}
}Wynik
invokeAll returned Result: 42 Task failed: IllegalStateException: invalid input
Pierwszy wiersz pokazuje, że `invokeAll` wróciło normalnie. Pierwsze `get()` zwraca `42`, a drugie zgłasza `ExecutionException`. Program wypisuje typ i komunikat przyczyny, nie wyjątku opakowującego. Konstrukcja try-with-resources zamyka executor.
Powiązane lekcje
- Java · Lekcja 50 · Średniozaawansowany · Wersja: 2