CKTIS / Java
Future.isDone(): dokončení neznamená úspěch
`Future.isDone()` bez čekání zjistí, zda úloha skončila. Vrací `true` i v případě, že úloha skončila výjimkou nebo byla zrušena.
Verze: Java SE 21
Syntaxe
boolean isDone()
// Call on a java.util.concurrent.Future<V> instance:
boolean done = future.isDone();Future.isDone je instanční metoda bez argumentů z rozhraní java.util.concurrent.Future<V>. Volání future.isDone() vrací hodnotu typu boolean a nečeká na konec úlohy. false znamená, že úloha v okamžiku kontroly ještě neskončila: buď se ještě nespustila, nebo stále běží.
true označuje řádné dokončení, ukončení výjimkou i zrušení. Samotná hodnota tyto případy nerozliší a neříká, zda je k dispozici výsledek. Zrušení také nedokazuje, že se kód úlohy přestal vykonávat.
V Java SE 21 metoda future.state() rozlišuje stavy SUCCESS, FAILED, CANCELLED a RUNNING. future.get() v případě potřeby čeká: po řádném dokončení vrátí výsledek, při výjimce úlohy vyhodí ExecutionException s touto výjimkou jako příčinou a při zrušení vyhodí CancellationException. Pokud je volající vlákno během čekání přerušeno, metoda vyhodí InterruptedException.
Příklady
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());
}
}
}Výsledek
Before run: false After run: true Cause: IllegalStateException
Přímé volání `task.run()` provede úlohu v aktuálním vlákně. `isDone()` před voláním vrátí `false` a po něm `true`, přestože `get()` vyhodí `ExecutionException` s příčinou `IllegalStateException`.
Související lekce
- Java · Lekce 50 · Středně pokročilá · Verze: 2