Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje