CKTIS / Java
UnsupportedOperationException — nepodporovaná operácia
UnsupportedOperationException znamená, že požadovaná operácia nie je podporovaná. Často sa vyskytuje pri pokuse o zmenu nemodifikovateľného zoznamu, napríklad zoznamu vytvoreného pomocou List.of(...). Riešením je vybrať objekt, ktorý požadovanú operáciu podporuje, a nie iba zachytiť výnimku.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
throw new UnsupportedOperationException("Operation not supported");UnsupportedOperationException z java.lang signalizuje, že požadovaná operácia nie je podporovaná. Dedí od triedy RuntimeException: ide o nekontrolovanú výnimku, takže kompilátor nevyžaduje jej zachytenie ani deklaráciu v throws.
Typickým prípadom je volanie add na zozname vytvorenom pomocou List.of(...). Taký zoznam sa nedá meniť: pridávanie, odstraňovanie aj nahrádzanie prvkov vyvolá túto výnimku. To, že zoznam nemožno meniť, však neznamená, že jeho prvky sú samy osebe nemenné.
Pri diagnostike skontrolujte zásobník volaní, zmluvu metódy a spôsob vytvorenia objektu. Samotný typ List nezaručuje podporu zmien. Ak sú zmeny potrebné, vyberte implementáciu, ktorej zmluva ich povoľuje; výnimku neignorujte ako riešenie.
Vo vlastnom API túto výnimku vyvolajte, keď operácia nie je podľa zmluvy podporovaná. Dostupné konštruktory sú UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) a UnsupportedOperationException(String message, Throwable cause). Pri poslednej forme sa správa príčiny automaticky nezahrnie do správy výnimky.
Príklady
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);
}
}Výsledok
UnsupportedOperationException [Ada, Linus]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.