Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

CompletionException — omatanje neuspjeha zadatka

CompletionException je nekontrolirana iznimka koja označava neuspjeh pri dovršavanju zadatka ili rezultata. Uz CompletableFuture prenosi temeljni neuspjeh kodu koji dohvaća rezultat pomoću join().

Verzija: 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 nasljeđuje RuntimeException, pa je riječ o nekontroliranoj iznimci. Označava iznimku ili pogrešku do koje je došlo pri dovršavanju zadatka ili rezultata. Temeljni uzrok dostupan je putem naslijeđene metode getCause(); može biti null.

Javni konstruktori su CompletionException(Throwable cause) i CompletionException(String message, Throwable cause). Prvi određuje poruku kao (cause == null ? null : cause.toString()). Konstruktor bez argumenata i konstruktor koji prima samo String imaju pristup protected.

Kod CompletableFuture, join() prijavljuje neuspjeh pomoću CompletionException; get() koristi provjerenu iznimku ExecutionException. Otkazivanje slijedi zaseban put: join() može izravno baciti CancellationException. Stoga nemojte pretpostavljati da se svaki neuspjeh omata na isti način.

Primjer najprije iznimno dovršava future, a zatim poziva join(). Zasebno prikazuje omotnu iznimku i njezin uzrok, bez pokretanja dodatnih dretvi. Pri dijagnosticiranju pogrešaka sačuvajte uzrok umjesto da zadržite samo poruku omotne iznimke.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori