CKTIS / Java
Thread.sleep em Java: uma pausa, não sincronização
`Thread.sleep(long)` põe a thread atual em pausa pelo tempo pedido em milissegundos. Não espera que outra thread termine nem garante a ordem das tarefas.
Versão: Java SE 21
Sintaxe
public static void sleep(long millis) throws InterruptedException
public static void sleep(long millis, int nanos) throws InterruptedException
public static void sleep(java.time.Duration duration) throws InterruptedExceptionEm Java SE 21, Thread.sleep é um método estático de java.lang.Thread que não devolve nenhum valor. Só põe em pausa a thread que executa a chamada. Escrever worker.sleep(50L) não põe a thread worker em pausa: usa o nome da classe para deixar claro que é a thread atual que faz a pausa.
Thread.sleep(long) recebe milissegundos; um valor negativo lança IllegalArgumentException. Thread.sleep(long, int) recebe milissegundos não negativos e de 0 a 999999 nanossegundos adicionais; um argumento fora do intervalo lança a mesma exceção. Thread.sleep(Duration), disponível desde o Java 19, recebe uma java.time.Duration e não faz nada se a duração for negativa. O instante exato em que a execução é retomada depende dos temporizadores do sistema e do escalonamento; um argumento em nanossegundos não garante essa precisão.
Thread.sleep(long) pode lançar a exceção verificada InterruptedException se a thread já estiver interrompida no momento da chamada ou for interrompida durante a pausa. Ao lançar a exceção, o estado de interrupção é limpo. Propaga a exceção ou, se não o puderes fazer, em geral repõe o estado com Thread.currentThread().interrupt() e termina a operação em curso.
A pausa não liberta os monitores que a thread detém, mesmo dentro de synchronized, nem estabelece por si só uma relação happens-before entre threads. Por isso, não garante a visibilidade das escritas feitas por outra thread. Uma chamada a Thread.sleep(0) numa única iteração não demonstra um atraso mensurável nem trabalho em paralelo. Acrescentar Thread.sleep(5) a todas as tarefas não define a ordem em que terminam.
Usa sleep para atrasar deliberadamente a thread atual. Para esperar que outra thread termine, chama Thread.join() nessa thread; para obter o resultado de uma tarefa, usa Future.get(); para esperar por um ou mais sinais, usa CountDownLatch.await().
Exemplos
public class SleepDemo {
public static void main(String[] args) {
System.out.println("Before sleep");
try {
Thread.sleep(50L);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
System.out.println("Interrupted");
return;
}
System.out.println("After sleep");
}
}Resultado
Before sleep After sleep
A mesma thread escreve as duas linhas esperadas. O exemplo não mede a duração da pausa nem executa trabalho em paralelo. Se a pausa for interrompida, o programa repõe o estado de interrupção, escreve `Interrupted` em vez de `After sleep` e sai de `main`.
Lições relacionadas
- Java · Lição 26 · Avançado · Versão: 2
- Java · Lição 49 · Intermédio · Versão: 2
- Java · Lição 50 · Intermédio · Versão: 2
Fontes
- Java SE 21 API — Thread.sleep(long)
- Java SE 21 API — Thread.sleep(long, int)
- Java SE 21 API — Thread.sleep(Duration)
- Java SE 21 API — Thread.interrupt()
- Java Language Specification, Java SE 21 — §17.3 Sleep and Yield
- Java Language Specification, Java SE 21 — §17.4.5 Happens-before Order
- Java SE 21 API — Future.get()
- Java SE 21 API — CountDownLatch.await()
- JDK 21 Tool Specifications — The java Command