WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

UnsupportedOperationException — nicht unterstützte Operation

UnsupportedOperationException bedeutet, dass die angeforderte Operation nicht unterstützt wird. Der Fehler tritt häufig auf, wenn eine nicht veränderbare Liste geändert werden soll, etwa eine mit List.of(...) erstellte Liste. Wählen Sie ein Objekt, das die benötigte Operation unterstützt, statt lediglich die Ausnahme abzufangen.

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

Syntax

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException aus java.lang signalisiert, dass die angeforderte Operation nicht unterstützt wird. Die Klasse erweitert RuntimeException: Sie ist eine ungeprüfte Ausnahme, daher verlangt der Compiler weder, dass sie abgefangen wird, noch dass sie in throws deklariert wird.

Ein typischer Fall ist der Aufruf von add auf einer mit List.of(...) erstellten Liste. Diese Liste ist nicht veränderbar: Das Hinzufügen, Entfernen und Ersetzen von Elementen löst diese Ausnahme aus. Eine nicht veränderbare Liste bedeutet jedoch nicht, dass auch ihre Elemente selbst unveränderlich sind.

Prüfen Sie bei der Diagnose den Stacktrace, den Methodenvertrag und die Art, wie das Objekt erstellt wurde. Der Typ List allein garantiert nicht, dass Änderungen unterstützt werden. Wenn Änderungen erforderlich sind, wählen Sie eine Implementierung, deren Vertrag sie zulässt; ignorieren Sie die Ausnahme nicht als vermeintliche Lösung.

Werfen Sie diese Ausnahme in Ihrer eigenen API, wenn eine Operation gemäß dem Vertrag nicht unterstützt wird. Verfügbare Konstruktoren sind UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) und UnsupportedOperationException(String message, Throwable cause). Bei der letzten Variante wird die Meldung der Ursache nicht automatisch in die Meldung der Ausnahme aufgenommen.

Beispiele

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

Ergebnis

UnsupportedOperationException
[Ada, Linus]

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen