CKTIS / Java
UnsupportedOperationException — nepodporovaná operace
UnsupportedOperationException znamená, že požadovaná operace není podporována. Často k ní dochází při pokusu o změnu nemodifikovatelného seznamu, například seznamu vytvořeného pomocí List.of(...). Řešením je zvolit objekt, který požadovanou operaci podporuje, a ne pouze výjimku zachytit.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
throw new UnsupportedOperationException("Operation not supported");UnsupportedOperationException z java.lang signalizuje, že požadovaná operace není podporována. Dědí z RuntimeException: jde o nekontrolovanou výjimku, takže kompilátor nevyžaduje její zachycení ani deklaraci v throws.
Typickým případem je volání add na seznamu vytvořeném pomocí List.of(...). Takový seznam nelze měnit: přidávání, odebírání i nahrazování prvků vyvolá tuto výjimku. To, že seznam nelze měnit, však neznamená, že jeho prvky jsou samy o sobě neměnné.
Při hledání příčiny zkontrolujte zásobník volání, smlouvu metody a způsob vytvoření objektu. Samotný typ List nezaručuje, že jsou změny podporovány. Pokud jsou změny potřeba, zvolte implementaci, jejíž smlouva je povoluje; výjimku neignorujte jako řešení.
Ve vlastním API tuto výjimku vyvolávejte, když operace není podle smlouvy podporována. Dostupné konstruktory jsou UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) a UnsupportedOperationException(String message, Throwable cause). U poslední varianty se zpráva příčiny automaticky nepřipojí ke zprávě výjimky.
Pří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ýsledek
UnsupportedOperationException [Ada, Linus]
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.