WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Future.isDone(): beendet heißt nicht erfolgreich

`Future.isDone()` prüft ohne Wartezeit, ob eine Aufgabe abgeschlossen ist. Auch bei einem Ende durch eine Ausnahme oder bei einem Abbruch liefert die Methode `true`.

Version: Java SE 21

Syntax

boolean isDone()

// Call on a java.util.concurrent.Future<V> instance:
boolean done = future.isDone();

Future.isDone ist eine parameterlose Instanzmethode der Schnittstelle java.util.concurrent.Future<V>. Der Aufruf future.isDone() liefert einen boolean, ohne auf das Ende der Aufgabe zu warten. false bedeutet, dass die Aufgabe zum Zeitpunkt der Abfrage noch nicht abgeschlossen war: Sie kann noch nicht gestartet sein oder noch laufen.

true steht für ein reguläres Ende, ein Ende durch eine Ausnahme oder einen Abbruch. Der Wert allein unterscheidet diese Fälle nicht und sagt nicht aus, dass ein Ergebnis vorliegt. Ein Abbruch beweist auch nicht, dass der Aufgabencode nicht mehr läuft.

In Java SE 21 unterscheidet future.state() die Zustände SUCCESS, FAILED, CANCELLED und RUNNING. future.get() wartet bei Bedarf und liefert bei regulärem Ende das Ergebnis, wirft bei einer Ausnahme der Aufgabe eine ExecutionException mit dieser Ausnahme als Ursache oder wirft bei einem Abbruch eine CancellationException. Wird der aufrufende Thread beim Warten unterbrochen, wirft die Methode eine InterruptedException.

Beispiele

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());
        }
    }
}

Ergebnis

Before run: false
After run: true
Cause: IllegalStateException

Der direkte Aufruf von `task.run()` führt die Aufgabe im aktuellen Thread aus. `isDone()` liefert davor `false` und danach `true`, obwohl `get()` eine `ExecutionException` mit der Ursache `IllegalStateException` wirft.

Zugehörige Lektionen

  • Java · Lektion 50 · Mittlere Stufe · Version: 2

Quellen