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

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.

Fontes