CKTIS / Java
TimeUnit: milisegundos, nanosegundos y tryLock con tiempo de espera
Convierte milisegundos a nanosegundos y usa la unidad que corresponde al valor del tiempo de espera de `tryLock`.
Versión: Java SE 21
Sintaxis
import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.ReentrantLock;
long timeoutNanos = TimeUnit.MILLISECONDS.toNanos(timeoutMillis);
// For either timed tryLock call, catch InterruptedException or declare it in the enclosing method's throws clause.
boolean acquired = lock.tryLock(timeoutMillis, TimeUnit.MILLISECONDS);
// Alternative to the preceding call, not a second acquisition:
// boolean acquired = lock.tryLock(timeoutNanos, TimeUnit.NANOSECONDS);TimeUnit.MILLISECONDS es una constante de la enumeración java.util.concurrent.TimeUnit. Representa una unidad (el milisegundo), no una duración concreta ni una lectura del reloj. TimeUnit.toNanos es un método de instancia: unit.toNanos(duration) recibe un long expresado en la unidad unit y devuelve un long en nanosegundos.
Un milisegundo equivale a 1 000 000 de nanosegundos, así que TimeUnit.MILLISECONDS.toNanos(250L) devuelve 250000000L. Si el resultado exacto queda fuera del rango de long, el método devuelve Long.MAX_VALUE por encima del límite superior o Long.MIN_VALUE por debajo del inferior. El desbordamiento no lanza una excepción ni hace que el resultado salte al extremo opuesto del rango.
En ReentrantLock.tryLock(long, TimeUnit), la unidad indica cómo interpretar el primer argumento. Usa directamente lock.tryLock(250L, TimeUnit.MILLISECONDS) o, tras convertir el valor, lock.tryLock(250000000L, TimeUnit.NANOSECONDS). Ambas llamadas fijan el mismo límite de espera para adquirir el bloqueo. No combines el número convertido con MILLISECONDS: usar nanosegundos como unidad no garantiza una precisión de espera de un nanosegundo.
La sobrecarga con tiempo de espera devuelve true si se adquiere el bloqueo (también si el mismo hilo lo adquiere de nuevo) y false si vence el plazo sin adquirirlo. Un plazo <= 0 significa que no espera. Esta sobrecarga respeta la configuración de equidad del bloqueo y, si el hilo está interrumpido al entrar o se interrumpe durante la adquisición, lanza InterruptedException y borra el estado de interrupción. tryLock() sin argumentos no espera, puede adelantarse a los hilos en cola y no lanza InterruptedException. Una unidad null en la versión con plazo provoca NullPointerException. Llama a unlock() en finally solo tras una adquisición exitosa.
Ejemplos
import java.util.concurrent.TimeUnit;
import java.util.concurrent.locks.ReentrantLock;
public class Main {
public static void main(String[] args) throws InterruptedException {
long timeoutMillis = 250L;
long timeoutNanos = TimeUnit.MILLISECONDS.toNanos(timeoutMillis);
System.out.println(timeoutMillis + " ms = " + timeoutNanos + " ns");
ReentrantLock lock = new ReentrantLock();
if (lock.tryLock(timeoutMillis, TimeUnit.MILLISECONDS)) {
try {
System.out.println("Lock acquired");
} finally {
lock.unlock();
}
} else {
System.out.println("Lock not acquired");
}
}
}Resultado
250 ms = 250000000 ns Lock acquired
El programa imprime la conversión, pero pasa a `tryLock` el valor original en milisegundos. El nuevo bloqueo está libre y ningún otro hilo compite por él, por lo que el ejemplo muestra una adquisición exitosa, no el vencimiento del plazo.
Lecciones relacionadas
- Java · Lección 54 · Intermedio · Versión: 2