Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje