Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes