CKTIS / Java
UnsupportedOperationException — nepodprta operacija
UnsupportedOperationException pomeni, da zahtevana operacija ni podprta. Pogosto se pojavi pri poskusu spreminjanja nespremenljivega seznama, na primer seznama, ustvarjenega z List.of(...). Rešitev je izbira objekta, ki podpira potrebno operacijo, ne zgolj prestrezanje izjeme.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
throw new UnsupportedOperationException("Operation not supported");UnsupportedOperationException v java.lang sporoča, da zahtevana operacija ni podprta. Razširja RuntimeException: gre za nenadzorovano izjemo, zato prevajalnik ne zahteva, da jo prestrežete ali navedete v throws.
Tipičen primer je klic add na seznamu, ustvarjenem z List.of(...). Takega seznama ni mogoče spreminjati: dodajanje, odstranjevanje ali zamenjava elementov povzroči to izjemo. Vendar dejstvo, da seznama ni mogoče spreminjati, ne pomeni, da so tudi njegovi elementi nespremenljivi.
Pri iskanju vzroka preverite sled klicev, pogodbo metode in način, kako je bil objekt ustvarjen. Sam tip List ne zagotavlja podpore za spreminjanje. Če so spremembe potrebne, izberite implementacijo, katere pogodba jih dovoljuje; izjeme ne prezrite kot rešitve.
V lastnem API-ju sprožite to izjemo, kadar operacija po pogodbi ni podprta. Na voljo so konstruktorji UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) in UnsupportedOperationException(String message, Throwable cause). Pri zadnji obliki se sporočilo vzroka ne vključi samodejno v sporočilo izjeme.
Primeri
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]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.