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.