Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

TimeUnit.MILLISECONDS — tiempos de espera en milisegundos

TimeUnit.MILLISECONDS indica que el límite de espera de las sobrecargas temporizadas de poll y offer de una cola bloqueante se expresa en milisegundos.

Versión: Java SE 21

Sintaxis

import java.util.concurrent.TimeUnit;

TimeUnit unit = TimeUnit.MILLISECONDS;

// Both timed calls can throw InterruptedException. Catch it or declare it
// in the enclosing method's throws clause.
// Given a BlockingQueue<E> named queue and a non-null E named element:
boolean inserted = queue.offer(element, 250L, TimeUnit.MILLISECONDS);
E head = queue.poll(250L, TimeUnit.MILLISECONDS);

TimeUnit.MILLISECONDS es una constante de la enumeración java.util.concurrent.TimeUnit. Representa una unidad equivalente a una milésima de segundo, no una duración concreta ni una marca temporal. Los argumentos 250L, TimeUnit.MILLISECONDS fijan un límite de espera de 250 milisegundos. La operación puede completarse con éxito antes; la unidad no garantiza el instante exacto en que retorna la llamada.

En una BlockingQueue<E>, offer(E, long, TimeUnit) espera a que haya espacio si es necesario. Devuelve true si inserta el elemento, o false si el plazo vence antes de que haya espacio. poll(long, TimeUnit) espera a que haya un elemento si es necesario. Retira y devuelve el primer elemento de la cola, o devuelve null si el plazo vence antes de que haya un elemento disponible. Una BlockingQueue no admite elementos null.

A diferencia de las sobrecargas temporizadas, offer(E) y poll() no esperan a que haya espacio ni a que haya un elemento. Ambas sobrecargas temporizadas lanzan InterruptedException si se interrumpe el hilo mientras espera. Una interrupción no equivale al vencimiento del plazo.

Si necesitas un valor numérico en milisegundos, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) devuelve 2000L. La constante sobre la que se invoca el método indica la unidad de destino. Al convertir a una unidad más gruesa se trunca hacia cero; si el resultado desbordaría el tipo long, se limita al extremo correspondiente.

Ejemplos

import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.BlockingQueue;
import java.util.concurrent.TimeUnit;

public class MillisecondTimeouts {
    public static void main(String[] args) throws InterruptedException {
        BlockingQueue<String> queue = new ArrayBlockingQueue<>(1);

        System.out.println(queue.offer("job", 10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.offer("extra", 10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
        System.out.println(queue.poll(10L, TimeUnit.MILLISECONDS));
    }
}

Resultado

true
false
job
null

Un solo hilo utiliza una cola con espacio para un elemento. La primera inserción tiene éxito, la segunda agota el plazo, la primera extracción devuelve `job` y la segunda agota el plazo y devuelve `null`. El ejemplo comprueba los resultados, no el tiempo transcurrido.

Lecciones relacionadas

  • Java · Lección 37 · Avanzado · Versión: 2

Fuentes