База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

UnsupportedOperationException — неподдържана операция

UnsupportedOperationException означава, че заявената операция не се поддържа. Често се появява при опит за промяна на немодифицируем списък, например създаден с List.of(...). Решението е да изберете обект, който поддържа необходимата операция, а не просто да прихванете изключението.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException от java.lang сигнализира, че заявената операция не се поддържа. Наследява RuntimeException: това е непроверявано изключение, затова компилаторът не изисква то да бъде прихванато или декларирано в throws.

Типичен случай е извикването на add върху списък, създаден с List.of(...). Този списък не може да се променя: добавянето, премахването и замяната на елементи предизвикват това изключение. Това обаче, че списъкът не може да се променя, не означава, че самите му елементи са неизменяеми.

При диагностика проверете стека на извикванията, договора на метода и начина, по който е създаден обектът. Самият тип List не гарантира поддръжка на промени. Ако са нужни промени, изберете реализация, чийто договор ги позволява; не пренебрегвайте изключението като решение.

В собственото си API хвърляйте това изключение, когато дадена операция не се поддържа според договора. Наличните конструктори са UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) и UnsupportedOperationException(String message, Throwable cause). При последната форма съобщението на причината не се включва автоматично в съобщението на изключението.

Примери

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

Резултат

UnsupportedOperationException
[Ada, Linus]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници