Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

CompletionException – zabalenie zlyhania úlohy

CompletionException je nekontrolovaná výnimka, ktorá signalizuje zlyhanie pri dokončovaní úlohy alebo výsledku. V prostredí CompletableFuture odovzdáva pôvodné zlyhanie kódu, ktorý získava výsledok pomocou join().

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

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

CompletionException z balíka java.util.concurrent dedí z RuntimeException, a preto ide o nekontrolovanú výnimku. Signalizuje výnimku alebo chybu, ku ktorej došlo pri dokončovaní úlohy alebo výsledku. Základná príčina je dostupná prostredníctvom zdedenej metódy getCause(); môže mať hodnotu null.

Verejné konštruktory sú CompletionException(Throwable cause) a CompletionException(String message, Throwable cause). Prvý odvodí správu ako (cause == null ? null : cause.toString()). Konštruktor bez argumentov a konštruktor prijímajúci iba String majú prístup protected.

Pri CompletableFuture oznamuje join() zlyhanie pomocou CompletionException; get() používa kontrolovanú výnimku ExecutionException. Zrušenie má samostatnú cestu: join() môže priamo vyhodiť CancellationException. Nepredpokladajte teda, že každé zlyhanie sa zabalí rovnakým spôsobom.

Príklad najprv dokončí future výnimočne a potom zavolá join(). Zobrazuje zvlášť obalujúcu výnimku a jej príčinu bez spúšťania ďalších vlákien. Pri diagnostike chýb zachovajte príčinu a nenechávajte si iba správu obalujúcej výnimky.

Príklady

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

Výsledok

CompletionException
IllegalArgumentException: invalid input

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje