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