CKTIS / Java
UnsupportedOperationException — nepodržana operacija
UnsupportedOperationException znači da tražena operacija nije podržana. Često se javlja pri pokušaju izmjene nepromjenjivog popisa, primjerice onoga stvorenog pomoću List.of(...). Rješenje je odabrati objekt koji podržava potrebnu operaciju, a ne samo uhvatiti iznimku.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
throw new UnsupportedOperationException("Operation not supported");UnsupportedOperationException iz java.lang označava da tražena operacija nije podržana. Nasljeđuje RuntimeException: riječ je o nekontroliranoj iznimci, pa prevoditelj ne zahtijeva njezino hvatanje ni deklariranje u throws.
Tipičan je slučaj poziv metode add nad popisom stvorenim pomoću List.of(...). Taj se popis ne može mijenjati: dodavanje, uklanjanje ili zamjena elemenata uzrokuje ovu iznimku. Ipak, to što se popis ne može mijenjati ne znači da su i njegovi elementi sami po sebi nepromjenjivi.
Pri dijagnosticiranju provjerite stog poziva, ugovor metode i način na koji je objekt stvoren. Sam tip List ne jamči podršku za izmjene. Ako su izmjene potrebne, odaberite implementaciju čiji ih ugovor dopušta; nemojte zanemariti iznimku kao rješenje.
U vlastitom API-ju bacite ovu iznimku kada operacija nije podržana ugovorom. Dostupni konstruktori su UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) i UnsupportedOperationException(String message, Throwable cause). U posljednjem obliku poruka uzroka ne uključuje se automatski u poruku iznimke.
Primjeri
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> names = List.of("Ada", "Linus");
try {
names.add("Grace");
} catch (UnsupportedOperationException e) {
System.out.println("UnsupportedOperationException");
}
System.out.println(names);
}
}Rezultat
UnsupportedOperationException [Ada, Linus]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.