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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.