Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

UnsupportedOperationException — nieobsługiwana operacja

UnsupportedOperationException oznacza, że żądana operacja nie jest obsługiwana. Często występuje przy próbie modyfikacji listy niemodyfikowalnej, np. utworzonej przez List.of(...). Rozwiązaniem jest dobranie obiektu obsługującego potrzebną operację, a nie samo przechwycenie wyjątku.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException z pakietu java.lang sygnalizuje, że żądana operacja nie jest obsługiwana. Dziedziczy po RuntimeException: jest wyjątkiem niekontrolowanym, więc kompilator nie wymaga jego przechwycenia ani deklaracji w throws.

Typowy przypadek to wywołanie add na liście utworzonej przez List.of(...). Taka lista jest niemodyfikowalna: dodawanie, usuwanie i zastępowanie elementów powoduje ten wyjątek. Niemodyfikowalność listy nie oznacza jednak, że jej elementy same są niemodyfikowalne.

Podczas diagnozy sprawdź stos wywołań oraz kontrakt metody i sposób utworzenia obiektu. Sam typ List nie gwarantuje obsługi modyfikacji. Jeśli zmiany są potrzebne, wybierz implementację, której kontrakt je dopuszcza; nie ignoruj wyjątku jako sposobu naprawy.

We własnym API rzucaj ten wyjątek, gdy operacja nie jest obsługiwana zgodnie z kontraktem. Dostępne są konstruktory UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) i UnsupportedOperationException(String message, Throwable cause). W ostatnim wariancie komunikat przyczyny nie jest automatycznie dołączany do komunikatu wyjątku.

Przykłady

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);
    }
}

Wynik

UnsupportedOperationException
[Ada, Linus]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła