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.