CKTIS / Java
CompletionException — envolver uma falha de tarefa
CompletionException é uma exceção não verificada que assinala uma falha ao concluir uma tarefa ou um resultado. Com CompletableFuture, transmite a falha subjacente ao código que obtém o resultado através de join().
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)CompletionException, do pacote java.util.concurrent, herda de RuntimeException e é, por isso, uma exceção não verificada. Assinala uma exceção ou um erro encontrado ao concluir uma tarefa ou um resultado. A causa subjacente está disponível através do método herdado getCause(); pode ser null.
Os construtores públicos são CompletionException(Throwable cause) e CompletionException(String message, Throwable cause). O primeiro determina a mensagem como (cause == null ? null : cause.toString()). O construtor sem argumentos e o construtor que recebe apenas String têm acesso protected.
Em CompletableFuture, join() comunica uma falha através de CompletionException; get() utiliza a exceção verificada ExecutionException. O cancelamento segue um percurso distinto: join() pode lançar diretamente CancellationException. Por isso, não parta do princípio de que todas as falhas são envolvidas da mesma forma.
O exemplo conclui future de forma excecional antes de chamar join(). Apresenta separadamente a exceção que envolve a falha e a respetiva causa, sem iniciar threads adicionais. Ao diagnosticar falhas, preserve a causa em vez de guardar apenas a mensagem da exceção envolvente.
Exemplos
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
public class Main {
public static void main(String[] args) {
CompletableFuture<String> future = new CompletableFuture<>();
future.completeExceptionally(new IllegalArgumentException("invalid input"));
try {
future.join();
} catch (CompletionException ex) {
Throwable cause = ex.getCause();
System.out.println(ex.getClass().getSimpleName());
System.out.println(cause.getClass().getSimpleName() + ": " + cause.getMessage());
}
}
}
Resultado
CompletionException IllegalArgumentException: invalid input
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.