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

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.

Fontes