Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

CompletionException – ovijanje napake opravila

CompletionException je nepreverjena izjema, ki sporoča napako pri dokončevanju opravila ali rezultata. Pri CompletableFuture posreduje osnovno napako kodi, ki rezultat pridobi z join().

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

CompletionException iz paketa java.util.concurrent podeduje RuntimeException, zato je nepreverjena izjema. Sporoča izjemo ali napako, do katere je prišlo med dokončevanjem opravila ali rezultata. Osnovni vzrok je na voljo prek podedovane metode getCause(); njegova vrednost je lahko null.

Javna konstruktorja sta CompletionException(Throwable cause) in CompletionException(String message, Throwable cause). Prvi določi sporočilo kot (cause == null ? null : cause.toString()). Konstruktor brez argumentov in konstruktor, ki sprejme samo String, imata dostop protected.

Pri CompletableFuture metoda join() sporoči napako z CompletionException; metoda get() uporablja preverjeno izjemo ExecutionException. Preklic poteka ločeno: join() lahko neposredno vrže CancellationException. Zato ne predpostavljajte, da je vsaka napaka ovita na enak način.

Primer najprej izjemno zaključi future, nato pa pokliče join(). Ovijalno izjemo in njen vzrok izpiše ločeno, ne da bi zagnal dodatne niti. Pri diagnosticiranju napak ohranite vzrok, namesto da obdržite samo sporočilo ovijalne izjeme.

Primeri

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

Rezultat

CompletionException
IllegalArgumentException: invalid input

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri