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

CKTIS / Java

TimeUnit.MILLISECONDS — limites de espera em milissegundos

TimeUnit.MILLISECONDS indica que o limite de espera das versões temporizadas de poll e offer de uma fila bloqueante é expresso em milissegundos.

Versão: Java SE 21

Sintaxe

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 é uma constante da enumeração java.util.concurrent.TimeUnit. Representa uma unidade igual a um milésimo de segundo, não uma duração específica nem uma marca temporal. Os argumentos 250L, TimeUnit.MILLISECONDS definem um limite de espera de 250 milissegundos. A operação pode ter êxito mais cedo; a unidade não garante o instante exato em que a chamada termina.

Numa BlockingQueue<E>, offer(E, long, TimeUnit) espera, se necessário, que haja espaço. Devolve true se inserir o elemento ou false se o prazo terminar antes de haver espaço. poll(long, TimeUnit) espera, se necessário, por um elemento. Remove e devolve o primeiro elemento da fila ou devolve null se o prazo terminar antes de haver um elemento disponível. Uma BlockingQueue não aceita elementos null.

Ao contrário das sobrecargas temporizadas, offer(E) e poll() não esperam por espaço livre nem por um elemento. Ambas as sobrecargas temporizadas lançam InterruptedException se a thread for interrompida durante a espera. Uma interrupção é diferente do fim do prazo.

Para obter um valor numérico em milissegundos, TimeUnit.MILLISECONDS.convert(2L, TimeUnit.SECONDS) devolve 2000L. A constante sobre a qual se invoca o método é a unidade de destino. Ao converter para uma unidade maior, o resultado é truncado em direção a zero; se ultrapassasse os limites de long, fica limitado ao extremo correspondente.

Exemplos

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

Uma única thread usa uma fila com espaço para um elemento. A primeira inserção tem êxito, a segunda esgota o prazo, a primeira remoção devolve `job` e a segunda esgota o prazo e devolve `null`. O exemplo verifica os resultados, não o tempo decorrido.

Lições relacionadas

  • Java · Lição 37 · Avançado · Versão: 2

Fontes