CKTIS / Java
InterruptedException — tratar a interrupção de uma thread
InterruptedException é uma exceção verificada que assinala a interrupção de uma operação como Thread.sleep. Saiba em que difere a exceção da flag de interrupção e como preservar o sinal ao tratá-la.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
return;
}java.lang.InterruptedException herda de Exception e é uma exceção verificada. O código tem de a capturar ou declará-la na cláusula throws do método. Se o contrato do método o permitir, use throws InterruptedException ou declare um supertipo aplicável, por exemplo, com throws Exception. A exceção assinala uma interrupção antes ou durante uma operação, por exemplo, Thread.sleep, Object.wait ou Thread.join. Os seus construtores são InterruptedException() e InterruptedException(String s).
A interrupção é um sinal de cooperação, não a terminação forçada de uma thread. Chamar interrupt() nem sempre provoca uma exceção. Quando sleep, wait ou join lança InterruptedException, a flag de interrupção é limpa. isInterrupted() lê-a sem a alterar; Thread.interrupted() lê e limpa a flag da thread atual.
Regra geral, propague a exceção. Se o contrato do método não o permitir, restaure a flag com Thread.currentThread().interrupt() e pare a tarefa atual ou regresse ao chamador. Não ignore a exceção sem uma política deliberada para a gestão de interrupções.
O exemplo define a flag antes de Thread.sleep(1000), pelo que não depende do agendamento de várias threads. Demonstra a limpeza e o restauro da flag. A documentação tem como âmbito Java SE 21; a versão do ambiente de execução de produção não foi confirmada.
Exemplos
public class Main {
public static void main(String[] args) {
Thread current = Thread.currentThread();
current.interrupt();
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
System.out.println("caught: " + current.isInterrupted());
current.interrupt();
System.out.println("restored: " + current.isInterrupted());
}
}
}Resultado
caught: false restored: true
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.