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.