Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Future.isDone(): terminare non significa riuscire

`Future.isDone()` verifica senza attendere se un’attività è terminata. Restituisce `true` anche se l’attività ha lanciato un’eccezione o è stata annullata.

Versione: Java SE 21

Sintassi

boolean isDone()

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

Future.isDone è un metodo di istanza senza argomenti dell’interfaccia java.util.concurrent.Future<V>. La chiamata future.isDone() restituisce un boolean senza aspettare la fine dell’attività. false indica che l’attività non era terminata al momento del controllo: potrebbe non essere ancora partita o essere tuttora in esecuzione.

true copre tre casi: conclusione normale, conclusione con un’eccezione e annullamento. Il valore da solo non distingue questi casi e non indica che sia disponibile un risultato. L’annullamento non dimostra nemmeno che il codice dell’attività abbia smesso di essere eseguito.

In Java SE 21, future.state() distingue SUCCESS, FAILED, CANCELLED e RUNNING. future.get() attende se necessario: restituisce il risultato se l’attività termina normalmente, lancia ExecutionException con l’eccezione dell’attività come causa oppure lancia CancellationException se l’attività è stata annullata. Se il thread chiamante viene interrotto durante l’attesa, il metodo lancia InterruptedException.

Esempi

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

Risultato

Before run: false
After run: true
Cause: IllegalStateException

La chiamata diretta a `task.run()` esegue l’attività nel thread corrente. `isDone()` restituisce `false` prima della chiamata e `true` dopo, anche se `get()` lancia una `ExecutionException` causata da `IllegalStateException`.

Lezioni correlate

  • Java · Lezione 50 · Intermedio · Versione: 2

Fonti