База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CompletionException — обвиване на неуспех на задача

CompletionException е непроверено изключение, което сигнализира за неуспех при приключване на задача или резултат. При CompletableFuture то предава основния неуспех към кода, който извлича резултата чрез join().

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

new CompletionException(Throwable cause)
new CompletionException(String message, Throwable cause)

CompletionException от пакета java.util.concurrent наследява RuntimeException и затова е непроверено изключение. То сигнализира за изключение или грешка, възникнала при приключване на задача или резултат. Основната причина е достъпна чрез наследения метод getCause(); стойността ѝ може да бъде null.

Публичните конструктори са CompletionException(Throwable cause) и CompletionException(String message, Throwable cause). Първият извежда съобщението като (cause == null ? null : cause.toString()). Конструкторът без аргументи и този, който приема само String, имат достъп protected.

При CompletableFuture join() съобщава за неуспех чрез CompletionException; get() използва провереното изключение ExecutionException. Отмяната следва отделен път: join() може директно да хвърли CancellationException. Затова не приемайте, че всеки неуспех се обвива по един и същи начин.

Примерът приключва future с изключение, преди да извика join(). Той показва отделно обвиващото изключение и причината за него, без да стартира допълнителни нишки. При диагностициране на грешки запазвайте причината, вместо да оставяте само съобщението на обвиващото изключение.

Примери

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

Резултат

CompletionException
IllegalArgumentException: invalid input

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници