KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

UnsupportedOperationException — niet-ondersteunde bewerking

UnsupportedOperationException betekent dat de gevraagde bewerking niet wordt ondersteund. Dit gebeurt vaak wanneer je een niet-aanpasbare lijst probeert te wijzigen, zoals een lijst die met List.of(...) is gemaakt. Kies een object dat de benodigde bewerking ondersteunt; alleen de uitzondering afvangen is geen oplossing.

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

Syntax

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException in java.lang geeft aan dat de gevraagde bewerking niet wordt ondersteund. De klasse breidt RuntimeException uit: het is een ongecontroleerde uitzondering, dus de compiler vereist niet dat je deze opvangt of in throws declareert.

Een typisch geval is het aanroepen van add op een lijst die met List.of(...) is gemaakt. Die lijst is niet aanpasbaar: elementen toevoegen, verwijderen of vervangen veroorzaakt deze uitzondering. Dat een lijst niet aanpasbaar is, betekent echter niet dat de elementen zelf onveranderlijk zijn.

Controleer bij het opsporen van het probleem de stacktrace, het contract van de methode en hoe het object is gemaakt. Het type List garandeert op zichzelf niet dat wijzigingen worden ondersteund. Als wijzigingen nodig zijn, kies dan een implementatie waarvan het contract deze toestaat; negeer de uitzondering niet als oplossing.

Gooi deze uitzondering in je eigen API wanneer een bewerking volgens het contract niet wordt ondersteund. Beschikbare constructors zijn UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) en UnsupportedOperationException(String message, Throwable cause). Bij de laatste vorm wordt het bericht van de oorzaak niet automatisch opgenomen in het bericht van de uitzondering.

Voorbeelden

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

Resultaat

UnsupportedOperationException
[Ada, Linus]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen