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