Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

UnsupportedOperationException — operación no compatible

UnsupportedOperationException significa que la operación solicitada no es compatible. Suele producirse al intentar modificar una lista no modificable, como una creada con List.of(...). La solución es elegir un objeto que admita la operación necesaria, no limitarse a capturar la excepción.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException de java.lang indica que la operación solicitada no es compatible. Hereda de RuntimeException: es una excepción no comprobada, por lo que el compilador no exige capturarla ni declararla en throws.

Un caso habitual es llamar a add en una lista creada con List.of(...). Esa lista no se puede modificar: añadir, eliminar o reemplazar elementos provoca esta excepción. Sin embargo, que una lista no se pueda modificar no significa que sus elementos sean inmutables.

Para diagnosticar el problema, revisa la traza de la pila, el contrato del método y cómo se creó el objeto. El tipo List por sí solo no garantiza que se admitan modificaciones. Si necesitas hacer cambios, elige una implementación cuyo contrato los permita; no ignores la excepción como solución.

En tu propia API, lanza esta excepción cuando una operación no esté admitida por el contrato. Los constructores disponibles son UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) y UnsupportedOperationException(String message, Throwable cause). En esta última forma, el mensaje de la causa no se incluye automáticamente en el mensaje de la excepción.

Ejemplos

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]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes