Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje