CKTIS / Java
UnsupportedOperationException — operação não suportada
UnsupportedOperationException significa que a operação pedida não é suportada. Ocorre frequentemente quando se tenta modificar uma lista não modificável, como uma criada com List.of(...). A solução é escolher um objeto que suporte a operação necessária, em vez de simplesmente capturar a exceção.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
throw new UnsupportedOperationException("Operation not supported");UnsupportedOperationException em java.lang indica que a operação pedida não é suportada. Herda de RuntimeException: é uma exceção não verificada, pelo que o compilador não exige que seja capturada nem declarada em throws.
Um caso típico é chamar add numa lista criada com List.of(...). Essa lista não é modificável: adicionar, remover ou substituir elementos provoca esta exceção. No entanto, uma lista não modificável não implica que os seus elementos sejam, por si só, imutáveis.
Ao diagnosticar o problema, verifique o stack trace, o contrato do método e a forma como o objeto foi criado. O tipo List, por si só, não garante que as modificações sejam suportadas. Se forem necessárias alterações, escolha uma implementação cujo contrato as permita; não ignore a exceção como forma de resolver o problema.
Na sua própria API, lance esta exceção quando uma operação não for suportada pelo contrato. Os construtores disponíveis são UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) e UnsupportedOperationException(String message, Throwable cause). Nesta última forma, a mensagem da causa não é incluída automaticamente na mensagem da exceção.
Exemplos
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);
}
}Resultado
UnsupportedOperationException [Ada, Linus]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.