CKTIS / Java
Thread.sleep en Java: una pausa, no una sincronización
`Thread.sleep(long)` pausa el hilo actual durante el tiempo solicitado en milisegundos. No espera a que termine otro hilo ni garantiza el orden de las tareas.
Versión: Java SE 21
Sintaxis
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 InterruptedExceptionEn Java SE 21, Thread.sleep es un método estático de java.lang.Thread que no devuelve ningún valor. Solo pausa el hilo que ejecuta la llamada. Escribir worker.sleep(50L) no pausa el hilo worker: usa el nombre de la clase para dejar claro que se pausa el hilo actual.
Thread.sleep(long) recibe milisegundos; un valor negativo lanza IllegalArgumentException. Thread.sleep(long, int) recibe milisegundos no negativos y de 0 a 999999 nanosegundos adicionales; un argumento fuera de rango lanza la misma excepción. Thread.sleep(Duration), disponible desde Java 19, recibe una java.time.Duration y no hace nada si la duración es negativa. El momento exacto de reanudación depende de los temporizadores del sistema y de la planificación de hilos; un argumento en nanosegundos no garantiza esa precisión.
Thread.sleep(long) puede lanzar la excepción comprobada InterruptedException si el hilo ya está interrumpido al hacer la llamada o si se interrumpe durante la pausa. Al lanzar la excepción se borra el estado de interrupción. Propaga la excepción o, si no puedes hacerlo, normalmente restablece el estado con Thread.currentThread().interrupt() y termina la operación en curso.
Durante la pausa, el hilo conserva los monitores que posee, incluso dentro de synchronized. La llamada no establece por sí sola una relación happens-before entre hilos. Por tanto, no garantiza la visibilidad de las escrituras de otro hilo. Una llamada a Thread.sleep(0) en una sola iteración no demuestra una demora medible ni trabajo en paralelo. Añadir Thread.sleep(5) a cada tarea no fija su orden de finalización.
Usa sleep para retrasar deliberadamente el hilo actual. Para esperar a que termine otro hilo, llama a Thread.join() sobre ese hilo; para obtener el resultado de una tarea, usa Future.get(); para esperar una o varias señales, usa CountDownLatch.await().
Ejemplos
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
El mismo hilo imprime las dos líneas esperadas. El ejemplo no mide la pausa ni ejecuta trabajo en paralelo. Si se interrumpe la pausa, el programa restablece el estado de interrupción, imprime `Interrupted` en vez de `After sleep` y sale de `main`.
Lecciones relacionadas
- Java · Lección 26 · Avanzado · Versión: 2
- Java · Lección 49 · Intermedio · Versión: 2
- Java · Lección 50 · Intermedio · Versión: 2
Fuentes
- 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