Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła