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

CKTIS / Java

IllegalMonitorStateException — absence de possession du moniteur

IllegalMonitorStateException signale notamment un appel à wait(), notify() ou notifyAll() sans possession du moniteur de l’objet concerné. Pour corriger le problème, il faut synchroniser sur le bon objet, et pas simplement intercepter l’exception.

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

Syntaxe

public class IllegalMonitorStateException extends RuntimeException

IllegalMonitorStateException()
IllegalMonitorStateException(String s)

IllegalMonitorStateException, dans le paquet java.lang, hérite directement de RuntimeException. C’est une exception non vérifiée : aucune déclaration throws ni interception n’est requise. Le constructeur IllegalMonitorStateException() ne définit pas de message détaillé, tandis que IllegalMonitorStateException(String s) en accepte un.

Les appels à wait(), wait(long), wait(long, int), notify() et notifyAll() exigent que le thread courant possède le moniteur de l’objet sur lequel la méthode est appelée. Une solution courante consiste à utiliser synchronized (monitor). Synchroniser un autre objet ne suffit pas. Une méthode d’instance synchronisée verrouille this, tandis qu’une méthode statique verrouille l’objet Class de la classe.

L’exemple déclenche volontairement l’exception et l’intercepte, puis montre un appel valide sur le même objet à l’intérieur de synchronized. L’absence de threads en attente ne provoque pas l’exception. Dans du code réel, corrigez la possession du moniteur au lieu d’ignorer l’erreur. Avec wait(), vérifiez la condition dans une boucle while, car des réveils intempestifs sont possibles ; InterruptedException est un problème distinct qui doit être traité.

Exemples

public class Main {
    public static void main(String[] args) {
        Object monitor = new Object();

        try {
            monitor.notifyAll();
        } catch (IllegalMonitorStateException e) {
            System.out.println(e.getClass().getSimpleName());
        }

        synchronized (monitor) {
            monitor.notifyAll();
            System.out.println("Monitor owned: OK");
        }
    }
}

Résultat

IllegalMonitorStateException
Monitor owned: OK

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