CKTIS / Java
Future.isDone(): zakończenie nie oznacza sukcesu
`Future.isDone()` sprawdza bez czekania, czy zadanie jest zakończone. Zwraca `true` także wtedy, gdy zadanie zakończyło się wyjątkiem lub zostało anulowane.
Wersja: Java SE 21
Składnia
boolean isDone()
// Call on a java.util.concurrent.Future<V> instance:
boolean done = future.isDone();Future.isDone to metoda instancyjna bez argumentów z interfejsu java.util.concurrent.Future<V>. Wywołanie future.isDone() zwraca boolean bez czekania na zakończenie zadania. false oznacza, że zadanie nie było jeszcze zakończone w chwili sprawdzenia: mogło jeszcze nie wystartować albo nadal trwać.
true oznacza zakończenie normalne, zakończenie wyjątkiem albo anulowanie. Sama wartość nie rozróżnia tych przypadków i nie potwierdza, że istnieje wynik. Anulowanie nie dowodzi też, że kod zadania przestał się wykonywać.
W Java SE 21 metoda future.state() rozróżnia stany SUCCESS, FAILED, CANCELLED i RUNNING. future.get() w razie potrzeby czeka: zwraca wynik po normalnym zakończeniu, zgłasza ExecutionException z wyjątkiem zadania jako przyczyną albo CancellationException po anulowaniu. Przerwanie wątku wywołującego podczas oczekiwania powoduje InterruptedException.
Przykłady
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Future;
import java.util.concurrent.FutureTask;
public class Main {
public static void main(String[] args) throws InterruptedException {
FutureTask<Integer> task = new FutureTask<>(() -> {
throw new IllegalStateException("calculation failed");
});
Future<Integer> future = task;
System.out.println("Before run: " + future.isDone());
task.run();
System.out.println("After run: " + future.isDone());
try {
future.get();
} catch (ExecutionException e) {
System.out.println("Cause: " + e.getCause().getClass().getSimpleName());
}
}
}Wynik
Before run: false After run: true Cause: IllegalStateException
Bezpośrednie wywołanie `task.run()` wykonuje zadanie w bieżącym wątku. Przed nim `isDone()` daje `false`, a po nim `true`, mimo że `get()` zgłasza `ExecutionException` z przyczyną `IllegalStateException`.
Powiązane lekcje
- Java · Lekcja 50 · Średniozaawansowany · Wersja: 2