WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Future.get: Aufgabenergebnis abrufen oder Fehler behandeln

Rufe das Ergebnis einer asynchronen Aufgabe ab und unterscheide ihren Fehler von einer Unterbrechung, einem Abbruch, einem Zeitablauf oder einem Fehler des `invokeAll`-Aufrufs selbst.

Version: Java SE 21

Syntax

java.util.concurrent.Future<V>
V get() throws InterruptedException, ExecutionException
V get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException

Future.get ruft das Ergebnis einer asynchronen Berechnung ab, die durch ein java.util.concurrent.Future<V> repräsentiert wird. get() ohne Argumente blockiert den aufrufenden Thread bei Bedarf ohne Zeitlimit. Bei Erfolg liefert es einen Wert vom Typ V, auch null, wenn das Ergebnis der Aufgabe null war.

Löst die Aufgabe eine Ausnahme aus, wirft get() eine ExecutionException. Die ursprüngliche Ausnahme lässt sich mit getCause() auslesen. Eine InterruptedException bedeutet dagegen, dass der aufrufende Thread beim Warten unterbrochen wurde, nicht dass die Aufgabe fehlgeschlagen ist. Wurde die Aufgabe abgebrochen, wirft get() die ungeprüfte Ausnahme CancellationException.

Die Überladung get(long timeout, TimeUnit unit) hat dieselben möglichen Ergebnisse, begrenzt aber die Wartezeit. Läuft die Wartezeit ab, wird eine TimeoutException ausgelöst. Der Zeitablauf allein bricht die Aufgabe nicht ab; get() kann später erneut aufgerufen werden.

Wenn ExecutorService.invokeAll(tasks) normal zurückkehrt, sind die Futures bereits abgeschlossen und stehen in der Reihenfolge der Aufgaben in der Collection. isDone() bedeutet nicht Erfolg: Die Ausnahme einer Aufgabe meldet erst get() auf ihrem Future als ExecutionException, nicht invokeAll selbst. invokeAll kann seinerseits beim Warten unterbrochen werden (InterruptedException) oder eine Aufgabe nicht einplanen können (RejectedExecutionException). Die Überladung von invokeAll mit Zeitlimit bricht nicht abgeschlossene Aufgaben vor der Rückkehr ab; get() auf einem abgebrochenen Future wirft CancellationException.

Beispiele

import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;

public class FutureGetExample {
    public static void main(String[] args) throws InterruptedException {
        List<Callable<Integer>> tasks = List.of(
                () -> 21 * 2,
                () -> { throw new IllegalStateException("invalid input"); }
        );

        try (ExecutorService executor = Executors.newSingleThreadExecutor()) {
            List<Future<Integer>> futures = executor.invokeAll(tasks);
            System.out.println("invokeAll returned");
            for (Future<Integer> future : futures) {
                try {
                    System.out.println("Result: " + future.get());
                } catch (ExecutionException e) {
                    Throwable cause = e.getCause();
                    System.out.println("Task failed: " + cause.getClass().getSimpleName()
                            + ": " + cause.getMessage());
                }
            }
        }
    }
}

Ergebnis

invokeAll returned
Result: 42
Task failed: IllegalStateException: invalid input

Die erste Zeile zeigt, dass `invokeAll` normal zurückkehrt. Das erste `get()` liefert `42`; das zweite wirft `ExecutionException`. Das Programm gibt Typ und Meldung der Ursache aus, nicht die der umschließenden Ausnahme. Try-with-resources schließt den Executor.

Zugehörige Lektionen

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

Quellen