Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Future.isDone(): terminar não significa ter sucesso

`Future.isDone()` verifica, sem esperar, se uma tarefa terminou. Devolve `true` mesmo quando a tarefa lançou uma exceção ou foi cancelada.

Versão: Java SE 21

Sintaxe

boolean isDone()

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

Future.isDone é um método de instância sem argumentos da interface java.util.concurrent.Future<V>. A chamada future.isDone() devolve um boolean sem esperar que a tarefa termine. false indica que a tarefa ainda não tinha terminado no momento da consulta: pode ainda não ter começado ou continuar em execução.

true abrange a conclusão normal, a conclusão com uma exceção e o cancelamento. O valor, por si só, não distingue estes casos nem indica que exista um resultado disponível. O cancelamento também não prova que o código da tarefa tenha deixado de ser executado.

Em Java SE 21, future.state() distingue SUCCESS, FAILED, CANCELLED e RUNNING. future.get() espera se for necessário: devolve o resultado após a conclusão normal, lança ExecutionException com a exceção da tarefa como causa ou lança CancellationException se a tarefa tiver sido cancelada. Se a thread que fez a chamada for interrompida durante a espera, o método lança InterruptedException.

Exemplos

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

Resultado

Before run: false
After run: true
Cause: IllegalStateException

A chamada direta a `task.run()` executa a tarefa na thread atual. `isDone()` devolve `false` antes da chamada e `true` depois, embora `get()` lance uma `ExecutionException` cuja causa é `IllegalStateException`.

Lições relacionadas

  • Java · Lição 50 · Intermédio · Versão: 2

Fontes