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

CKTIS / Java

IllegalMonitorStateException — falta de posse do monitor

IllegalMonitorStateException indica, entre outros casos, uma chamada a wait(), notify() ou notifyAll() sem posse do monitor do objeto em causa. Para resolver o problema, é necessário sincronizar no objeto correto, não apenas capturar a exceção.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public class IllegalMonitorStateException extends RuntimeException

IllegalMonitorStateException()
IllegalMonitorStateException(String s)

IllegalMonitorStateException, do pacote java.lang, herda diretamente de RuntimeException. É uma exceção não verificada: não exige uma declaração throws nem que seja capturada. O construtor IllegalMonitorStateException() não define uma mensagem detalhada, enquanto IllegalMonitorStateException(String s) aceita uma.

As chamadas a wait(), wait(long), wait(long, int), notify() e notifyAll() exigem que a thread atual possua o monitor do objeto sobre o qual o método é chamado. Uma solução habitual é synchronized (monitor). Sincronizar num objeto diferente não é suficiente. Um método de instância sincronizado bloqueia this, enquanto um método estático bloqueia o objeto Class da classe.

O exemplo provoca e captura deliberadamente a exceção e, em seguida, mostra uma chamada válida no mesmo objeto dentro de synchronized. A ausência de threads à espera não provoca a exceção. Em código real, corrige a posse do monitor em vez de ignorar o erro. Ao utilizar wait(), verifica a condição num ciclo while, porque podem ocorrer despertares espúrios; InterruptedException é um problema distinto que requer tratamento.

Exemplos

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

Resultado

IllegalMonitorStateException
Monitor owned: OK

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