Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Future.isDone() : une tâche terminée n’a pas forcément réussi

`Future.isDone()` vérifie sans attendre si une tâche est terminée. La méthode renvoie `true` même si la tâche a levé une exception ou a été annulée.

Version : Java SE 21

Syntaxe

boolean isDone()

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

Future.isDone est une méthode d’instance sans argument de l’interface java.util.concurrent.Future<V>. L’appel future.isDone() renvoie un boolean sans attendre la fin de la tâche. false indique que la tâche n’était pas terminée au moment de la vérification : elle peut ne pas avoir commencé ou être encore en cours.

true couvre trois cas : fin normale, fin avec une exception et annulation. Cette valeur ne permet ni de distinguer ces cas ni de savoir si un résultat est disponible. Une annulation ne prouve pas non plus que le code de la tâche a cessé de s’exécuter.

Dans Java SE 21, future.state() distingue SUCCESS, FAILED, CANCELLED et RUNNING. future.get() attend si nécessaire : la méthode renvoie le résultat si la tâche se termine normalement, lève une ExecutionException dont la cause est l’exception de la tâche, ou lève une CancellationException si la tâche a été annulée. Si le thread appelant est interrompu pendant l’attente, la méthode lève une InterruptedException.

Exemples

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

Résultat

Before run: false
After run: true
Cause: IllegalStateException

L’appel direct à `task.run()` exécute la tâche dans le thread courant. `isDone()` renvoie `false` avant l’appel puis `true` après, même si `get()` lève une `ExecutionException` causée par une `IllegalStateException`.

Leçons associées

  • Java · Leçon 50 · Intermédiaire · Version : 2

Sources