Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

UnsupportedOperationException — opération non prise en charge

UnsupportedOperationException signifie que l’opération demandée n’est pas prise en charge. Elle se produit souvent lorsqu’on tente de modifier une liste non modifiable, par exemple une liste créée avec List.of(...). La solution consiste à choisir un objet qui prend en charge l’opération nécessaire, et non à simplement intercepter l’exception.

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

Syntaxe

throw new UnsupportedOperationException("Operation not supported");

UnsupportedOperationException dans java.lang signale que l’opération demandée n’est pas prise en charge. Elle hérite de RuntimeException : c’est une exception non vérifiée, que le compilateur n’exige donc ni d’intercepter ni de déclarer dans throws.

Un cas courant est l’appel de add sur une liste créée avec List.of(...). Cette liste n’est pas modifiable : ajouter, supprimer ou remplacer des éléments déclenche cette exception. Toutefois, le fait qu’une liste ne soit pas modifiable ne signifie pas que ses éléments sont eux-mêmes immuables.

Pour diagnostiquer le problème, examinez la trace de pile, le contrat de la méthode et la façon dont l’objet a été créé. Le type List à lui seul ne garantit pas la prise en charge des modifications. Si des changements sont nécessaires, choisissez une implémentation dont le contrat les autorise ; n’ignorez pas l’exception en guise de correction.

Dans votre propre API, lancez cette exception lorsqu’une opération n’est pas prise en charge par le contrat. Les constructeurs disponibles sont UnsupportedOperationException(), UnsupportedOperationException(String message), UnsupportedOperationException(Throwable cause) et UnsupportedOperationException(String message, Throwable cause). Dans cette dernière forme, le message de la cause n’est pas automatiquement inclus dans le message de l’exception.

Exemples

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

Résultat

UnsupportedOperationException
[Ada, Linus]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources