Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

UnsupportedOperationException — operazione non supportata

UnsupportedOperationException indica che l’operazione richiesta non è supportata. Si verifica spesso quando si tenta di modificare una lista non modificabile, ad esempio una creata con List.of(...). La soluzione è scegliere un oggetto che supporti l’operazione necessaria, non limitarsi a intercettare l’eccezione.

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

Sintassi

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException in java.lang segnala che l’operazione richiesta non è supportata. Estende RuntimeException: è un’eccezione non controllata, quindi il compilatore non richiede né di intercettarla né di dichiararla in throws.

Un caso tipico è chiamare add su una lista creata con List.of(...). La lista non è modificabile: aggiungere, rimuovere o sostituire elementi genera questa eccezione. Tuttavia, il fatto che una lista non sia modificabile non implica che anche i suoi elementi siano immutabili.

Per diagnosticare il problema, controlla lo stack trace, il contratto del metodo e il modo in cui è stato creato l’oggetto. Il tipo List da solo non garantisce il supporto alle modifiche. Se sono necessarie modifiche, scegli un’implementazione il cui contratto le consenta; non ignorare l’eccezione come soluzione.

Nella tua API, lancia questa eccezione quando un’operazione non è supportata dal contratto. I costruttori disponibili sono UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) e UnsupportedOperationException(String message, Throwable cause). Nell’ultima forma, il messaggio della causa non viene incluso automaticamente nel messaggio dell’eccezione.

Esempi

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

Risultato

UnsupportedOperationException
[Ada, Linus]

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti