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.