Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CompletionException – zabalení selhání úlohy

CompletionException je nekontrolovaná výjimka, která signalizuje selhání při dokončování úlohy nebo výsledku. V prostředí CompletableFuture předává původní selhání kódu, který získává výsledek pomocí join().

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

Syntaxe

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

CompletionException z balíčku java.util.concurrent dědí z RuntimeException, a jde tedy o nekontrolovanou výjimku. Signalizuje výjimku nebo chybu, ke které došlo při dokončování úlohy nebo výsledku. Základní příčina je dostupná prostřednictvím zděděné metody getCause(); může mít hodnotu null.

Veřejné konstruktory jsou CompletionException(Throwable cause) a CompletionException(String message, Throwable cause). První odvodí zprávu jako (cause == null ? null : cause.toString()). Konstruktor bez argumentů a konstruktor přijímající pouze String mají přístup protected.

U CompletableFuture oznamuje join() selhání pomocí CompletionException; get() používá kontrolovanou výjimku ExecutionException. Zrušení má samostatnou cestu: join() může přímo vyhodit CancellationException. Nepředpokládejte tedy, že se každé selhání zabalí stejným způsobem.

Příklad nejprve dokončí future výjimečně a potom zavolá join(). Zobrazuje zvlášť obalující výjimku a její příčinu, aniž by spouštěl další vlákna. Při diagnostice chyb zachovejte příčinu a nenechávejte si pouze zprávu obalující výjimky.

Pří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ýsledek

CompletionException
IllegalArgumentException: invalid input

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje