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.